9router 接入 QCode
把 QCode.cc 作为自定义 provider 接入 9router 本地多供应商路由，做多供应商兜底与统一管理
需要 API Key？ 前往注册 →端点与 Base URL →
本页目录
9router 是一个本地多供应商 AI 路由代理：它在你本机起一个 OpenAI 兼容服务（默认 http://localhost:20128/v1），把 Claude Code、Cursor、Cline、Codex 等工具的请求统一接管，再按你配置的规则转发到多个模型供应商（含自动兜底 / 配额耗尽切换 / 输出压缩省 token 等）。概念上类似 QCode 自家的 CCR——区别是 9router 跑在你自己的机器上、由你管理。
具体功能、端口与界面以 9router 官方仓库 为准；本文只讲「如何把 QCode 加进去」。
何时需要它¶
- 只用 QCode 时直连更简单：如果你只用 QCode，直接把工具的 BASE_URL 指向
api.qcode.cc即可，不需要 9router。 - 适合用 9router 的场景：你想把 QCode 和其它供应商（订阅版、赠送额度、自建等）混用，需要统一入口、自动兜底、跨供应商切换或 token 压缩时，可以把 QCode 注册成 9router 的一个 provider（作为主力或兜底层）。
把 QCode 加为 provider¶
- 按 9router 文档启动它，打开本地控制台（默认
http://localhost:20128）。 -
在 Providers（供应商） 里新增一个自定义 / OpenAI 兼容（Compatible Node） 供应商：
-
Endpoint / Base URL：
- 对话（GPT 系）：
https://api.qcode.cc/openai/v1 - 对话（Claude 系，若 9router 支持 Anthropic 协议节点）：
https://api.qcode.cc/api - 图像（可选）：
https://api.qcode.cc/qcode-img/v1（见下方注意） - 中国大陆把域名换成
asia.qcode.cc（亚洲接入点，地理就近）。
- 对话（GPT 系）：
- API Key：你的 QCode API Key（
cr_开头）。 - 模型 / 别名：按需登记
claude-opus-5、claude-sonnet-5、gpt-6-sol、gpt-5.6-terra等（4.x 如claude-sonnet-4-6仍在售）。 - 把 QCode 这个 provider 放进你的 tier / fallback 链（例如作为主力，或作为其它供应商额度耗尽后的兜底层）。
- 让你的工具（Claude Code / Cursor / Cline 等）连接 9router 的本地入口
http://localhost:20128/v1即可——之后由 9router 决定何时路由到 QCode。
直连 QCode vs 经 9router¶
| 直连 QCode | 经 9router | |
|---|---|---|
| 配置复杂度 | 低（填一个 BASE_URL） | 中（需配 provider / tier / 别名） |
| 多供应商兜底 | 无 | 有（QCode 可作主力或兜底） |
| 团队共享 | 是（云端服务） | 否（9router 仅本机，配置不跨成员） |
| 用量统计 | QCode 后台 probe.qcode.cc 精确 | 9router 只反映它自己的路由选择，配额仍以 QCode 后台为准 |
| 链路 | 直连 | 多一层本地代理 |
注意事项¶
- 仅本机：9router 跑在本地，配置不会在团队成员之间共享。
- 图像路由需自测：9router 暴露了
/v1/images/generations，但「经 9router 调 QCodegpt-image-2」未经实测，可能需要额外配置；要稳的话建议图像走直连 image-2。 - 配额以 QCode 后台为准：9router 的统计不等于 QCode 实际账户额度（每 Key 每日上限等以 QCode 后台 / probe.qcode.cc 为准）。
- 协议对应路径：
/openai/v1走 OpenAI 协议、/api走 Anthropic 协议、/qcode-img/v1走图像，详见 接入点与 API 格式。
安装与本地入口（9router 官方 README）¶
截至 2026-10-15，9router 官方 README 的快速开始是：npm install -g 9router 安装，运行 9router 启动，控制台默认在 http://localhost:20128 打开；要接入的工具把 Endpoint 填成 http://localhost:20128/v1，API Key 从 9router 控制台复制。README 同时写明它支持自定义的 OpenAI / Anthropic 兼容端点——QCode 就是按这种方式加进去的。
关键配置项说明¶
| 9router 里的项 | 在 QCode 场景下填什么 | 说明 |
|---|---|---|
| 类型 | 自定义 / OpenAI 兼容（Compatible Node） | Claude 系要走 Anthropic 协议节点，界面里是否提供以 9router 为准 |
| Base URL | https://api.qcode.cc/openai/v1（GPT、国产）或 https://api.qcode.cc/api（Claude） |
末尾不带斜杠；大陆可换 asia.qcode.cc |
| API Key | cr_ 开头的 QCode 密钥 |
与直连时是同一把 |
| 模型 / 别名 | 如 claude-sonnet-5、gpt-6-sol |
别名只是 9router 内部的叫法，发给 QCode 的必须是真实模型 ID |
| tier / fallback 链 | 把 QCode 放在主力或兜底位置 | 顺序由 9router 决定，QCode 只看到最终到达的请求 |
常见报错与排查¶
| 现象 | 常见原因 | 处理 |
|---|---|---|
工具连不上 localhost:20128 |
9router 没在运行，或端口被占 | 先确认控制台能在浏览器打开，再回到工具里测 |
Invalid API key |
QCode 密钥填错、带了空格，或把 9router 自己的 Key 填进了 QCode 的 provider | 两处 Key 不是同一把：工具里填 9router 控制台的 Key，QCode provider 里填 cr_ 密钥 |
model_not_available_on_endpoint |
Claude 模型被路由到了 OpenAI 端点 | 给 Claude 单独建 Anthropic 协议的节点（/api），见 接入点与 API 格式 |
| 404 | Base URL 多写或少写了 /v1，或末尾带了斜杠 |
对照上面的配置表 |
| 用量与 QCode 后台对不上 | 9router 的统计只反映它自己的路由 | 以 QCode 后台和 probe.qcode.cc 为准 |
先用 curl 直接打 QCode（见 接入点与 API 格式 第 5 节）确认密钥和路径没问题，再排查 9router 这一层，能省掉一半的来回。
常见问题¶
只用 QCode 的话，需要 9router 吗？¶
不需要。只用 QCode 时，直接把工具的 BASE_URL 指向 api.qcode.cc（大陆用 asia.qcode.cc）更简单，少一层本地代理，也少一处可能出错的地方。
9router 里显示的费用和 QCode 的账单为什么不一样？¶
9router 的数字是它自己按路由选择估算的，QCode 按 token 计费，各模型单价见 qcode.cc/models，实际扣费以 QCode 后台为准。
Claude Code 能经 9router 用 Claude 模型吗？¶
前提是 9router 支持 Anthropic 协议的节点，并且你把 QCode 的 /api 地址配成了这种节点；只配了 OpenAI 兼容节点时，Claude 模型会被拒绝。具体界面以 9router 官方仓库为准。
怎么确认经过 9router 的请求真的到了 QCode？¶
在 probe.qcode.cc 输入你的 cr_ 密钥，能看到请求的模型和 token 就说明到了；看不到，先检查 9router 里 QCode 那个 provider 是否在 tier / fallback 链里、顺序是否靠前。
一个 API Key、两种协议（Anthropic / OpenAI）通用，既可直连也可接入 9router 这类路由。了解 QCode.cc 定价。
开始使用 QCode
一把 API Key 同时用于 Claude Code、Codex 等工具；按 token 计费，各模型单价见 qcode.cc/models