# 9router 接入 QCode

[9router](https://github.com/decolua/9router) 是一个**本地多供应商 AI 路由代理**：它在你本机起一个 OpenAI 兼容服务（默认 `http://localhost:20128/v1`），把 Claude Code、Cursor、Cline、Codex 等工具的请求统一接管，再按你配置的规则转发到多个上游供应商（含自动兜底 / 配额耗尽切换 / 输出压缩省 token 等）。概念上类似 QCode 自家的 CCR——区别是 9router 跑在**你自己的机器**上、由你管理。

> 具体功能、端口与界面以 [9router 官方仓库](https://github.com/decolua/9router) 为准；本文只讲「如何把 QCode 加进去」。

## 何时需要它

- **直连 QCode 更简单稳定**：如果你只用 QCode，直接把工具的 BASE_URL 指向 `api.qcode.cc` 即可，不需要 9router。
- **适合用 9router 的场景**：你想把 QCode 和其它供应商（订阅版、免费额度、自建等）**混用**，需要统一入口、自动兜底、跨供应商切换或 token 压缩时，可以把 QCode 注册成 9router 的一个 provider（作为主力或兜底层）。

## 把 QCode 加为 provider

1. 按 9router 文档启动它，打开本地控制台（默认 `http://localhost:20128`）。
2. 在 **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` 延迟更低。
   - **API Key**：你的 QCode API Key（`cr_` 开头）。
   - **模型 / 别名**：按需登记 `claude-opus-5`、`claude-sonnet-5`、`gpt-5.5`、`gpt-5.4`、`gpt-5.6-terra` 等（4.x 如 `claude-sonnet-4-6` 仍在售）。
3. 把 QCode 这个 provider 放进你的 **tier / fallback 链**（例如作为主力，或作为其它供应商额度耗尽后的兜底层）。
4. 让你的工具（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](https://probe.qcode.cc) 精确 | 9router 只反映它自己的路由选择，配额仍以 QCode 后台为准 |
| 稳定性 | 直连最稳 | 多一层本地代理 |

## 注意事项

- **仅本机**：9router 跑在本地，配置不会在团队成员之间共享。
- **图像路由需自测**：9router 暴露了 `/v1/images/generations`，但「经 9router 调 QCode `gpt-image-2`」**未经实测**，可能需要额外配置；要稳的话建议图像走[直连 image-2](/docs/usage/image-2)。
- **配额以 QCode 后台为准**：9router 的统计不等于 QCode 实际账户额度（每 Key 每日上限等以 QCode 后台 / [probe.qcode.cc](https://probe.qcode.cc) 为准）。
- **协议对应路径**：`/openai/v1` 走 OpenAI 协议、`/api` 走 Anthropic 协议、`/qcode-img/v1` 走图像，详见 [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths)。

---

> 一个 API Key、三种协议（Anthropic / OpenAI / Gemini）通用，既可直连也可接入 9router 这类路由。了解 [QCode.cc 定价](https://qcode.cc/pricing)。