让 OpenCode 跑在 OAIRoute 上

OpenCode 从 opencode.json 读提供方。把 OAIRoute 注册成 OpenAI 兼容提供方,它列出的每个模型都会出现在模型切换器里。

Terminal agent

配置

~/.config/opencode/opencode.json
{
  "provider": {
    "oairoute": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.oairoute.com/v1",
        "apiKey": "YOUR_OAIROUTE_KEY"
      },
      "models": {
        "claude-opus-5": { "name": "Claude Opus 5" },
        "gpt-5.6": { "name": "GPT-5.6" }
      }
    }
  }
}
Run opencode and pick the provider with the model switcher.

完整分步指南

为什么要走 OAIRoute

终端原生,不用维护界面

整套配置就是一个 JSON block。复制、换 Key,之后一键切模型。

同一个切换器里选所有厂商

Claude、GPT、Gemini 和 DeepSeek 之间,只差一个模型名。

基于 AI SDK 提供方

底层用的是 @ai-sdk/openai-compatible,流式输出和工具调用都按预期工作。

接入步骤

  1. 1

    创建 Key

    在 api.oairoute.com 注册,到令牌页创建一个 Key。

  2. 2

    写配置

    把下面的 JSON 存到 ~/.config/opencode/opencode.json。

  3. 3

    验证

    运行 `opencode`,用模型切换器选这个 provider。

值得用的模型

模型 ID名称适合美元 / 百万 token(输入 / 输出)
claude-opus-5-5Claude Opus 5.5终端里处理难任务的默认选择。$0.20 / $1.00
gpt-6.1-solGPT-6.1 Sol通用性很好的低成本默认值。$0.10 / $0.50
kimi-k3Kimi K3中文任务表现突出。$0.90 / $4.50

价格按模型目录公布的口径,单位为每百万 token 的输入 / 输出。

常见问题

OpenCode 从哪读配置?

macOS 和 Linux 是 ~/.config/opencode/opencode.json。Windows 下跟随你的 XDG 配置目录。

需要把所有模型都列出来吗?

不用。列你打算用的即可,其他模型 ID 也会照常透传。

流式或工具调用不正常?

确认 npm 包是 @ai-sdk/openai-compatible,且 baseURL 以 /v1 结尾。

其他工具