9Router 智能路由实战指南：三级自动回退、配额追踪与低成本 AI 编码方案-港品优选

9Router 智能路由实战指南：三级自动回退、配额追踪与低成本 AI 编码方案

【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40+ providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router

9Router 是一个位于编码工具（Cursor、Cline、Claude Desktop、Codex 等）与 AI 提供商之间的智能模型路由代理：它在不改变你日常开发流程的前提下，按「订阅 → 低价 → 免费」三级策略自动分配请求，实时追踪各家配额并在耗尽时无缝切换。读完本文，你将掌握 9Router 的安装启动、提供商连接、Combo 回退链配置与配额监控方法，能把每月数百美元的大模型 API 开销压缩到几美元甚至零成本。

一、9Router 是什么：夹在编码工具与 AI 提供商之间的智能代理

按官方文档（gitbook/content/es/index.md）的定义，9Router 是一个智能代理（proxy），部署在两类对象之间：

一侧是编码工具：Cursor、Cline、Claude Desktop、Codex、RooCode、Continue，以及任何支持自定义 OpenAI 端点的工具；
另一侧是 AI 提供商：Claude Code、Codex、Gemini CLI 等订阅制服务，GLM、MiniMax、Kimi 等低价 API，以及 iFlow、Qwen、Kiro 等免费入口。

它根据配额、成本与可用性三个维度，自动把每条请求路由到当时最合适的模型上。核心承诺是「最大化你已有订阅的价值，最小化额外开销，且永不因限流中断编码」。

在仓库中，这套能力由多个模块协同实现：模型路由与回退逻辑、配额/用量追踪（src/lib/usageDb.js、src/lib/requestDetailsDb.js、src/services/usage/）、40+ 提供商的执行器与注册表（open-sse/executors/、open-sse/providers/registry/），以及向外提供 OpenAI 兼容 API 的服务入口。

二、痛点与解法：为什么需要模型路由

文档开篇用一组对照阐述了目标用户的核心痛点：

正在浪费的钱（原文列出的问题）：

❌ 每月订阅配额未用完就过期作废；
❌ 限流（rate limit）在编码进行到一半时突然中断；
❌ 每家提供商单独购买 API 昂贵（约 $20–50/月/家）；
❌ 需要手工在多个提供商之间切换。

9Router 给出的解法：

✅最大化订阅价值：追踪并耗尽 Claude Code、Codex、Gemini 的每一分配额；
✅免费可用：通过 CLI 接入 iFlow、Qwen、Kiro 等免费模型；
✅超低价后备：GLM（$0.6/1M）、MiniMax M2.1（$0.20/1M）级别的备份通道；
✅智能回退：订阅 → 低价 → 免费，自动切换、零停机。

三、核心特性拆解

3.1 三级智能回退（Subscription → Cheap → Free）

这是 9Router 最核心的能力。配置一次，之后全程自动，无需人工干预。文档给出的完整回退拓扑如下：

Configura una vez, nunca dejes de codificar: Nivel 1 (SUSCRIPCIÓN): Claude Code → Codex → Gemini ↓ cuota agotada（配额耗尽） Nivel 2 (BARATO): GLM-4.7 → MiniMax M2.1 → Kimi ↓ límite de presupuesto（预算上限） Nivel 3 (GRATIS): iFlow → Qwen → Kiro → 自动切换，零停机！

触发降级的条件有两个：订阅配额耗尽（如 Claude Code 5 小时滚动窗口用满）与预算上限到达（如设置了每日/每月支出上限）。更细的机制说明见 gitbook/content/es/features/smart-routing.md：实际选择模型时会综合判断配额剩余、成本层级、配额重置时间与提供商健康状态，并自动跳过报错的提供商。

3.2 配额追踪

为了支撑上面的自动切换，9Router 对每个提供商做实时用量追踪：

按提供商/模型的实时 token 消耗；
重置倒计时（5 小时滚动、每日、每周、每月）；
付费层级成本估算；
月度支出报告。

以订阅制为例：Claude Code 是 5 小时滚动时间窗口 + 每周刷新；Gemini CLI 每日 1,000 次请求、每月 180K 完成量；GLM-4.7 每日 10:00 AM（北京时间）重置；MiniMax 是 5 小时滚动窗口。完整的追踪面板、API 查询接口（如GET /api/quota、GET /api/usage）见 gitbook/content/es/features/quota-tracking.md。

3.3 通用 CLI 支持（OpenAI 兼容端点）

9Router 对外暴露标准 OpenAI 兼容 API，因此几乎任何工具都能接入。文档列出的兼容清单包括：Cursor、Cline、Claude Desktop、Codex、RooCode、Continue，以及任意 OpenAI 兼容工具。统一接入参数为：

Endpoint: http://localhost:20128/v1 API Key: [从 dashboard 获取] Model: cc/claude-opus-4-5-20251101

默认端口20128在仓库多处得到印证：README 的快速开始、安装文档（gitbook/content/es/getting-started/installation.md）以及 cli/cli.js 的 CLI 启动入口均以此为准。

3.4 成本优化示例（100M tokens/月）

文档给出的「真实示例」直观展示了成本结构——把流量分配到已有订阅与低价通道，而不是全走昂贵 API：

60M via Gemini CLI: $0（免费层级） 30M via Claude Code: $0（已有订阅） 8M via GLM: $4.80 2M via MiniMax: $0.40 合计：$5.20/月，而 ChatGPT API 直连约 $2000

注意：上述对比数字来自官方文档的示意性测算，实际支出取决于你的订阅档位与用量分布，但「订阅 + 低价 + 免费」的组合策略本身是 9Router 设计的核心用法。

四、为什么选择 9Router：三张王牌

4.1 最大化已有订阅

如果你已经在为 Claude Code（约 $20–100/月）或 Codex（约 $20–200/月）付费，9Router 帮助你把这些固定成本彻底用满：

实时追踪配额使用；
配额重置（5 小时/每周）后自动切回订阅模型；
在配额过期前耗尽每一个 token；
Gemini CLI 每月 180K 完成量完全免费。

4.2 超低价后备：1M tokens 低至 $0.20

当订阅配额耗尽，自动落到按量付费的低价通道。文档给出的价格表（USD）：

提供商	每 1M tokens 价格	重置周期
GLM-4.7	输入 $0.60 / 输出 $2.20	每日 10:00 AM
MiniMax M2.1	输入 $0.20 / 输出 $1.00	5 小时滚动
Kimi K2	$9/月（含 10M tokens）	每月

文档称这一档相比 ChatGPT API（$20/1M）便宜约 90%。各提供商的注册、获取 API Key、在 Dashboard 中「Providers → Add API Key」的完整步骤见 gitbook/content/es/providers/cheap.md。

4.3 永久免费回退：iFlow / Qwen / Kiro

当所有付费通道都触顶时，第三级免费通道兜底，保证「永远不断码」：

iFlow：8 个模型，含 Kimi K2、Qwen3 Coder Plus、GLM 4.7、MiniMax M2 等，OAuth 登录后无限使用；
Qwen：3 个模型（Qwen3 Coder Plus / Flash、Vision），Device Code 授权；
Kiro：Claude Sonnet 4.5 与 Haiku 4.5（AWS Builder ID 登录），等于免费使用 Claude 模型。

每个免费提供商的连接方式、可用模型 ID（如if/kimi-k2-thinking、qw/qwen3-coder-plus、kr/claude-sonnet-4.5）详见 gitbook/content/es/providers/free.md。从源码看，仓库为这些免费入口都实现了独立执行器与注册项，例如 open-sse/executors/iflow.js、open-sse/executors/qwen.js，以及注册表 open-sse/providers/registry/iflow.js 等。

五、两分钟快速开始

5.1 安装与启动

前置要求：Node.js 20+、npm 10+。全局安装并启动：

# 全局安装 npm install -g 9router # 启动（dashboard 会自动打开） 9router

启动后发生的事件序列（见 gitbook/content/es/getting-started/installation.md）：

服务在http://localhost:20128启动；
浏览器自动打开 dashboard；
在~/.9router创建数据目录；
自动生成 API Key。

dashboard 默认密码为123456，请在 Settings → Change Password 中立即修改。API Key 在Dashboard → Settings → API Keys中查看，形如9r_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。CLI 的包信息（bin 命令9router指向 cli/cli.js）可在 cli/package.json 中确认。

5.2 连接提供商

文档提供三种连接方式（完整流程见 gitbook/content/es/getting-started/quick-start.md）：

方式 A：OAuth 连接订阅提供商（Claude Code、Codex、Gemini CLI、GitHub Copilot）——Dashboard → Providers → Connect，登录并授权后自动刷新 token，配额追踪即刻生效。例如连接 Claude Code 后即可使用cc/claude-opus-4-5-20251101；
方式 B：API Key 连接低价提供商（GLM、MiniMax、Kimi、OpenRouter）——Dashboard → Providers → Add API Key，选择提供商并粘贴 Key。例如 GLM 使用模型glm/glm-4.7；
方式 C：连接免费提供商（iFlow、Qwen、Kiro）——Dashboard → Providers → Connect，按 Device Code 或 OAuth 授权即可，无配额限制。

5.3 配置你的 CLI 工具

以最常用的几种工具为例：

Cursor IDE：

Settings → Models → Advanced: OpenAI API Base URL: http://localhost:20128/v1 OpenAI API Key: [从 9router dashboard 获取] Model: cc/claude-opus-4-5-20251101

Claude Desktop（编辑~/.claude/config.json）：

{ "anthropic_api_base": "http://localhost:20128/v1", "anthropic_api_key": "your-9router-api-key" }

Codex CLI：

export OPENAI_BASE_URL="http://localhost:20128" export OPENAI_API_KEY="your-9router-api-key" codex "your prompt"

Cline / Continue / RooCode：选择 Provider 为 OpenAI Compatible，填入相同的 Base URL、API Key 与模型 ID 即可。

5.4 验证安装

# 检查服务状态 curl http://localhost:20128/health # 列出可用模型 curl http://localhost:20128/v1/models \ -H "Authorization: Bearer your-api-key" # 测试一次对话 curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer your-api-key" \ -H "Content-Type: application/json" \ -d '{ "model": "cc/claude-opus-4-5-20251101", "messages": [{"role": "user", "content": "Hello!"}] }'

/health正常时返回{"status": "ok", ...}，/v1/models返回 OpenAI 风格的模型列表（如cc/claude-opus-4-5-20251101）。

5.5 用 Combo 一键定义回退链

「Combo」是 9Router 的自定义回退链：把多个模型按优先级排成序列，在 CLI 中直接以组合名作为 model 使用，9Router 会按序尝试直到成功。典型示例：

Dashboard → Combos → Create New Name: premium-coding Models: 1. cc/claude-opus-4-5-20251101（主订阅） 2. glm/glm-4.7（低价后备，$0.6/1M） 3. if/kimi-k2-thinking（免费兜底） CLI 中直接使用: Model: premium-coding

Combo 支持预算上限（达到后跳过付费模型只走免费）、单模型启停、克隆等高级配置，完整说明见 gitbook/content/es/features/combos.md。

六、典型使用场景

6.1 个人开发者

最大化 Claude Code/Codex 订阅配额；
优先使用 Gemini CLI 免费层级（180K/月）；
配额耗尽自动回退到超低价模型（$0.20/1M）；
全天候编码，不再被 rate limit 打断。

6.2 团队

部署到 VPS/云主机供多人共享（部署方案见 gitbook/content/es/deployment/cloud.md 与 gitbook/content/es/deployment/localhost.md）；
实时追踪团队支出，按层级设置预算上限；
集中管理所有提供商的凭据与配额。

6.3 移动 / 远程编码

借助官方云托管或自建隧道，从 iPad、手机等任意设备访问；
摆脱 localhost 的本地限制；
仓库内置 Cloudflare 隧道相关实现（见 src/lib/tunnel/cloudflare/manager.js），可用于把本机 9Router 暴露到公网。

七、源码佐证：仓库中的实现细节

除文档外，仓库源码印证了上述能力的存在与组织方式：

CLI 与服务器：cli/package.json 定义9router二进制命令（指向 cli/cli.js），MIT 许可，Node >= 18 即可运行；
提供商注册与执行器：open-sse/providers/registry/ 下有 40+ 提供商的注册文件（含 glm-cn.js、minimax.js、kiro.js、iflow.js 等），open-sse/executors/ 则按提供商实现了请求执行逻辑；
配额与用量追踪：src/lib/usageDb.js、src/lib/requestDetailsDb.js 以及 src/services/usage/ 负责用量与成本的持久化与统计，支撑 Dashboard 的配额概览和费用报表；
隧道/远程访问：src/lib/tunnel/cloudflare/ 提供 Cloudflare 隧道实现，支持文档所述「随时随地编码」的远程使用方式。

从源码结构可以推断，9Router 的架构是「统一 OpenAI 兼容入口 + 各提供商专属执行器 + 统一配额/用量追踪」的组合，这也正是它能做到「一个端点接所有工具、一套机制管所有提供商」的原因。

八、下一步学习路径

快速开始（5 分钟上手） —— 三种连接方式与各工具配置细节；
安装指南（含环境变量与故障排查） ——JWT_SECRET、INITIAL_PASSWORD、PORT、DATA_DIR等生产环境变量；
智能路由与自动回退 —— 配额/预算触发逻辑、四种模式示例与最佳实践；
配额追踪与用量监控 —— Dashboard 面板、/api/quota与/api/usage接口；
Combo 自定义回退链 —— 从创建到高级配置的完整指南；
低价提供商与免费提供商 —— 各通道价格、重置周期与连接步骤；
FAQ 与故障排查 —— 常见问题与排障流程。

按照「订阅优先 → 低价兜底 → 免费保底」的配置思路，配合 Combo 与配额监控，即可在几乎不改变开发习惯的前提下，把 AI 编码的成本与中断概率同时降到最低。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析