接入 OpenCode

将 OpenCode 连接到 TokenCode，在终端里使用 Anthropic 兼容协议进行代码任务。

安装 OpenCode

先安装 Node.js 18 或更高版本，然后执行：

bash
npm install -g opencode-ai
opencode -v

推荐方式：使用 TokenCode CLI 配置

安装 OpenCode 后，推荐先运行 TokenCode CLI 的交互式菜单向导：

bash
npm install -g @tokencode/tokencode
tokencode

在菜单中选择 OpenCode，按提示输入 TokenCode API Key 和默认模型即可。CLI 会自动写入 ~/.config/opencode/opencode.json。

如果你已经熟悉参数，也可以一键写入：

bash
npx @tokencode/tokencode od -k sk-your-api-key -m claude-sonnet-4-6

CLI 会合并写入 provider.tokencode，并在提供 API Key 后尝试拉取可用模型列表。

手动配置

如果你不想使用 TokenCode CLI，也可以手动编辑配置文件。

打开 OpenCode 配置文件：

  • macOS / Linux：~/.config/opencode/opencode.json
  • Windows：C:\Users\<用户名>\.config\opencode\opencode.json

写入或合并以下 provider 配置：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokencode": {
      "npm": "@ai-sdk/anthropic",
      "name": "TokenCode",
      "options": {
        "baseURL": "https://tokencode.dev/v1",
        "apiKey": "sk-your-api-key"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6"
        },
        "gpt-5.5": {
          "name": "GPT-4o"
        },
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro"
        },
        "deepseek-chat": {
          "name": "DeepSeek Chat"
        }
      }
    }
  }
}

如需添加更多模型，在 models 中追加模型 ID 即可。

验证配置

保存配置后重启 OpenCode，输入：

text
/models

在模型列表中选择 TokenCode 下的模型，然后开始对话。

常见问题

OpenCode 找不到 TokenCode provider

请检查 JSON 是否有效，尤其是已有配置中合并 provider 对象时不要覆盖其他字段。保存后重启 OpenCode。

401 或认证失败

确认 apiKey 是 TokenCode API Key，并且没有多余空格。

404 或请求路径错误

OpenCode 这类基于 Anthropic SDK 的配置应使用 https://tokencode.dev/v1。如果你改成了不带 /v1 的地址，可能会请求到错误路径。