使用 9Router 为 Roo AI Assistant 统一接入多模型网关OpenAI 兼容端点配置实战【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router本指南讲解如何将开源 AI 编程助手 Roo AI AssistantRoo Code接入 9Router 的 OpenAI 兼容网关/v1端点从而在 Roo 的单一界面中按需调用 Claude、DeepSeek、GLM 等多家的模型。读完本文你将掌握本地与云端两种 Base URL 配置方式、模型命名规则与选型策略、连接测试与故障排查方法以及模型别名、多 Profile 等进阶用法。集成概述Roo 9Router 能解决什么问题Roo AI Assistant 是一款支持自定义 API Provider 的 AI 编程助手其配置面板中内置了 Ollama 这一 OpenAI 风格兼容选项。9Router 恰好对外暴露的就是一个统一的 OpenAI 兼容端点/v1/*二者天然匹配在 Roo 中只需把 Provider 类型选为Ollama把 Base URL 指向 9Router 即可无需 Roo 本身认识几十个上游厂商9Router 负责把 Roo 发出的 OpenAI 格式请求翻译成各上游Claude Code、Codex、GLM 等需要的协议并将响应翻译回 OpenAI 格式回传给 Roo相关翻译引擎位于 open-sse/translator请求从 Roo 发出后进入 9Router 的handleChat处理链路支持 Combo 组合、多账号回退、用量统计等能力见 src/sse/handlers/chat.js 与 open-sse/handlers/chatCore.js。因此集成完成后你在 Roo 聊天框中切换模型实际就是在切换 9Router 背后连接的不同厂商账号。准备工作按官方集成说明见 gitbook/content/es/integration/roo.md开始前需要满足三项前提已安装 Roo AI Assistant拥有 9Router 的 API Key从 9Router 控制台 Dashboard 获取9Router 正在运行——本地运行或使用云端实例均可。快速启动 9Router本地9Router 推荐通过全局 CLI 启动Node.js 20 环境下执行详见 gitbook/content/es/getting-started/quick-start.mdnpm install -g 9router 9router启动后 Dashboard 会自动打开在http://localhost:20128默认密码为123456首次登录后请在 Dashboard 中修改API Key 会自动生成。默认运行端口20128在 CLAUDE.md 与 .env.example 中均有明确记录.env.example中PORT20128。启动后在浏览器访问http://localhost:20128/health应返回{ok: true}——该健康检查端点实现在 src/app/api/health/route.js这也是后面排查连接失败问题时最有用的探测手段。在 Roo 中配置 API Provider启动 Roo AI Assistant 后打开设置面板按以下步骤配置进入API Provider设置将 Provider 类型选择为Ollama选择它的原因与 Cline 集成一致Roo 的 Ollama 选项兼容 OpenAI 风格 API无需 Roo 原生支持 9Router填写下列连接参数。本地 9RouterBase URL: http://localhost:20128/v1 API Key: your-api-key-from-dashboard云端 9RouterBase URL: https://9router.com/v1 API Key: your-api-key-from-dashboard要点无论本地还是云端Base URL 都必须带上/v1后缀否则请求无法命中网关的路由端点。请求是如何被接住的/v1 路由原理从源码看/v1前缀的请求由 next.config.mjs 中的 rewrite 规则统一转发到内部 API 路由{ source: /v1/:path*, destination: /api/v1/:path* }Roo 的聊天请求实际落到/api/v1/chat/completions该路由在 src/app/api/v1/chat/completions/route.js 中实现先初始化翻译器initTranslators()来自 open-sse/translator/index.js随后调用handleChat(request)进入完整的路由与回退链路。此外该路由对OPTIONS预检请求返回了全放开 CORS 头Access-Control-Allow-Origin: *确保各类桌面客户端跨域调用不会被浏览器策略拦截。选择模型理解 9Router 的模型命名在 Roo 的 Model 字段中你需要手动填写 9Router 的模型名。命名采用前缀/模型名的格式前缀代表上游提供商前缀约定可参考 gitbook/content/es/getting-started/quick-start.md 的可用模型清单。Claude 系列cc/对应 Claude Code 订阅账号模型名定位cc/claude-opus-4-5-20251101最强能力cc/claude-sonnet-4-20250514均衡之选cc/claude-haiku-4-20250514快速响应DeepSeek 系列cx/对应 Codex 订阅账号模型名定位cx/deepseek-chat通用目的cx/deepseek-reasoner复杂推理GLM 系列glm/对应 GLM API Key 提供商模型名定位glm/glm-4-plus高级能力glm/glm-4-flash快速响应需要说明的是cc/、cx/、glm/这三个前缀来自同一份官方文档具体到当前仓库中可用的完整模型清单如cc/claude-sonnet-4-5-20250929、glm/glm-4.7等以 gitbook/content/es/getting-started/quick-start.md 的Available Models章节为准——模型清单会随上游版本更新填写时请以 9Router Dashboard 中实际启用的模型为准。模型清单的底层来源从源码结构看模型名并非写死在 Roo 集成层/api/v1/models相关端点见 src/app/api/v1/models/route.js 及同目录info/、[kind]/子路由会动态返回当前可用模型上层模型元数据集中在 open-sse/config/providerModels.js 与 open-sse/providers/registry 中。这意味着你在 Roo 中能用的模型集合 9Router 中已连接成功的提供商 你的订阅/额度所覆盖的模型而非固定列表。验证连接配置完成后向 Roo 发送一条测试消息Hello! Can you confirm youre connected through 9Router?若 Roo 正常回复且能感知上下文说明整条链路Roo → 9Router/v1→ 上游提供商 → 回传已打通。更精确的验证方式是先用 curl 直接探测网关curl http://localhost:20128/health返回{ok: true}表示 9Router 服务本身健康接下来再用真实请求验证 API Key 与模型名是否正确。使用示例基础聊天对 Roo 说: Explain quantum computing in simple terms 模型: cc/claude-sonnet-4-20250514代码生成对 Roo 说: Write a Python function to calculate Fibonacci numbers 模型: cx/deepseek-chat复杂推理对 Roo 说: Analyze the trade-offs between microservices and monolithic architecture 模型: cx/deepseek-reasoner这三类场景分别对应日常编码中最常见的三种负载短问答、代码产出、长文分析。切换模型时无需修改任何连接配置只改 Model 字段即可——这正是统一网关带来的便利。模型选型建议官方文档给出了按任务类型选择模型的直接指引快速任务cc/claude-haiku-4-20250514或glm/glm-4-flash低延迟适合简单问答、补全均衡性能cc/claude-sonnet-4-20250514或cx/deepseek-chat日常编码主力复杂推理cc/claude-opus-4-5-20251101或cx/deepseek-reasoner架构分析、长文理解成本优化优先 DeepSeek 或 GLM 系列API Key 类计费提供商单价通常低于订阅型额度消耗。该建议背后的逻辑与 9Router 的整体设计一致订阅型提供商cc/、cx/适合作为主力以榨干已有订阅额度而 GLM 等低价 API Key 提供商适合作为降级与补充具体配额与计价信息可参考 gitbook/content/es/providers 下的文档。常见问题排查Connection Failed连接失败确认 9Router 正在运行curl http://localhost:20128/health核对 API Key 是否正确以 9Router Dashboard 中生成的完整 Key 为准确认 Base URL 包含/v1后缀确认本地防火墙未拦截 20128 端口。Modelo no disponible模型不可用模型名必须与 9Router 中的命名完全一致注意大小写敏感例如glm/glm-4-plus不要写成glm/GLM-4-plus确认该模型在你的 9Router 方案/账号中已启用对应的上游提供商已成功连接尝试列表中的其他模型排除单个模型临时不可用的情况。Respuestas lentas响应缓慢切换到更快模型haiku、flash检查本地网络与上游可达性查看 9Router 日志定位是网关转发延迟还是上游本身缓慢日志与用量记录位于~/.9router目录下的usage.json与log.txt对应实现见 src/lib/usageDb.js。进阶配置自定义模型别名可以在 Roo 中为高频模型创建快捷别名减少记忆与手输成本Alias: fast → cc/claude-haiku-4-20250514 Alias: smart → cc/claude-opus-4-5-20251101 Alias: code → cx/deepseek-chat注模型别名在 9Router 侧也是一等公民——仓库中存在专门的模型别名接口 src/app/api/models/alias/route.js并在open-sse/providers/models/与 src/lib/mitmAliasCache.js 中参与模型归一化与缓存。若你的别名需求超出 Roo 设置面板的承载范围可以在 9Router Dashboard 的模型别名管理中统一维护。多 Profile 配置针对不同工作场景建立独立配置开发DesarrolloDeepSeek 系列模型用于代码编写写作EscrituraClaude 系列模型用于内容创作研究Investigaciónreasoner 系列模型用于深度分析。多 Profile 的价值在于不同场景对延迟、质量、成本预算的偏好差异很大按 Profile 隔离配置可以避免频繁手动改模型字段。进一步榨干网关能力完成基础集成后还可以在 9Router Dashboard 中为 Roo 使用的模型创建Combo组合——即配置主模型 降级备选链当主模型额度耗尽时自动切换备选如cc/claude-opus-...额度耗尽 → 自动落到glm/glm-4.7再落到免费模型实现零中断连续工作见 gitbook/content/es/features 下的 Combos 文档。此外 9Router 内置的 RTK 机制open-sse/rtk会在请求翻译前对tool_result等上下文内容做压缩以节省 tokenRoo 这类工具调用型 Agent 可从中直接受益。后续路径配置 Cursor 实现 IDE 集成注意 Cursor 要求使用云端端点为 VSCode 配置 ContinueCline 集成指南与 Roo 同为 VSCode 生态配置思路高度相似了解 9Router CLI 的日常用法快速开始安装、连接提供商与 Combo 组合完成 Roo 接入后你等于在一个编辑器中同时拥有了多套订阅/计费体系的模型资源池切换模型不再需要切换工具这正是 9Router 统一网关CLAUDE.md 所述的 one OpenAI-compatible endpoint routing across 40 upstream providers带给 Roo 用户的核心价值。【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考