Skip to content

OpenCode 接入

OpenCode 适合通过配置文件一次性接入 Claude 和 GPT 模型。

模型族Base URL
Claude / Anthropichttps://api.codyrouter.com/v1
GPT / OpenAIhttps://api.codyrouter.com/v1

配置文件

OpenCode 常用配置路径:

  • 模型配置:~/.config/opencode/opencode.jsonc
  • 认证配置:~/.local/share/opencode/auth.json

你可以把 API Key 写在 opencode.jsoncoptions.apiKey 中,这样 auth.json 保持空对象即可。模型 ID 可以使用 provider/model-id 格式,也可以使用纯 model-id 格式。

jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.codyrouter.com/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "npm": "@ai-sdk/anthropic"
    },
    "openai": {
      "options": {
        "baseURL": "https://api.codyrouter.com/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "gpt-5.3-codex": {
          "name": "GPT-5.3 Codex",
          "limit": {
            "context": 400000,
            "output": 128000
          },
          "options": {
            "store": false
          },
          "variants": {
            "low": {},
            "medium": {},
            "high": {},
            "xhigh": {}
          }
        }
      }
    }
  }
}

如果 ~/.local/share/opencode/auth.json 已存在且不需要保存认证信息,可以保持为空对象:

json
{}

检查项

  • Claude 和 GPT 使用 /v1
  • 模型 ID 可以写成 openai/gpt-5.3-codexgpt-5.3-codex,但模型名称必须和 模型名称列表 完全一致。
  • JSON / JSONC 语法错误会导致 OpenCode 读取失败。

配置完成后,重新打开 OpenCode,确认模型列表里能看到刚刚添加的模型。选择模型发送测试消息,能正常返回即表示接入成功。

CodyRouter 集成文档。