编程工具概览
编程工具接入平台的通用步骤：各工具的接口格式与地址写法、模型 id、上下文窗口、计费与常见错误。
更新于 2026-10-24·阅读约 3 分钟
编程工具通过 SciRouter 的接口调用平台上的模型。在工具中填写三项：平台的地址、SciRouter 的 API Key、平台的模型 id。各工具使用的接口格式不同，地址的写法随之不同。
准备
#- 在控制台 API Keys 页面创建 Key（以
sk-sr-开头）。为编程工具单独创建一个 Key，按需设置模型白名单与月度上限，见认证与 API Key。 - 在模型中心选择模型，复制模型 id（格式为
厂商/模型名）。该 Key 可调用的模型以GET /models的返回为准。 - 将 Key 存入环境变量
SCIROUTER_API_KEY，各工具页的配置从这里读取：
bashecho 'export SCIROUTER_API_KEY="YOUR_API_KEY"' >> ~/.zshrc # bash 写入 ~/.bashrc
source ~/.zshrcWindows 在 PowerShell 中执行 setx SCIROUTER_API_KEY "YOUR_API_KEY"，重新打开终端后生效。
接口格式与地址
#| 工具 | 接口格式 | 地址 | 接入说明 |
|---|---|---|---|
| Claude Code | Anthropic Messages | https://api.scirouter.cn | Claude Code |
| Codex | OpenAI Responses | https://api.scirouter.cn/v1 | Codex |
| OpenCode | OpenAI Chat Completions | https://api.scirouter.cn/v1 | OpenCode |
| Kilo CLI | OpenAI Chat Completions | https://api.scirouter.cn/v1 | Kilo CLI |
| Kilo Code | OpenAI Chat Completions | https://api.scirouter.cn/v1 | Kilo Code |
| Cursor | OpenAI Chat Completions | https://api.scirouter.cn/v1 | Cursor |
| CC Switch | 随所配置的工具 | 随所配置的工具 | CC Switch |
| Cline、Continue 等 | OpenAI Chat Completions | https://api.scirouter.cn/v1 | SDK 与框架「图形客户端与 IDE 插件」 |
Anthropic 格式的工具在地址后自行拼接 /v1/messages，地址不带 /v1；其余工具的地址带 /v1。多写或少写 /v1 时返回 404。
三种格式都能调用平台上的全部对话模型。模型的线路不支持工具所用的格式时，平台转换请求，见 Messages（Anthropic 格式）「请求的转发方式」与 Responses（OpenAI Responses 格式）「请求的转发方式」。
模型 id
#- 填写平台的模型 id（
厂商/模型名，含/），区分大小写。 - 工具内置的模型名（如 Claude Code 的
sonnet、opus）不会自动对应到平台的模型，按各工具页的写法映射到平台的模型 id。 - 同一个工具可配置多个模型 id，在工具内切换。
上下文窗口与输出上限
#工具不识别平台的模型 id 时，按自身的默认值估算上下文窗口与输出上限，与模型的实际值可能不同。在工具中写明所选模型的上下文窗口与输出上限（见模型中心的详情页），工具才能在窗口用满前压缩对话。各工具的写法见各页。
输入超出窗口时，平台在发出前返回 400 context_window_exceeded（error.code 为 context_length_exceeded）。Claude Code 与 Codex 据此压缩对话后重发，见各自的页面。
计费与用量
#编程工具的调用与直接调用接口相同，按所用模型的价格与实际 token 计费。工具执行一个任务会连续发出多次请求，每次都带上完整的对话历史，输入 token 随对话变长而增加；上游提示词缓存命中的部分按命中价计，见缓存与幂等。
用量在控制台用量页面查看。单次请求在调用日志中按 request_id 查询，可按调用格式（OpenAI / Anthropic）筛选。
常见错误
#| 现象 | 原因 | 处理方式 |
|---|---|---|
| 返回 404，模型 id 无误 | 地址多写或少写 /v1 | 按接口格式与地址改正 |
401 unauthenticated | 工具读到的不是 SciRouter 的 Key：填入了厂商的 Key，或环境变量没有生效 | 检查工具读取的变量，值应以 sk-sr- 开头；修改环境变量后重新打开终端 |
404 model_not_found | 模型 id 写错，或填了工具内置的模型名 | 以模型中心或 GET /models 返回的 id 为准 |
403 model_not_allowed | 模型不在 Key、项目或套餐的白名单中 | 修改白名单，或更换模型 |
402 insufficient_quota | 余额不足以预扣 | 充值，见认证与 API Key |
400 context_window_exceeded | 对话超出模型的上下文窗口 | 在工具中写明窗口大小，或压缩对话、换用窗口更大的模型 |
其余错误见错误码。报障时提供响应头 X-Request-Id 的值。