9Router 是一款专为开发者设计的开源、免费且极具创新的本地 AI 接口路由与聚合工具。它的核心逻辑是充当用户本地的编程工具（如 Cursor、Cline、Claude Code 等）与外部 AI 大模型提供商（如 OpenAI、Anthropic、Gemini、iFlow 等 40 多家厂商）之间的“智能调度枢纽”。
通过 9Router，开发者彻底告别了“频繁切换 API Key”、“额度突然耗尽导致编码中断”以及“每月承担高昂大模型订阅费”的窘境。系统独创了“智能三级回退（3-Tier Fallback）”与自定义 Combo 机制，允许你将不同价位的模型按梯队绑定。当优质昂贵的订阅模型遇到 Rate Limit（请求限流）或网络报错时，请求将被瞬间且无感地自动路由至廉价或完全免费的备用大模型上。再辅以其强大的底层协议格式互译（OpenAI 与 Claude 等规范无缝转换）、自动化 OAuth 刷新和多账号负载均衡技术，9Router 能为你打造一套 24 小时不间断、几乎零成本的顶级 AI 辅助编程环境。
Function List
- 智能三级路由降级（Smart 3-Tier Fallback）：支持对大模型按照“自有订阅层” ➔ “低成本备用层” ➔ “永久免费兜底层”自定义优先级。一旦主模型额度耗尽或发生错误，秒级切换至下一层级，保障业务零中断。
- 跨协议格式互译（Format Translation）：底层内置协议解析引擎，实时在 OpenAI、Claude 和 Gemini 的消息传输格式间双向无损翻译，确保市面上任意只支持 OpenAI 规范的 IDE 都能直接调用 Claude 等其他模型。
- OAuth 聚合与免凭证调用：无需手动购买和粘贴繁杂的 API Key。全面支持通过 OAuth 获取如 Claude Code、Gemini CLI 的授权 Token，并在后台自动执行 Token 续期，一劳永逸。
- 多并发账号负载均衡（Multi-Account Support）：同一个模型平台支持同时挂载多个账号。9Router 会自动采用轮询（Round-Robin）调度策略分摊请求，用数量堆叠突破官方对单账号的并发数限制。
- 免费白嫖大模型池直连：系统原生内嵌了对完全免费的大模型服务商（如 iFlow、Qwen Code 官方免费版、Kiro）的支持集成，0 门槛体验不限量的优质补全。
- 可视化仪表盘与额度监控（Dashboard）：自带功能完善的 Web 界面大盘，直观展示各模型的 Token 消耗、免费额度刷新倒计时，以及通过智能路由所“节省下的资金成本估算”。
- 请求溯源与云端同步（Cloud Sync）：支持对所有请求/响应的完整日志记录，方便开发者排查请求异常；同时自带配置数据云端同步功能，实现跨设备的无缝工作流。
Using Help
9Router 被设计为前端工程师与极客开发者的梦幻底层基础设施。它不仅能帮您省下不菲的 API 充值费用，更能显著提升 AI 编程效率。为确保您能充分利用该工具免费调用全球上百种模型并避免报错，请仔细阅读以下详尽的操作流程指南。
一、 安装与环境初始化部署
9Router 采用 Node.js/Next.js 栈构建，您可以非常灵活地在任何具备 JavaScript 运行时的设备上部署。
方式 1：使用 NPM 全局安装（最推荐，简单快捷）
- 请确保您的电脑已预装了 Node.js（推荐 20.x 及以上版本）。
- 打开系统终端或命令行，输入全局安装指令：
npm install -g 9router - 安装完毕后，直接在终端执行运行命令：
9router - 恭喜！此时后台服务已自动启动，且会在默认浏览器中弹出
http://localhost:20128，这就是您专属的 9Router 可视化 Dashboard（控制面板）。
方式 2：使用 Docker 容器化稳定部署（适合服务器或长期后台运行）
如果您希望将 9Router 搭建在一台闲置的群晖 NAS、VPS 或本地局域网的主机上，Docker 是完美的选择：
- 确保目标机器已安装 Docker 引擎。
- 运行一键拉取并挂载数据卷的命令：
docker run -d --name 9router -p 20128:20128 -v 9router-data:/app/data -v 9router-usage:/root/.9router 9router - 随后，在局域网内任意机器通过
http://[宿主机IP]:20128即可访问控制台。
二、 零成本接入：配置首批免费模型
要想实现“零成本”大模型调用，我们需要首先向 9Router 的代理池中注入免费的算力提供商。
- 进入 9Router 控制台界面，点击左侧导航栏的 [Providers（提供商）]。
- 找到系统内置的“免费级提供商”区域（如
iFlow、Qwen或免费大额度的Gemini CLI）。 - 以
Gemini CLI为例，点击 [Connect]，控制台会拉起一个 Google OAuth 授权窗口，登录你的普通谷歌账号即可，系统会自动获得每月 18 万次的免费高阶请求额度！ - 继续连接如
iFlow等完全不设限的平台，只需按提示走完 OAuth，无需注册绑卡。
三、 核心高阶玩法：创建智能三级回退（Combo）组合规则
这是 9Router 的灵魂功能。为了不让代码补全因为配额限制而“卡壳”，我们需要创建一个名为 Combo 的虚拟合成模型。
- 在控制台左侧点击 [Combos（模型组合）]，然后点击新建。
- 为这个组合起一个酷炫的代号，比如
always-on-coding（全天候无中断编程）。 - 设置第一梯队（最佳质量）：把您现有的最优资源排在第一位（例如您已授权的
cc/claude-opus-4-6）。这是 9Router 的首选。 - 设置第二梯队（廉价备用）：添加例如
glm/glm-4.7（智谱便宜模型，每百万 Token 仅极低价格），作为第一梯队耗尽时的降级选择。 - 设置第三梯队（无限免费）: Add
if/kimi-k2-thinking(来自 iFlow 的无限量白嫖接口)。 - 点击保存。现在，您获得了一个虚拟大模型
always-on-coding。在外界看来，它是一个永不宕机、且聪明绝顶的单一接口。
四、 实战：在各大编辑器客户端中接入使用
完成以上配置后，9Router 本地网关已在 http://localhost:20128/v1 开放出了标准的、兼容 OpenAI 通信协议的接口，支持直接取代任何 IDE 的默认请求节点。
在 Cursor 中零成本使用：
- show (a ticket) Cursor The settings page of the
- 在模型配置选项卡找到
OpenAI Compatible（或自定义基地址）模块。 - Base URL（基地址） Fill in:
http://localhost:20128/v1 - API Key 填写：在此处填入你在 9Router Dashboard 中任意复制的一个 Key 或随便填入占位符（由于属于内网信任转发，无需校验严苛凭证）。
- Model name 填写：手动覆盖输入刚刚您创建的组合名
always-on-coding，或者填入具体的免费模型代号，如gc/gemini-2.5-pro。 - 回到写代码的界面尽情使用即可！所有跨协议的转换全部由路由器静默完成。
在 Cline / RooCode (VS Code 扩展) 中使用：
- 在扩展设置中，API Provider 选择
OpenAI Compatible。 - Base URL 和 API Key 同上。
- 输入任意配置好的具体模型。您的 Cline 即可完美绕过原本只能充值官方余额的限制，流畅驱动业务代码生成。
五、 管理与日常监控说明
由于接入了各大不同计费逻辑的服务商，9Router 为您整理了一套清晰的数据大盘：
- 在 Usage Analytics (用量统计) 中，你可以看到每小时请求波峰和消耗的 Token 树木。
- 关于 Dashboard 中显示的“Cost（成本费用）”：请务必注意，9Router 是一款本地免费软件，绝对不会向您扣费。此处显示的高昂美金金额，仅仅是系统在帮您估算：“如果您使用的是官方按量付费通道，您原本会花掉多少钱”。这也是一种展现由于智能路由为您节省了多少真金白银的“炫耀”面板！
application scenario
- 解决 Cursor/Cline 等重度 AI 代码工具吃额度极快的问题
当开发者使用具备项目级修改权限的 AI 助手（如 Cline、RooCode）时，单个指令动辄产生几十万 Token 的输入输出。通过 9Router 将请求中继路由至完全免费或额度庞大的平台（如 Gemini CLI），即可打消“用代码如流水烧钱”的焦虑心理，使独立开发者也能随心所欲让 AI 扫描整个代码库。 - 化解因官方 Rate Limit 封锁导致的工作停滞
在黑客松或临近项目交付期间进行高频度代码生成时，单一账号往往会触发大模型服务商“每分钟请求次数超限（429 报错）”。通过 9Router，您可以挂载 5 个普通的 GitHub 或 Google 账号，系统利用负载均衡在这些账号间进行请求均摊分配，彻底碾压并发限制规则。 - 企业或工作室打造局域网公共 AI 网关大动脉
小型工作室可以直接在内网服务器中部署 9Router 的 Docker 镜像。管理员集中绑定几个公费购买的订阅版 Claude/OpenAI 账号，并配置好备用的廉价模型。局域网内的所有开发人员只需把 IDE 请求端点设为这台内网机器的 IP，整个团队共享高质量的并发算力，并受到统一的降级调度保护。
QA
- 9Router 是一个盈利性平台吗？它会盗刷我的信用卡吗？
绝对不会。9Router 是一款纯粹免费的开源项目。所有的代码都运行在你自己的电脑（Localhost）或服务器上，数据全部保存在你的~/.9router/本地文件夹中。软件没有内置任何支付系统，也绝不会、且无法向你收取任何使用费用。 - 为什么我在 Dashboard 里看到了几十甚至几百美金的消耗数据？
这是 9Router 的一项“资金节省测算（Savings Tracker）”功能。你看到的金额不是真实账单，而是系统在告诉你：“刚才这些代码补全，如果按厂商的标准 API 计费，原本需要花这些钱”。既然你是通过 9Router 配置的完全免费提供商（如 iFlow 或 Kiro）产生的调用，这意味着你实际付款金额为 $0，你可以把这个数字当成你通过本工具省下来的钱！ - 我填写的那个免费模型如 iFlow，真的是无限调用的吗？
是的。9Router 在后台为您收录的“免费层”（如 iFlow、Qwen 官方免费体验通道、Kiro）本身就是由那些厂商基于推广或特定授权分发的无限额免费福利。9Router 所做的只是通过反向解析它们原生的网页 OAuth 或特定授权方式，将它们“转译”为好用的本地接口，不存在背后的暗箱限流。 - 某个 CLI 客户端只支持输入 OpenAI 格式的模型名称，但我填入 Claude 模型会报错吗？
不会报错。这正是 9Router “跨协议格式互译”能力的强项。当你的客户端以标准的 OpenAI/chat/completions数据结构发送出请求并索要claude-opus时，9Router 会在内存中把这条请求瞬间拆解，重塑成符合 Anthropic API 官方要求的规范去发起调用，最后再把收到的响应重组为 OpenAI 的结构吐给前端，全过程对客户端完全透明且兼容。
