9router 接入 QCode
把 QCode.cc 作为自定义 provider 接入 9router 本地多供应商路由，做多供应商兜底与统一管理
9router 接入 QCode¶
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-4-8、claude-sonnet-4-6、gpt-5.5、gpt-5.4、gpt-5.3-codex等。 - 把 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 格式。
一个 API Key、三种协议（Anthropic / OpenAI / Gemini）通用，既可直连也可接入 9router 这类路由。了解 QCode.cc 定价。