OpenCode
在 OpenCode 中使用平台的模型：安装、opencode.json 中的服务商配置、上下文窗口与模型选择。
更新于 2026-10-24·阅读约 2 分钟
OpenCode 通过 OpenAI Chat Completions 格式（POST /v1/chat/completions）调用平台的模型。命令行与桌面客户端读取同一份配置。配置前先完成编程工具概览「准备」中的三步。
安装
#bashnpm install -g opencode-ai
opencode --version输出版本号表示安装成功。
配置
#在配置文件中添加 SciRouter 作为服务商：
| 范围 | 文件路径 |
|---|---|
| 全局（macOS / Linux） | ~/.config/opencode/opencode.json |
| 全局（Windows） | C:\Users\<用户名>\.config\opencode\opencode.json |
| 单个项目 | 项目根目录的 opencode.json，与全局配置合并，同名项以它为准 |
文件不存在时新建。写入以下内容，将 YOUR_MODEL_ID 换成平台的模型 id，limit 按该模型的上下文窗口与输出上限填写（见模型中心的详情页）：
json{
"provider": {
"scirouter": {
"npm": "@ai-sdk/openai-compatible",
"name": "SciRouter",
"options": {
"baseURL": "https://api.scirouter.cn/v1",
"apiKey": "{env:SCIROUTER_API_KEY}"
},
"models": {
"YOUR_MODEL_ID": {
"name": "YOUR_MODEL_ID",
"limit": { "context": 128000, "output": 16384 }
}
}
}
}
}limit 中的数值为示例。
| 字段 | 取值 | 说明 |
|---|---|---|
provider 下的键 | scirouter | 服务商 id，可自定义；/models 中按它分组 |
npm | @ai-sdk/openai-compatible | 使用 Chat Completions 格式 |
name | SciRouter | 界面上显示的服务商名称 |
options.baseURL | https://api.scirouter.cn/v1 | 带 /v1 |
options.apiKey | {env:SCIROUTER_API_KEY} | 从环境变量读取 Key。直接写 Key 时，配置文件随项目提交会泄露 Key |
models 下的键 | 平台的模型 id | 每个要用的模型一项，可写多项 |
models.*.name | 任意 | 模型列表中显示的名称 |
models.*.limit.context / limit.output | 整数 | 上下文窗口与输出上限。OpenCode 据此判断剩余上下文；不写时 OpenCode 不知道模型的窗口 |
使用
#bashcd my-project
opencode输入 /models，在 SciRouter 分组下选择模型，发送一条消息，收到回答即接入成功。修改配置文件后重新启动 OpenCode。
桌面客户端使用同一份全局配置，在模型列表中选择 SciRouter 下的模型即可。