Skip to content

OpenCode ​

OpenCode 是开源的命令行编程助手,通过 OpenAI 兼容接口可以使用 CodingRouter 的任意文本模型。

准备 ​

  1. 安装 OpenCode:npm install -g opencode-ai
  2. 创建令牌,分组按要用的模型选择(例如 GPT 用 gpt,Claude 用 claude)。

配置 ​

编辑 ~/.config/opencode/opencode.json(只想在某个项目里用时,放在项目根目录的 opencode.json):

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "codingrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CodingRouter",
      "options": {
        "baseURL": "https://api.codingrouter.ai/v1",
        "apiKey": "{env:CODINGROUTER_KEY}"
      },
      "models": {
        "gpt-5.5": { "name": "GPT-5.5" },
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" }
      }
    }
  }
}

models 里列出要用的模型,名称必须与模型广场一致,并且在令牌分组里。

设置令牌并启动:

bash
export CODINGROUTER_KEY="sk-你的令牌"
opencode

启动后用 /models 选择 CodingRouter 下的模型。

验证 ​

bash
opencode run -m codingrouter/gpt-5.5 "Reply with exactly: CODINGROUTER OK"

常见问题 ​

现象处理
返回 HTML 或 404baseURL 必须带 /v1
503模型名写错,或令牌分组里没有这个模型
一个配置里用多个厂商的模型一个令牌只属于一个分组,按厂商各配一个 provider,各用对应分组的令牌