9Router：AI 编程工具的"万能遥控器"

免费白嫖 Claude / Cursor / Copilot 的秘密武器

写在前面

今天刷 GitHub Trending 的时候看到一个项目排在 AI 分类前列，名字叫 9Router。点进去一看描述——"Unlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40+ providers."

免费？无限？把所有主流编程工具都接上？

我第一反应是"又来了，标题党"。但翻了 Star 曲线和社区讨论后，发现这个项目确实有点东西。4 个月前创建，今天已经 8300+ Star，85 个贡献者，而且迭代频率非常高。更关键的是，它解决的问题太精准了——AI 编程工具碎片化这件事，困扰的不止我一个。

所以今天花时间深入看了一下，把我的理解整理出来。

先说结论

9Router 是一个本地部署的 AI 路由网关。你可以把它理解成一个"万能遥控器"——所有 AI 编程工具（Claude Code、Cursor、Cline、Codex、Copilot 等）都通过它来调用模型，它负责帮你选最便宜的路径、在模型挂了的时候自动切到备用、还能压缩 token 省钱。

一句话：你只需要关心写代码，模型选择和成本优化的事交给它。

它解决了什么问题？

用 AI 编程工具的人大概都会遇到这几个痛点：

痛点一：工具太多，每个都要单独配。 你可能同时用 Cursor 写前端、Claude Code 写后端、Cline 调试。每个工具都得单独配 API Key、Base URL、模型名，改一次密码要改 N 个地方。

痛点二：额度永远不够用。 Claude Pro 每周 5 小时额度，用完了就得等下周。想换到 DeepSeek 又得重新配。Cursor 的额度也经常见底。

痛点三：git diff 吃 token 太狠。 你让 AI 看一下项目改了什么，一个 git diff 输出就能吃掉几千 token。代码量大的项目，光工具输出就占了请求成本的大头。

痛点四：模型挂了，整个流程就断了。 API 报错、限流、额度耗尽……这些中断对编程体验的打击是毁灭性的，尤其是你正在 flow 中的时候。

9Router 就是为这些事而生的。

核心功能拆解

三层 Fallback：永远不中断

这是我觉得最有价值的功能。你可以配置一个模型优先级链：

第一优先级：你的 Claude Pro 订阅（质量最高）
第二优先级：GLM-5.1 API（便宜，$0.6/1M tokens）
第三优先级：iFlow/Kiro 免费模型（兜底，质量稍降但免费）

主力模型限流了？自动切到第二层。第二层也挂了？切到免费层。整个过程对上层工具完全透明，你甚至感觉不到切换 happened。

而且不只是模型级的 fallback。同一个 provider 可以配多个账号轮询，同一个账号可以有多个 URL 备用。三层保护：模型→账号→URL。

RTK Token Saver：省 20%-40% 的 input token

这个功能在 token 越来越贵的当下挺实用的。

原理很简单：在请求发给模型之前，9Router 会压缩工具输出（git diff、grep 结果、目录树、日志等）。这类输出通常包含大量重复信息和格式化噪音，压缩后不影响 AI 理解代码变更，但能省下 20%-40% 的 input token。

官方给的测试数据是在 git diff 和 tree 输出上效果最明显。对于大项目的日常开发，积少成多，这个节省不是小数目。

不过有一点要注意：涉及关键上下文、完整错误日志或长文件内容时，建议关掉压缩。过度压缩可能让模型丢失重要信息。

40+ Provider、100+ 模型，一个端点全搞定

这是 9Router 的核心卖点。支持的 provider 分三类：

所有这些 provider 都通过同一个 OpenAI 兼容 API 端点（http://localhost:20128/v1）访问。上层工具不需要知道背后是哪个 provider，就像你用 USB Hub 接多个设备一样。

MITM 代理模式：拦截硬编码 API 的工具

有些工具（比如 Claude Code、Codex CLI）的 API 地址是写死的，没法改。9Router 有个 MITM 代理功能可以解决这个问题——生成本地 CA 证书，修改 hosts 文件把工具的 API 域名劫持到本地 127.0.0.1，然后由 9Router 转发请求。

听起来有点 hack，但实际用起来很简单，支持 Windows/macOS/Linux 三平台。

技术架构

看完功能再看看实现，就知道这帮人不是闹着玩的。

技术栈：Next.js 16 + React 19 + Tailwind CSS 4 + LowDB（本地 JSON 存储）

核心引擎：自研的 open-sse 模块，负责所有路由逻辑：

• 双层翻译引擎：以 OpenAI 格式为中间标准，把 N×M 的格式转换降为 O(N+M)。支持 14 种格式互转，包括 OpenAI ↔ Claude、OpenAI ↔ Gemini、OpenAI ↔ Cursor（Protobuf 协议）等
• 12+ 专用执行器：每个复杂 provider 有定制逻辑。比如 CursorExecutor 处理 Protobuf 协议，AntigravityExecutor 做工具名称伪装防检测
• 流式处理 Pipeline：上游 SSE 响应 → 格式转换 TransformStream → 断开感知流 → 客户端。如果客户端断开，500ms 后自动中止上游请求，不浪费资源
• 指数退避熔断：限流时冷却时间按 1s→2s→4s 递增，最大 2 分钟

这个架构设计在一个 4 个月的项目里算是相当成熟的了。85 个贡献者的协作成果可见一斑。

安装体验

三行命令的事：

# 全局安装
npm install -g 9router

# 启动
9router

# 打开管理面板
open http://localhost:20128

启动后在 Dashboard 里添加 provider 就行。OAuth 类的 provider 直接点击授权登录，API Key 类的填入 Key 即可。

然后在你的 AI 编程工具里改两个配置：

Base URL: http://localhost:20128/v1
API Key: 从 Dashboard 生成的 Key

Claude Code 的配置更简单，直接改 ~/.claude/config.json：

{
  "anthropic_api_base": "http://localhost:20128/v1",
  "anthropic_api_key": "你的9Router API Key"
}

Codex CLI 用环境变量：

export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="你的9Router API Key"

也支持 Docker 部署，适合在 VPS 上跑：

docker run -d \
  --name 9router \
  -p 20128:20128 \
  --env-file ./.env \
  -v 9router-data:/app/data \
  9router

整个上手过程大概 10 分钟，对有 Node.js 基础的人来说没什么门槛。

和竞品比怎么样？

AI 路由网关这个赛道其实已经不少玩家了。我把 9Router 和几个主流方案放在一起对比：

9Router 的差异化在哪：

1. 它是唯一专门给 AI 编程工具做的网关。OpenRouter、LiteLLM、Portkey 都是通用 LLM 网关，什么场景都能接。9Router 只专注一件事：让 Claude Code / Cursor / Cline / Codex 这些编程工具更好用。为此它做了 MITM 代理、Claude 原生格式翻译、Cursor Protobuf 协议适配这些脏活。
2. 它是唯一做 Token 压缩的。其他三个都没有这个功能。
3. 免费，数据不出本机。这对在意隐私的开发者来说是实打实的优势。

短板：

1. Provider 数量不够多，100+ 模型听起来不少，但 OpenRouter 有 300+。
2. 可观测性弱，基本只有请求日志。Portkey 那种端到端追踪、成本归因、延迟分析，9Router 都没有。
3. 项目才 4 个月，稳定性有待验证。
4. 不适合企业用。SSO、审计日志、合规认证这些东西全缺。

实际使用建议

最佳上手路径：先本地装一个，接一个常用工具和一个 provider。确认请求和 fallback 都正常后，再逐步加账号和模型组合。别一上来就配全套，会把自己搞晕。

安全提醒

有几点必须说在前面：

把个人订阅、OAuth token 接给自动化工具是有风险的。9Router 跑在本地，数据不出本机，安全性比云端方案好很多。但还是建议：

• 只在自己可控的本机环境使用
• VPS 部署一定要改默认密码、设 JWT_SECRET、不要把 Dashboard 裸露到公网
• 定期检查 provider 账号的异常活动
• 免费额度可能随时被 provider 取消或调整，别把生产依赖放上面

社区数据

综合评分

参考链接

• GitHub 仓库：decolua/9router
• 官网：9router.com
• npm 包：npmjs.com/package/9router
• Trendshift 数据：trendshift.io/repositories/22628

本文基于 GitHub 公开数据、项目文档及社区反馈整理，仅供技术参考。