ghcr.io/decolua/9router:0.4.27

9Router - 免费AI路由与Token节省工具

永不停歇地编码。借助RTK节省20-40%的tokens，并自动回退到免费及低成本AI模型。

连接所有AI代码工具（Claude Code、Cursor、Antigravity、Copilot、Codex、Gemini、OpenCode、Cline、OpenClaw...）至40+ AI提供商及100+模型。

🚀 快速开始 • 💡 功能特性 • 📖 安装设置 • 🌐 官方网站

🇻🇳 越南语 • 🇨🇳 中文 • 🇯🇵 日语

🤔 为什么选择9Router？

停止浪费金***、tokens和遭遇限制：

• ❌ 订阅配额每月未使用即过期
• ❌ 速率限制在编码过程中中断工作
• ❌ 工具输出（git diff、grep、ls...）快速消耗tokens
• ❌ 昂贵的API（每个提供商每月20-50***）
• ❌ 手动在提供商之间切换

9Router解决了这些问题：

• ✅ RTK Token Saver - 自动压缩tool_result内容，每次请求节省20-40%的tokens
• ✅ 最大化订阅价值 - 跟踪配额，在重置前充分利用每一部分
• ✅ 自动回退 - 订阅 → 低成本 → 免费，零停机时间
• ✅ 多账户 - 每个提供商的账户间轮询
• ✅ 通用性 - 适用于Claude Code、Codex、Cursor、Cline及任何CLI工具

🔄 工作原理

┌─────────────┐
│ 您的CLI工具 │ (Claude Code, Codex, OpenClaw, Cursor, Cline...)
└──────┬──────┘
│ http://localhost:20128/v1
↓
┌─────────────────────────────────────────────┐
│ 9Router (智能路由) │
│ • RTK Token Saver (减少tool_result tokens) │
│ • 格式转换 (OpenAI ↔ Claude) │
│ • 配额跟踪 │
│ • 自动Token刷新 │
└──────┬──────────────────────────────────────┘
│
├─→ [第一层：订阅] Claude Code, Codex, GitHub Copilot
│ ↓ 配额用尽
├─→ [第二层：低成本] GLM ($0.6/1M), MiniMax ($0.2/1M)
│ ↓ 预算限制
└─→ [第三层：免费] Kiro, OpenCode Free, Vertex ($300赠金)

结果：永不停歇地编码，最低成本 + 通过RTK节省20-40%的tokens

⚡ 快速开始

1. 全局安装：

npm install -g 9router
9router

🎉 控制台将在 http://localhost:20128 打开

http://localhost:20128

2. 连接免费提供商（无需注册）：

控制台 → 提供商 → 连接Kiro AI（免费Claude无限制）或OpenCode Free（无需认证）→ 完成！

3. 在CLI工具中使用：

Claude Code/Codex/OpenClaw/Cursor/Cline 设置：
Endpoint: http://localhost:20128/v1
API Key: [从控制台复制]
Model: kr/claude-sonnet-4.5

就是这样！开始使用免费AI模型编码。

替代方法：从源码运行（此仓库）：

此仓库包为私有（9router-app），因此源码/Docker执行是预期的本地开发路径。

9router-app

cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev

生产模式：

npm run build
PORT=20128 HOSTNAME=0.0.0.0 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run start

默认URL：

• 控制台：http://localhost:20128/dashboard http://localhost:20128/dashboard
• OpenAI兼容API：http://localhost:20128/v1 http://localhost:20128/v1

🔄 格式转换

格式间无缝转换：

• OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro ↔ Vertex ↔ Antigravity ↔ Ollama ↔ OpenAI 响应
• 您的 CLI 工具发送 OpenAI 格式 → 9Router 进行转换 → 服务提供商接收原生格式
• 兼容任何支持自定义 OpenAI 端点的工具

👥 多账户支持

• 每个服务提供商可添加多个账户
• 自动轮询或基于优先级的路由
• 当一个账户达到配额时自动切换到下一个账户

🔄 自动令牌刷新

• OAuth 令牌在过期前自动刷新
• 无需手动重新认证
• 所有服务提供商间的无缝体验

🎨 自定义组合

• 创建无限的模型组合
• 混合订阅、低成本和免费层级
• 为组合命名以便快速访问
• 通过云同步在设备间共享组合

📝 请求日志

• 启用调试模式以获取完整的请求/响应日志
• 跟踪 API 调用、头信息和负载
• 排查集成问题
• 导出日志用于分析

💾 云同步

• 在设备间同步服务提供商、组合和设置
• 自动后台同步
• 安全加密存储
• 从任何地方访问您的配置

云运行时注意事项

• 生产环境中建议使用服务器端云变量：BASE_URL（同步调度器使用的内部回调 URL）CLOUD_URL（云同步端点基础）
• BASE_URL（同步调度器使用的内部回调 URL）

BASE_URL

• CLOUD_URL（云同步端点基础）

CLOUD_URL

• NEXT_PUBLIC_BASE_URL 和 NEXT_PUBLIC_CLOUD_URL 仍为兼容性/UI 目的提供支持，但服务器运行时现在优先使用 BASE_URL/CLOUD_URL。

NEXT_PUBLIC_BASE_URL
  NEXT_PUBLIC_CLOUD_URL
  BASE_URL
  CLOUD_URL

• 云同步请求现在采用超时 + 快速失败机制，以避免在云 DNS/网络不可用时 UI 卡顿。

📊 使用分析

• 按服务提供商和模型跟踪令牌使用情况
• 成本估算和支出趋势
• 月度报告和洞察
• 优化您的 AI 支出

[!IMPORTANT] 理解仪表板成本：使用分析中显示的“成本”仅用于跟踪和比较目的。9Router 本身从不向您收取任何费用。您只需直接向服务提供商付费（如果使用付费服务）。例如：如果您的仪表板在使用 iFlow 模型时显示“总成本 $290”，这表示您直接使用付费 API 本应支付的金额。您的实际成本 = $0（iFlow 是免费无限量的）。可以将其视为“节省跟踪器”，显示您通过使用免费模型或通过 9Router 路由所节省的金额！

[!IMPORTANT] 理解仪表板成本：

使用分析中显示的“成本”仅用于跟踪和比较目的。9Router 本身从不向您收取任何费用。您只需直接向服务提供商付费（如果使用付费服务）。

例如：如果您的仪表板在使用 iFlow 模型时显示“总成本 $290”，这表示您直接使用付费 API 本应支付的金额。您的实际成本 = $0（iFlow 是免费无限量的）。

可以将其视为“节省跟踪器”，显示您通过使用免费模型或通过 9Router 路由所节省的金额！

🌐 随处部署

• 💻 本地主机 - 默认方式，支持离线使用
• ☁️ VPS/云服务器 - 跨设备共享
• 🐳 Docker - 一键部署
• 🚀 Cloudflare Workers - 全球边缘网络

仪表盘会跟踪您的令牌使用量，并显示若直接使用付费API时的预估成本。这并非实际账单——而是用于展示通过9Router使用免费模型或现有订阅所节省的金额的参考。

示例：

• 仪表盘显示："$290 总成本"
• 实际情况：您正在使用 iFlow（免费无限量）
• 您的实际成本：$0.00
• $290 的含义：使用免费模型而非付费API所节省的金额！

成本显示是一个“节省跟踪器”，帮助您了解自己的使用模式和优化机会。

不会。9Router 是在您自己的计算机上运行的免费开源软件。它绝不会向您收取任何费用。

您只需支付：

• ✅ 订阅提供商（Claude Code 每月 $20，Codex 每月 $20-200）→ 直接在其网站上向他们支付
• ✅ 低成本提供商（GLM、MiniMax）→ 直接向他们支付，9Router 仅路由您的请求
• ❌ 9Router 本身 → 绝不会收取任何费用，永远不会

9Router 是一个本地代理/路由器。它不会获取您的***信息，无法发送账单，也没有计费系统。它是完全免费的软件。

是的！当前的免费提供商（Kiro、OpenCode Free、Vertex）是真正免费的，无隐藏费用。

这些是各公司提供的免费服务：

• Kiro AI：通过 AWS Builder ID / Google / GitHub OAuth 提供免费无限量的 Claude 4.5 + GLM-5 + MiniMax