9Router 实测评估：把免费模型接进 Claude Code 的路由层，省 token 的代价是什么

它解决的是哪一类浪费

9Router 针对的是一个具体场景：你的 AI 编程工具订阅了 Claude Code 或 Copilot，但每月额度用不完，真到想用的时候又撞上限流。仓库的 README 把痛点列得很直白，订阅额度过期、速率限制打断编码、工具输出如 git diff 和 grep 结果烧掉大量 token，这些都是常见抱怨。项目把这些归成两类浪费，一是钱没花完就作废，二是 token 被低价值内容吃掉。它面向的是个人开发者和小团队，不是企业采购者。免费模型是它的卖点，但真正吸引人的是那套自动回退，订阅额度耗尽后滑到低价层，再滑到免费层，用户不用手动换提供商。这个设计假设你的痛点是成本和中断，如果你的痛点是输出质量或数据安全，这个项目就不是为你准备的。

三层回退与轮询的实际机制

README 里的架构图给出了清晰的数据流。你的 CLI 工具把请求发到 http://localhost:20128/v1，9Router 收到后先做格式转换，因为 OpenAI 格式和 Claude 格式不兼容，然后走 RTK token 压缩，再查配额，最后把请求送到某一层提供商。第一层是订阅服务，包括 Claude Code、Codex、GitHub Copilot；配额耗尽就降到第二层，即低价 API，例子是 GLM 每百万 token 0.6 美元、MiniMax 0.2 美元；预算上限触达后再落到第三层免费服务。此外还有多账户轮询，同一提供商下多个账号按 round-robin 方式轮流使用，用来摊薄单账号的速率限制。这套机制的关键在于优先级是硬编码的，不是按延迟或质量动态选路。这意味着当订阅层可用时，它永远优先，哪怕免费层响应更快或质量更好。对想省钱的人这是合理默认，但如果你希望路由层智能选最优模型，它不是这么工作的。

RTK 压缩：省 token 的真实代价

RTK 是这个项目区别于普通代理的核心功能。它自动压缩 tool_result 内容，README 声称每请求可省 20% 到 40% 的 token。机制上它针对的是工具输出，也就是 git diff、文件列表、编译日志这类结构化文本，这些内容往往冗长且重复。压缩策略大概率是截断或摘要，但仓库没有公开具体算法。这里要提醒一句，压缩工具输出可能改变模型看到的信息。如果一段 diff 被截掉关键行，模型的修改建议就可能基于不完整上下文。对大型重构任务，省下的 token 可能换来一次错误的代码变更，调试成本远超节省的费用。另一个已知问题是缓存 token 追踪在 v0.5.18 才加入，说明此前版本对缓存命中的计费是不透明的。如果你重度依赖长上下文缓存，升级到最新版之前要留意这部分行为。

启动与接入的真实步骤

安装路径有两条。全局安装走 npm，命令是 npm install -g 9router，然后运行 9router，仪表盘会开在 localhost:20128。从源码跑则是另一套，先 cp .env.example .env，再 npm install，开发模式用 PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev，生产模式先 npm run build 再 npm run start。注意 README 明确说仓库包是私有的，叫 9router-app，所以从源码运行是预期的本地开发路径，而不是给普通用户的推荐方式。接入 CLI 工具时，把端点设为 http://localhost:20128/v1，API key 从仪表盘复制，模型名要带提供商前缀，比如 kr/claude-sonnet-4.5。免费提供商的接入号称无需注册，Kiro AI 每月送约 50 额度，OpenCode Free 完全免认证。这个免认证设计方便，但也意味着你无法控制谁在使用同一上游。

安全边界：本地代理的固有风险

9Router 是一个本地运行的代理进程，所有请求都经过它转发。这意味着你的 API 密钥集中存储在它的配置里，而不是分散在各个 CLI 工具自己的凭据管理中。一旦这个进程被攻破，攻击者拿到的是你所有上游提供商的访问权。另一个问题是流量明文经过 localhost，虽然不经过公网，但本机上的其他进程可以嗅探。对处理专有代码的开发者，这值得认真考虑。还有一层风险来自免费提供商本身，README 列出的 Kiro、OpenCode Free 这类服务，其隐私政策、数据留存和模型行为都不在你的控制范围内。把公司代码发给一个免费第三方模型，和发给官方付费 API 的法律风险是不同的。项目没有提供端到端加密或请求日志脱敏的选项，至少在 README 里看不到。

版本节奏与维护信号

从 release 记录看，项目维护活跃。v0.5.35 在 2026 年 7 月加入 Grok Imagine 视频生成和 Copilot Claude 路由，v0.5.20 加入 thinking level 选择器和跨提供商后缀支持，v0.5.18 修复了缓存 token 追踪。版本号推进快，功能迭代密集，这反映出项目处于快速扩张期。但快速迭代的另一面是稳定性风险，每个版本都在加新提供商和新功能，回归测试的覆盖范围存疑。许可证是 MIT，商用和修改都没有法律障碍，但要注意项目本身是 npm 全局包加私有源码仓库的混合结构，从源码构建的路径不是为普通用户优化的。升级成本方面，因为配置集中在 .env 和仪表盘里，小版本升级通常不涉及迁移，但大版本是否保持配置兼容，README 没有承诺。

替代方案：liteLLM 与直接多配置

最直接的替代是 liteLLM，它同样是本地代理，提供 OpenAI 兼容端点，也支持多提供商路由。区别在两点：liteLLM 没有内置的订阅配额追踪，也不做 tool_result 内容压缩，它把 token 优化留给用户自己处理。如果你不需要省 token，只需要一个统一端点来切换提供商，liteLLM 更轻也更成熟。另一个替代是根本不用代理，直接在 Claude Code 或 Cursor 的设置里维护多套 API 配置，手动切换。这省去了本地代理这一层安全风险，但放弃了自动回退和配额追踪。三者的取舍很清楚：9Router 用安全透明度和配置复杂度，换取自动省钱和 token 压缩；liteLLM 用更少功能换更稳的兼容性；手动配置用操作成本换最小攻击面。选哪个取决于你更缺钱、更缺时间，还是更缺安全感。

免费模型的隐性成本

README 把免费提供商包装成无需注册、直接可用的资源，但免费背后有隐性成本。免费层通常有更严格的速率限制，README 自己都承认订阅层会撞限，免费层只会更频繁。多账户轮询能缓解单账号限制，但免费提供商的账号本身可能随时被封或停服。还有模型质量问题，免费层提供的模型版本可能滞后，或者被提供商悄悄降级。对编码任务来说，一次错误的代码建议可能耗费数小时调试，这笔时间成本远超省下的 API 费用。9Router 的价值主张建立在 token 价格上，但开发者的真实成本是时间。如果免费模型导致返工率上升，20% 到 40% 的 token 节省就变成了虚假经济。这个项目适合把免费层当备用通道，不适合把它当主力。

编辑结论

9Router 适合两类人：一是个人开发者，手上已有 Claude Code 或 Cursor 的订阅额度，想用自动回退把空闲时段填满，同时靠 RTK 压缩工具输出省 token；二是愿意折腾、能接受把 API 密钥交给本地第三方进程的爱好者。不适合生产环境或处理敏感代码的团队，因为所有请求明文经过本地代理，密钥集中存储，且免费提供商的可用性与模型行为不受你控制。采用前先验证三件事：检查 .env 里每个上游密钥的存储方式，确认 RTK 压缩不会截断你依赖的 git diff 内容，以及用官方 SDK 直连同一个免费提供商，对比一次完整任务的成功率。这个项目解决的是成本问题，不是可靠性问题，把它当省钱工具用，别当基础设施。

官方来源

1. decolua/9router on GitHub
2. License: MIT
3. Project website
4. README
5. Releases