opencode接入

以下是 OpenCode 配置第三方供应商模型的跨平台操作方案，适用于 Windows、macOS 和 Linux：

一、配置文件路径

平台	全局配置文件路径	项目级配置文件路径
Windows	`%USERPROFILE%\.config\opencode\opencode.json` 或 `C:\Users\你的用户名\.config\opencode\opencode.json`	项目根目录下的 `opencode.json`
macOS	`~/.config/opencode/opencode.json`	项目根目录下的 `opencode.json`
Linux	`~/.config/opencode/opencode.json`	项目根目录下的 `opencode.json`

注意：OpenCode 支持 JSON 和 JSONC（带注释的 JSON）格式。

二、操作步骤

1. 创建配置目录

如果目录不存在，请手动创建：

2. 创建/编辑配置文件

使用文本编辑器创建 opencode.json 文件：

3. 写入配置模板

以下是一个 通用配置模板，适用于大多数 OpenAI 兼容的 API：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "你的供应商ID": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "供应商显示名称",
      "options": {
        "baseURL": "https://api.your-provider.com/v1",
        "apiKey": "{env:YOUR_API_KEY_ENV}"
      },
      "models": {
        "模型ID": {
          "name": "模型显示名称",
          "limit": {
            "context": 128000,
            "output": 4096
          },
          "modalities": {
            "input": ["text"],
            "output": ["text"]
          }
        }
      }
    }
  },
  "model": "你的供应商ID/模型ID"
}

关键字段说明：

$schema：配置校验 Schema（建议保留以获得 IDE 自动补全）

npm：AI SDK 适配包，大多数兼容 OpenAI API 的供应商使用 @ai-sdk/openai-compatible

baseURL：API 端点地址（必须以 /v1 结尾）

apiKey：可使用 {env:变量名} 格式引用环境变量，或硬编码（不推荐）

三、常见供应商配置示例

示例 1：Code0

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "deepseek": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Code0-Claude",
      "options": {
        "baseURL": "https://hk.code0.ai/v1",
        "apiKey": "{env:CODE0_CLAUDE_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "claude-sonnet-4-6",
          "limit": {
            "context": 64000,
            "output": 8000
          }
        },
        "claude-opus-4-6": {
          "name": "claude-opus-4-6",
          "limit": {
            "context": 64000,
            "output": 8000
          }
        }
      }
    }
  },
  "model": "deepseek/deepseek-chat"
}

示例 2：OpenRouter（聚合 API）

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenRouter",
      "options": {
        "baseURL": "https://openrouter.ai/api/v1",
        "apiKey": "{env:OPENROUTER_API_KEY}"
      },
      "models": {
        "moonshotai/kimi-k2": {
          "name": "Kimi K2",
          "limit": {
            "context": 128000,
            "output": 32000
          }
        },
        "anthropic/claude-3.5-sonnet": {
          "name": "Claude 3.5 Sonnet",
          "limit": {
            "context": 200000,
            "output": 4096
          }
        }
      }
    }
  },
  "model": "openrouter/moonshotai/kimi-k2"
}

示例 3：Ollama（本地模型）

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (本地)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3-coder": {
          "name": "Qwen3 Coder",
          "limit": {
            "context": 128000,
            "output": 65536
          }
        },
        "llama3.1": {
          "name": "Llama 3.1",
          "limit": {
            "context": 128000,
            "output": 4096
          }
        }
      }
    }
  },
  "model": "ollama/qwen3-coder"
}

示例 4：百度千帆（兼容 OpenAI 格式）

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "qianfan": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "百度千帆",
      "options": {
        "baseURL": "https://qianfan.baidubce.com/v2/coding",
        "apiKey": "{env:QIANFAN_API_KEY}"
      },
      "models": {
        "glm-5": {
          "name": "GLM-5",
          "limit": {
            "context": 200000,
            "output": 128000
          }
        }
      }
    }
  },
  "model": "qianfan/glm-5"
}

示例 5：阿里百炼（Model Studio）

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "bailian": {
      "npm": "@ai-sdk/anthropic",
      "name": "阿里百炼",
      "options": {
        "baseURL": "https://coding.dashscope.aliyuncs.com/apps/anthropic/v1",
        "apiKey": "{env:DASHSCOPE_API_KEY}"
      },
      "models": {
        "qwen3.5-plus": {
          "name": "Qwen3.5 Plus",
          "limit": {
            "context": 1000000,
            "output": 65536
          }
        }
      }
    }
  },
  "model": "bailian/qwen3.5-plus"
}

四、环境变量配置（推荐）

为了安全起见，建议将 API Key 存储在环境变量中，而非直接写入配置文件：

Windows (PowerShell)

# 临时设置（当前会话）
$env:DEEPSEEK_API_KEY="sk-xxx"

# 永久设置（用户级）
[Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY", "sk-xxx", "User")

macOS / Linux (Bash/Zsh)

五、验证配置

保存配置文件后，运行以下命令验证：

启动后，在 TUI 中执行 /models 查看是否成功加载了自定义模型。

六、常见问题排查

问题	解决方案
提示 "找不到配置文件"	检查路径拼写，Windows 用户需确保路径为 `%USERPROFILE%\.config\opencode\opencode.json`
API 认证失败	检查 `apiKey` 是否正确，或尝试硬编码测试（确认后再改用环境变量）
模型返回乱码或空内容	确认 `baseURL` 以 `/v1` 结尾，且供应商支持 OpenAI 兼容格式
长响应被截断	在 `options` 中增加 `"timeout": 600000`（单位：毫秒）

如需更多高级配置（如 MCP 服务器、自定义代理、快捷键等），请参考官方文档的配置 Schema。

一、配置文件路径#

二、操作步骤#

1. 创建配置目录#

2. 创建/编辑配置文件#

3. 写入配置模板#

三、常见供应商配置示例#

示例 1：Code0#

示例 2：OpenRouter（聚合 API）#

示例 3：Ollama（本地模型）#

示例 4：百度千帆（兼容 OpenAI 格式）#

示例 5：阿里百炼（Model Studio）#

四、环境变量配置（推荐）#

Windows (PowerShell)#

macOS / Linux (Bash/Zsh)#

五、验证配置#

六、常见问题排查#