ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

9Router 与 Roo AI 助手集成指南:Ollama 兼容端点接入多模型路由

9Router 与 Roo AI 助手集成指南:Ollama 兼容端点接入多模型路由 9Router 与 Roo AI 助手集成指南Ollama 兼容端点接入多模型路由【免费下载链接】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导读本篇指南讲解如何将 9Router 与 Roo AI 助手Roo Code集成通过 Roo 内置的Ollama兼容 Provider指向 9Router 提供的 OpenAI 兼容 API从而在统一界面中访问 Claude、DeepSeek、GLM 等多个模型并享受自动降级Auto-fallback、配额跟踪等路由能力。读完本文你将掌握在 Roo 中配置 Base URL / API Key、按命名前缀挑选模型、做连通性验证、解决常见故障以及用别名与多 Profile 组织工作流的完整方法。1. 集成原理为什么 Roo 用 Ollama Provider 就能连 9RouterRoo AI 助手Roo Code本身是一个 VS Code 中的开源 AI 编码 Agent支持通过自定义 API 接入各家后端。9Router 对外暴露的是OpenAI 兼容的/v1接口默认本地端口20128见 README.md 与 CLAUDE.mdRoo 恰好把这类自定义 OpenAI 端点归类为Ollama类型的 Provider 配置入口——其本质都是填写一个 Base URL 加一个 API Key。因此集成链路非常直接Roo AI 助手 ──HTTP── http://localhost:20128/v1 (9Router) ──路由/翻译── Claude Code / Codex / GLM 等上游9Router 收到 Roo 发来的 OpenAI 格式请求后会做格式翻译OpenAI ↔ Claude ↔ Gemini 等多格式互转见 README.md 的功能说明再把请求转发到对应上游模型同时执行配额跟踪、自动降级等逻辑。也就是说Roo 侧只需要完成最简单的端点配置复杂的多模型路由全部由 9Router 承担。从源码看/v1前缀被 dashboardGuard.js 列为公开 API 前缀LLM 请求在处理器内部用自己的 API Key 做鉴权见 dashboardGuard.js这也解释了为什么集成时必须填写仪表盘生成的 API Key 而不是留空。2. 前置条件开始之前确认以下三件事齐备Roo AI 助手已安装VS Code 扩展市场安装并完成初始化。9Router API Key从 9Router 仪表盘的 API Key 页面生成并复制。9Router 正在运行本地运行默认http://localhost:20128或云端部署https://9router.com。本地运行方式可参考 README.md 的 Quick Start全局安装npm install -g 9router后执行9router仪表盘即打开在http://localhost:20128从源码运行则使用PORT20128 NEXT_PUBLIC_BASE_URLhttp://localhost:20128 npm run dev开发模式或npm run build PORT20128 HOSTNAME0.0.0.0 NEXT_PUBLIC_BASE_URLhttp://localhost:20128 npm run start生产模式。Docker 部署可参考 DOCKER.md端口同样映射为20128。3. 配置步骤Roo 侧3.1 打开 Roo 设置启动 Roo AI 助手点击设置图标打开配置面板进入API Provider设置区域。3.2 配置 API Provider在API Provider下拉列表中选择Ollama即自定义 OpenAI 兼容端点的入口按下表填写连接参数本地 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结尾这是 9Router 的 OpenAI 兼容 API 挂载点API Key 来自 9Router 仪表盘与 Roo 自身的许可证/账号无关如果 Roo 还要求填写 Model ID可先填入下文任意一个模型名如cc/claude-sonnet-4-20250514完成连接后续随时切换。3.3 选择模型Roo 端保存配置后从模型下拉列表中选择 9Router 提供的模型。9Router 的模型名采用前缀/模型ID的命名方式前缀即上游渠道cc/表示 Claude Code 渠道、cx/表示 Codex 渠道、glm/表示 GLM 渠道这与 claude-code.md 中 Claude Code 集成使用的命名规则一致。Claude 模型cc/模型名定位cc/claude-opus-4-5-20251101最强适合复杂任务cc/claude-sonnet-4-20250514性能与速度平衡cc/claude-haiku-4-20250514最快适合简单任务DeepSeek 模型cx/模型名定位cx/deepseek-chat通用对话与代码生成cx/deepseek-reasoner复杂推理GLM 模型glm/模型名定位glm/glm-4-plus高级通用能力glm/glm-4-flash快速响应从源码看cx/deepseek-chat与cx/deepseek-reasoner对应 DeepSeek 官方渠道的模型定义见 deepseek.js并在 capabilities.js 中标注了 128K 上下文窗口glm前缀对应智谱 GLM 渠道见 glm.js。模型列表会随 9Router 版本与套餐动态变化以上文当前仓库为准。3.4 测试连接在 Roo 聊天框中发送一条测试消息验证整条链路Hello! Can you confirm youre connected through 9Router?若收到正常回复例如确认经由 9Router 转发的响应说明集成成功。也可以在终端直接用 curl 验证 9Router 本身是否健康curl http://localhost:20128/health/api/health被 dashboardGuard.js 列为免鉴权的公开健康检查路径返回正常即代表服务在线。4. 使用示例连接成功后就可以在 Roo 中按场景选择不同模型基础聊天向 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-reasoner5. 模型选择建议快速任务使用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 模型二者在 pricing.js 中均有明确的价格配置属于低成本档位。需要说明的是9Router 的3 层降级机制订阅 → 低价 → 免费是在 9Router 侧通过 Combo 配置实现的见 README.md 的 Smart 3-Tier Fallback 示例。如果你在仪表盘为某个模型配置了 Combo 自动降级那么即使在 Roo 中固定填一个模型名上游配额用尽时 9Router 也会按 Combo 顺序自动切换Roo 无需任何额外配置。6. 故障排查连接失败确认 9Router 正在运行curl http://localhost:20128/health检查 API Key 是否与仪表盘一致确认 Base URL 末尾包含/v1后缀检查 Roo 与 9Router 之间的网络云端部署时确认https://9router.com/v1可达。模型不可用模型名必须完全匹配且区分大小写例如cc/claude-sonnet-4-20250514不能写成其他大小写形式确认当前 9Router 套餐已启用该模型尝试列表中的其他模型或刷新仪表盘模型列表。响应缓慢切换到更快模型haiku、flash 档检查本地/云端网络连接质量在 9Router 仪表盘开启调试日志Debug 模式查看请求日志与上游延迟定位是网络问题还是上游限流。7. 高级配置7.1 自定义模型别名Roo 支持为常用模型创建快捷别名减少切换成本。示例映射别名: fast → cc/claude-haiku-4-20250514 别名: smart → cc/claude-opus-4-5-20251101 别名: code → cx/deepseek-chat之后在聊天中直接用fast、smart、code即可快速指向对应模型。7.2 多个配置文件Profile为不同场景建立独立 Profile让 Roo 的默认模型、上下文注入Context/System Prompt随场景切换开发DevelopmentDeepSeek 模型cx/deepseek-chat面向编码写作WritingClaude 模型cc/claude-sonnet-4-20250514面向内容创作研究ResearchReasoner 模型cx/deepseek-reasoner面向分析与推理。7.3 配合 9Router 侧能力的进阶思路Combo 自动降级在 9Router 仪表盘创建 Combo如cc/订阅 glm/低价备份Roo 固定填主模型即可获得自动兜底RTK / Headroom 令牌压缩9Router 的 RTK 可对tool_result类上下文自动压缩节省 20–40% 令牌见 README.md 的对比示例Roo 的长任务尤其受益多账号轮询同一 Provider 配置多个账号时9Router 按轮询或优先级自动调度见 README.mdRoo 侧零感知。8. 总结Roo AI 助手通过内置的 Ollama 兼容 Provider 指向 9Router 的 OpenAI 兼容端点http://localhost:20128/v1或https://9router.com/v1即可在统一界面中使用多前缀cc/、cx/、glm/的模型并获得 9Router 的格式翻译、自动降级、配额跟踪与令牌压缩等能力。配置要点可概括为Base URL 必须带/v1、API Key 来自 9Router 仪表盘、模型名大小写敏感。下一步阅读配置 Cursor 进行 IDE 集成设置 Continue 用于 VSCode 扩展探索 CLI 用法 了解更多接入方式README.md 查看 9Router 全量功能与 Quick Start【免费下载链接】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),仅供参考
返回列表