OpenCode
OpenCode 是开源的命令行编程助手,通过 OpenAI 兼容接口可以使用 CodingRouter 的任意文本模型。
准备
- 安装 OpenCode:
npm install -g opencode-ai - 创建令牌,分组按要用的模型选择(例如 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 或 404 | baseURL 必须带 /v1 |
| 503 | 模型名写错,或令牌分组里没有这个模型 |
| 一个配置里用多个厂商的模型 | 一个令牌只属于一个分组,按厂商各配一个 provider,各用对应分组的令牌 |
