9Router Vibe 项目

9Router 是一款免费的 AI 路由器与 Token 节省工具，核心目标是让开发者在写代码时「永不断线」。它把 Claude Code、Codex、Cursor、Cline、Copilot、Antigravity、OpenClaw、OpenCode 等各类 AI 编程工具，统一连接到 40 多家 AI 服务商与 100 多个模型上，并通过智能路由与自动降级机制，把「订阅额度用尽就停工」变成「自动切换到更便宜甚至免费的模型继续干活」。

项目简介

9Router 要解决的是 AI 编程中几个非常具体的痛点：订阅额度每月到期作废、限流让你写到一半被迫中断、工具输出（git diff、grep、ls 等）飞速消耗 token、每个服务商动辄 20–50 美元的月费，以及在多个服务商之间手动切换。它的应对方式是在本地起一个统一的 OpenAI 兼容端点（默认 http://localhost:20128/v1），所有 CLI 工具都指向它，由它来决定这次请求该走哪条线路。

核心功能

• RTK Token 节省器：在请求发给大模型之前，自动识别并压缩工具输出内容，支持 git-diff、git-status、grep、find、ls、tree、dedup-log、smart-truncate、read-numbered、search-list 等多种过滤器，官方称每次请求可节省 20%–40% 的输入 token。
• 三级智能降级：自动按「订阅 → 便宜 → 免费」的顺序路由。第一级走 Claude Code、Codex、GitHub Copilot 等订阅服务；额度耗尽后降到 GLM、MiniMax 等低价模型；再超预算则切到 Kiro、OpenCode Free、Vertex AI 等免费来源，实现零停机。
• 实时额度追踪：显示剩余 token 数与重置倒计时，帮助把每月订阅额度的价值榨干。
• 格式翻译：在 OpenAI、Claude、Gemini、Cursor、Kiro、Vertex 等不同 API 格式之间自动转换，因此任意 CLI 工具都能接任意服务商。
• 多账号轮询：同一服务商可配置多个账号做负载均衡与冗余。
• OAuth Token 自动刷新：登录态到期后自动刷新，无需手动重新登录。
• Caveman 模式：注入「原始人风格」提示词让模型回复极简，保留技术实质的同时减少输出 token，官方称可节省最多 65% 输出 token。
• Ponytail 模式：注入「资深懒惰工程师」提示词，让模型写最少的、YAGNI 优先的代码，提供 Lite / Full / Ultra 三档，减少输出 token 与后续重构量。
• Headroom Token 节省器：可选的 /v1/compress 外部压缩代理，在不改动客户端的前提下进一步压缩上下文。
• 自定义组合：可以自由创建模型组合，定制自己的降级顺序。
• 请求日志与用量分析：调试模式记录完整请求与响应，用量面板统计 token、成本与趋势。
• 云同步：配置可跨设备同步。
• 多环境部署：支持本地、VPS、Docker、Cloudflare Workers 等部署方式；也保留 X-9Router-Token-Saver 请求头，便于对单次请求关闭全部节省策略。

技术实现

9Router 自身是一个基于 Next.js 构建的本地服务（仓库提供 package.json、next.config.mjs、custom-server.js、docker-compose.yml 等文件），默认监听 20128 端口，对外暴露 OpenAI 兼容的 /v1 接口，因此 Claude Code、Codex、Cursor 等工具只需把 Endpoint 指向它、填入面板里拷贝出来的 API Key、再指定模型名（如 kr/claude-sonnet-4.5）即可完成接入。它内置了针对不同服务商的适配层，负责处理鉴权方式（OAuth 或 API Key）、请求体格式差异与 token 刷新逻辑；对工具输出则通过「先看每个 tool_result 的前 1KB 再决定套用哪个过滤器」的自动检测机制做无损压缩。项目还支持把自建的语音与向量服务作为「自托管服务商」接入：STT 走 /v1/audio/transcriptions，TTS 走 /v1/audio/speech，Embedding 走 /v1/embeddings，地址通过连接配置里的 providerSpecificData.baseUrl 指定，官方特别提醒 Embedding 的 baseUrl 需要带上 /v1，否则适配器拼接后会打到错误路由。为避免误把输入内容发往第三方，自托管 Embedding 设计上没有云端兜底——缺少 baseUrl 的连接会被直接报为配置错误。

快速上手

1. 全局安装并启动：执行 npm install -g 9router，然后运行 9router，控制台会打开 http://localhost:20128。
2. 接入一个免费服务商：在面板的 Providers 页连接 Kiro AI（每月约 50 免费额度，含 Claude 4.5、GLM-5、MiniMax）或 OpenCode Free（无需鉴权），也可以选择带 300 美元新账号额度的 Vertex AI。
3. 在 CLI 工具中填配置：进入 Claude Code / Codex / Cursor / Cline / OpenClaw 等工具的设置，把 Endpoint 设为 http://localhost:20128/v1，API Key 填面板里复制的值，模型填 kr/claude-sonnet-4.5 这类路由名。
4. 从源码本地运行（可选）：复制 .env.example 为 .env，执行 npm install，然后以 PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev 启动开发模式；生产模式则先 npm run build 再 npm run start。
5. 按需开启节省策略：在面板中启用 RTK、Caveman、Ponytail 等模块，或针对单次请求用 X-9Router-Token-Saver: off 临时关闭。

适用人群

需要长时间写代码、希望降低 AI 编程成本的个人开发者；同时使用多个 AI 编程工具与多个服务商、需要统一网关的工程师；自建语音与向量服务、希望把本地模型接入统一路由的技术团队；以及关注 token 消耗与成本趋势的 AI 重度用户。

项目信息

9Router 采用 MIT 许可证，源码托管在 GitHub，项目主页为 9router.com，提供中文等多语言 README。项目生态中还感谢了 RTK、Caveman、Ponytail 等上游开源项目，9Router 将其中部分能力封装为内置功能。官方同时提示：iFlow、Qwen Code、Gemini CLI 的免费额度已于 2026 年停用；Kiro AI 自 2025 年 9 月起转为额度制，免费档每月上限 50 credits，新账号前 30 天另有 500 试用 credits；OpenCode Free 的免费模型列表会随时间波动。

项目链接

https://github.com/decolua/9router ｜ 官网：https://9router.com