9Router 集成 Cline：在 VSCode 中通过 Ollama Provider 接入智能路由网关的完整指南

9Router 集成 Cline在 VSCode 中通过 Ollama Provider 接入智能路由网关的完整指南【免费下载链接】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/9routerCline 是 VSCode 生态中最受欢迎的 AI 编码助手扩展之一而 9Router 是一个位于你与各大 AI 提供商之间的智能路由网关它对外暴露 OpenAI 兼容的/v1接口对内负责模型路由、自动回退fallback、token 优化与用量统计。本指南基于仓库文档 gitbook/content/es/integration/cline.md及其英文/中文对照版本编写完整覆盖 Cline 的接入配置、日常使用、故障排查与高级调优并深入源码验证每一处关键行为。读完本文你将能在一分钟内把 Cline 的请求全部经由 9Router 转发享受多提供商自动切换、配额用尽自动回退等能力。为什么用 Ollama Provider 类型在 Cline 的API Provider下拉菜单中本文档推荐选择Ollama。原因在于Ollama 是 Cline 内置支持的一种 OpenAI 风格 API 接入方式而 9Router 对外暴露的正是 OpenAI 兼容的 REST 接口默认路径http://localhost:20128/v1二者协议天然对齐无需 Cline 官方并未提供的专用 9Router 选项。9Router 的协议兼容性在源码中也有印证它内部实现了格式翻译层见 open-sse/translator/index.js负责在 OpenAI 与 Claude 等不同格式之间互相转换因此任何支持 OpenAI 风格 API 的客户端Claude Code、Codex、Cursor、Cline、Continue 等都可以通过同一端点接入。前置要求在开始配置前请确认以下条件已满足已安装Visual Studio Code已从 VSCode Marketplace 安装Cline 扩展9Router 正在本机运行或已配置可用的云端 endpoint已从 9Router 仪表盘获得API key。9Router 本机启动方式可参考 README.md 的 Quick Startnpm install -g 9router 9router或从源码运行PORT20128 NEXT_PUBLIC_BASE_URLhttp://localhost:20128 npm run dev。默认服务端口为20128这一点在 CLAUDE.md 中有明确说明仪表盘位于/dashboardOpenAI 兼容 API 位于/v1。六步完成 Cline 配置1. 打开 Cline 设置启动 Visual Studio Code点击侧边栏中的 Cline 图标打开 Cline 扩展面板点击面板顶部的Settings齿轮图标进入配置界面。2. 选择 API Provider在设置中找到API Provider下拉菜单从列表中选择Ollama。3. 配置 Base URL将 Base URL 指向你的 9Router endpoint本地 9Routerhttp://localhost:20128/v1云端 9Routerhttps://9router.com步骤要点在Base URL字段填入上述端点后务必确认末尾包含/v1。因为 Cline 请求/chat/completions、/models等路径时9Router 的路由是挂载在/v1前缀下的参见 README.md 中 “OpenAI-compatible API:http://localhost:20128/v1” 的说明。4. 添加 API Key在API Key字段填入 9Router 的 API keykey 可以在 9Router 仪表盘的Settings → API Keys中生成或查看9Router 签发的 key 以sk-9router-前缀开头粘贴时请确保复制完整。5. 选择模型在Model下拉菜单中你可以从 Cline 自动检测到的可用模型中直接选择手动输入 9Router 配置中定义的模型名。文档中给出的常见模型名示例gpt-4gpt-4oclaude-opus-4-5claude-sonnet-4-5gemini-2.0-flash需要说明的是这些只是示例名称实际可用的模型以你在 9Router 仪表盘中连接并启用的提供商为准。9Router 的模型别名与路由逻辑位于 open-sse/services/model.js它会解析模型名并决定转发到哪个提供商因此理论上你 dashboard 中配置的任何模型都能在 Cline 中使用。6. 保存配置点击Save或直接关闭设置面板。Cline 会自动保存配置无需重启。配置示例完成上述步骤后你的 Cline 设置应形如下方所示API Provider: Ollama Base URL: http://localhost:20128/v1 API Key: sk-9router-xxxxxxxxxxxxx Model: gpt-4可用模型你可以使用 9Router 仪表盘中配置的任意模型。文档给出的常见示例与说明如下模型名提供商说明gpt-4OpenAIGPT-4 Turbogpt-4oOpenAIGPT-4 Optimizedclaude-opus-4-5AnthropicClaude Opus 4.5claude-sonnet-4-5AnthropicClaude Sonnet 4.5gemini-2.0-flashGoogleGemini 2.0 Flash注上表内容直接继承自原文档。实际运行时请以 9Router 仪表盘Providers页面中已连接提供商与其最新模型列表为准避免使用已下线或未接入的模型名下文“Model Not Found”一节会给出对应处理方法。日常使用场景与 AI 对话在 VSCode 中打开 Cline 面板在聊天输入框输入消息按 Enter 发送Cline 会将请求发往 9Router 的/v1端点由 9Router 完成路由与转发。生成代码让 Cline 生成代码例如Create a React component for a login formCline 通过 9Router 将任务交给后端模型执行检查生成结果并接受或调整。解释代码在编辑器中选中一段代码向 Cline 提问Explain this code通过 9Router 获得基于所选模型的解释。文件操作让 Cline 创建、修改或删除文件Cline 会把文件上下文一并经由 9Router 发送以获得更贴合项目的修改建议在接受变更前仔细 review diff。故障排查Connection Failed 错误确认 9Router 正在运行执行curl http://localhost:20128/health应返回健康状态检查 Base URL 是否正确且包含/v1确认防火墙没有拦截 20128 端口尝试重启 VSCode。健康检查这一行为在源码中同样存在9Router 的 API 层在 src/dashboardGuard.js 中纳入了/api/health作为公开端点网关自身的连通性探针也会探测/health或/api/health见 src/lib/tunnel/cloudflare/healthCheck.js。Invalid API Key 错误到 9Router 仪表盘核对 API key 是否有效确认复制的是包含sk-9router-前缀在内的完整 key检查 key 是否已过期或被撤销必要时在仪表盘重新生成一个新 key 并更新到 Cline。Model Not Found 错误确认模型名与 9Router 配置中的名称完全一致区分大小写检查 9Router 仪表盘中对应提供商连接是否处于激活状态确认该模型确实存在于你已连接的提供商中尝试使用完整模型名例如用openai/gpt-4代替gpt-4——9Router 支持带提供商前缀的模型别名解析见 open-sse/services/model.js 与 open-sse/config/providerModels.js。Cline 无响应打开 Cline 的 Output 面板查看错误消息确认 9Router 实例仍在运行且健康通过Cmd/Ctrl Shift P → Reload Window重载 VSCode 窗口查看 9Router 侧的运行日志定位转发环节是否出错。高级配置使用云端 Endpoint若你的 9Router 部署在云端而非本机在 Cline 设置中将 Base URL 改为https://9router.com确保已在云端仪表盘中生成并配置 API key确认云端 endpoint 处于活跃且可达状态。多模型快速切换打开 Cline 设置将Model字段改为另一个模型名保存后即可继续对话无需重建会话。自定义请求超时面对大上下文或长生成请求时可能出现超时打开 VSCode 设置Cmd/Ctrl ,搜索 Cline timeout调大超时阈值Cline 默认通常为 30 秒左右。最佳实践按任务选择模型简单任务用响应更快的模型如 Haiku、Flash 系列复杂任务用能力更强的模型如 Opus、GPT-4 系列监控用量定期查看 9Router 仪表盘中的用量统计与成本数据管理上下文保持对话聚焦控制上下文长度以减少 token 消耗动态切换模型根据任务复杂度灵活切换在成本与效果间取得平衡保护 API Key切勿将sk-9router-开头的 key 提交进版本控制或分享给他人。深入Cline 请求在 9Router 内部如何被处理理解 Cline 接入之后值得看看请求进入 9Router 后的流转链路这能帮助你更好地利用它的核心能力。模型路由与三层回退9Router 会把请求路由到当前可用的最佳提供商决策因素包括模型可用性、提供商健康状态、成本优化与负载均衡。回退链路采用分层结构详见 README.md 的架构图Tier 1: SUBSCRIPTION订阅 → Tier 2: CHEAP廉价 → Tier 3: FREE免费当上层配额耗尽或出错时自动降级到下一层实现“零停机”的连续编码体验。回退判定逻辑在源码中有非常具体的实现checkFallbackError位于 open-sse/services/accountFallback.js会依据 open-sse/config/errorConfig.js 中的规则逐条匹配错误文本与 HTTP 状态码命中 429 等限流错误时还会按指数退避策略计算冷却时间Level 1: 1s、Level 2: 2s、Level 3: 4s……封顶 4 分钟并在冷却期内将该账号标记为不可用isAccountUnavailable把流量切换到下一个可用账号或提供商。多账号轮询对同一提供商配置了多个账号时9Router 会按账号轮询round-robin分配请求最大化每个账号的可用额度。相关账号可用性筛选逻辑同样在 open-sse/services/accountFallback.js 的filterAvailableAccounts中实现。用量跟踪每次经 9Router 转发的 Cline 请求都会被记录。仓库中 src/lib/db/repos/usageRepo.js 维护了usageHistory表字段涵盖时间戳、提供商、模型、connectionId、apiKey、endpoint、promptTokens、completionTokens、cost 与 status迁移脚本见 src/lib/db/migrate.js。你可以在 9Router 仪表盘看到请求总数Token 使用量每个模型的成本各提供商的用量分布。关于 Cline 这一提供商值得一提的是除了把 Cline 当作客户端接入 9Router 外仓库还在 open-sse/providers/registry/cline.js 中将 Cline 注册为一个 OAuth 类提供商priority 80别名cl即 9Router 也可以反向接入 Cline 官方 API 作为上游并支持 token 刷新等能力。这与本文的“Cline 作为客户端连接 9Router”是互补的两个方向供有需要的读者进一步探索。小结将 Cline 指向http://localhost:20128/v1或云端 endpoint选择 Ollama Provider 类型并填入sk-9router-开头的 API key即可让 Cline 完全工作在 9Router 的智能路由之上。无论是多模型自由切换、订阅→廉价→免费三层自动回退还是 token 用量与成本的细粒度追踪都无需在 Cline 侧做任何额外开发。若你在配置过程中遇到连接失败、key 无效或模型不存在等问题可直接对照本文故障排查章节逐步定位。【免费下载链接】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），仅供参考