9Router 集成 Cline在 VSCode 中通过智能路由网关使用免费 AI 模型的完整配置指南【免费下载链接】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 项目官方集成指南的中文深度版本面向使用 Cline VSCode 扩展的开发者。你将学会如何把 Cline 的 AI 请求全部转发到 9Router 网关借助 9Router 的模型路由、提供商回退与用量跟踪能力在 Cline 中直接使用 40 上游提供商托管的 GPT、Claude、Gemini 等模型。读完本文你不仅能独立完成从 Cline 设置到故障排查的全流程配置还能从源码层面理解请求在网关内的真实处理链路。前置要求开始集成前请确保满足以下条件已安装 Visual Studio Code已从 VSCode 市场安装 Cline 扩展9Router 已在本地运行或已配置好云端 endpoint已从 9Router 仪表盘获取 API key其中 9Router 的默认运行端口为20128仪表盘位于/dashboardAPI 位于/v1见 CLAUDE.md。你可以用下面的命令验证本地实例是否健康curl http://localhost:20128/health该健康检查端点位于 src/app/api/health/route.js正常时会返回{ ok: true }。在 Cline 中配置 9Router整个配置过程只需六步核心思路是利用 Cline 对 OpenAI 风格 API 的兼容能力把它的 API Provider 指向 9Router 的/v1端点。1. 打开 Cline 设置打开 Visual Studio Code点击侧边栏的 Cline 图标打开 Cline 扩展面板点击 Cline 面板中的Settings齿轮图标2. 选择 API Provider在 Cline 设置中找到API Provider下拉菜单从列表中选择Ollama说明选择 Ollama provider 类型是因为它与 OpenAI 风格 API 兼容而 9Router 对外暴露的正是 OpenAI 兼容端点/v1/chat/completions因此可以无缝对接3. 配置 Base URL将 base URL 设为你的 9Router endpoint本地 9Routerhttp://localhost:20128/v1云端 9Routerhttps://9router.com步骤在Base URL字段中输入你的 9Router endpoint末尾必须包含/v1/v1前缀不是可选项。9Router 的 OpenAI 兼容路由全部挂载在该路径之下例如聊天补全端点 src/app/api/v1/chat/completions/route.js 接收并处理来自客户端的 POST 请求将其交给 src/sse/handlers/chat.js 中的handleChat完成格式检测、鉴权与上游转发。4. 添加 API Key在API Key字段中输入你的 9Router API key可在 9Router 仪表盘Settings → API Keys中找到 API keykey 应以sk-9router-开头关于 API key 的校验机制网关在 src/sse/handlers/chat.js 中通过extractApiKey从请求头提取 key并在设置开启requireApiKey时调用isValidApiKey校验。key 无效或缺失时网关会返回401 Unauthorized响应这与 Cline 中出现的 Invalid API Key 错误直接对应。5. 选择模型在Model下拉菜单中可以从可用模型中选择若 Cline 自动检测或手动输入 9Router 配置中的模型名常见模型名gpt-4gpt-4oclaude-opus-4-5claude-sonnet-4-5gemini-2.0-flash关于自动检测9Router 提供了/v1/models端点见 src/app/api/v1/models/route.js它会聚合你已配置的提供商连接、Combo、自定义模型与模型别名并针对 Kiro、Qoder、Kimchi、GitHub Copilot、Cline Pass、Grok CLI 等提供商动态拉取实时模型目录。若 Cline 未能自动列出模型直接手动输入与 9Router 配置完全一致的模型名即可。6. 保存配置点击Save或关闭设置面板。Cline 会自动保存你的配置。配置示例配置完成后你的 Cline 设置应如下所示API Provider: Ollama Base URL: http://localhost:20128/v1 API Key: sk-9router-xxxxxxxxxxxxx Model: gpt-4将其中的 API Key 替换为你自己在仪表盘生成的真实 key 即可直接使用。可用模型你可以使用 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 配置完全一致包括大小写与符号否则会触发 Model Not Found 错误如果模型名带提供商前缀如openai/gpt-4在 Cline 中同样按完整名称填写日常使用场景配置完成后Cline 与 9Router 的协作是透明的——你无需感知请求被转发到了哪家上游。与 AI 对话在 VSCode 中打开 Cline 面板在聊天输入框中输入消息按 Enter 发送Cline 会通过 9Router 处理你的请求生成代码让 Cline 生成代码创建一个登录表单的 React 组件Cline 会通过 9Router 生成代码检查并接受生成的代码代码解释在编辑器中选中代码让 Cline解释这段代码通过 9Router 获得 AI 驱动的解释文件操作让 Cline 创建、修改或删除文件Cline 会通过 9Router 理解上下文并进行修改在接受前检查变更故障排除Connection Failed 错误确认 9Router 正在运行curl http://localhost:20128/health确认 base URL 正确且包含/v1确保防火墙没有阻止 20128 端口尝试重启 VSCodeInvalid API Key 错误在 9Router 仪表盘中确认 API key确保复制了包含sk-9router-前缀在内的完整 key检查 API key 是否过期尝试重新生成 API key从源码层面看该错误通常意味着网关在 src/sse/handlers/chat.js 的鉴权环节拒绝了请求要么请求头没有携带 key要么 key 未通过isValidApiKey校验网关会返回401状态码。Model Not Found 错误确认模型名与 9Router 配置完全一致检查 9Router 仪表盘中提供商连接是否激活确认连接的提供商中包含该模型尝试使用完整模型名例如用openai/gpt-4代替gpt-4模型解析是请求处理的第一个关键环节。src/sse/handlers/chat.js 会在缺少model字段时直接返回400 Bad Request而 Combo多模型组合的判断发生在模型路由之前——getComboModels(modelStr)会先检查该模型名是否命中了仪表盘中配置的 Combo 组合命中则进入 Combo 特有的回退或融合策略见 open-sse/services/combo.js。Cline 无响应查看 Cline 输出面板中的错误信息确认 9Router 实例正在运行且健康重新加载 VSCode 窗口Cmd/Ctrl Shift P → Reload Window检查 9Router 日志是否有错误高级配置使用云端 Endpoint使用 9Router 云端 endpoint 而非 localhost在 Cline 设置中将 Base URL 设为https://9router.com确保已在 9Router 云端仪表盘中配置 API key确保云端 endpoint 已激活且可访问适用场景包括本地实例未常驻运行、多台机器共享同一网关或希望借助云端代理规避本地网络限制。多个模型可以快速切换模型打开 Cline 设置将Model字段改为另一个模型保存并继续使用新模型对话这一能力与 9Router 的 Combo 机制可以叠加使用即使 Cline 中只填了一个模型名只要该名字在 9Router 中配置为多模型 Combo网关也会自动执行回退或融合调度客户端完全无感。自定义超时如果大请求出现超时打开 VSCode 设置Cmd/Ctrl ,搜索 Cline timeout提高超时值默认通常为 30 秒对于长上下文、大代码库或流式生成任务适当调高超时能减少中途断连的概率。最佳实践使用合适的模型简单任务用更快的模型如 Haiku 或 Flash复杂任务用更强的模型如 Opus 或 GPT-4监控使用在 9Router 仪表盘查看用量统计和成本管理上下文保持对话聚焦以减少 token 用量切换模型根据任务复杂度切换模型优化成本和性能API Key 安全绝不将 API key 提交到版本控制深入 9Router 的路由与回退机制Cline 只是 9Router 的一个客户端入口真正的价值在于网关内部的路由决策。以下是文档所述功能对应的源码实现便于你理解请求被转发后发生了什么。模型路由9Router 会根据以下因素自动将请求路由到最佳提供商模型可用性提供商健康状态成本优化负载均衡从源码结构看路由决策分布在 src/sse/handlers/chat.js 与 open-sse/handlers/chatCore.js 中请求进入后先做格式探测OpenAI、Claude、Gemini、Responses API 等再由handleChatCore依据模型名、提供商连接状态与能力配置见 open-sse/providers/capabilities.js选择具体上游并完成协议翻译。回退支持某个提供商失败时9Router 会自动回退到仪表盘中配置的备用提供商。回退并非随机切换而是由错误规则驱动的智能降级。在 open-sse/config/errorConfig.js 中定义了一组规则429rate limit exceeded与包含 quota exceeded 文本的错误会触发指数退避退避冷却时间由 open-sse/services/accountFallback.js 中的getQuotaCooldown计算基础值按 2 的幂次递增最高封顶其余错误则进入短暂冷却后切换下一个可用账户。对用户而言一次失败的请求会自动重试到健康的上游这正是永不触顶体验的来源。使用跟踪通过 9Router 仪表盘监控你的 Cline 使用请求总数Token 使用每个模型的成本提供商分布对应的数据层位于 src/lib/usageDb.js本地用量持久化与 open-sse/services/usage.js用量统计逻辑仪表盘侧则有 src/app/api/usage/route.js 及stats、chart、request-details等子端点提供明细查询。你可以据此观察 Cline 产生的请求被哪些提供商承接、各模型消耗了多少 token从而持续优化模型选择策略。结语通过本文的六步配置Cline 已经接入 9Router 的智能路由体系。后续你只需在仪表盘中增删提供商连接或调整模型组合Cline 无需改动即可获得新的模型能力与更稳健的回退保障。相关的英文版集成指南见 gitbook/content/en/integration/cline.md其他客户端如 Cursor的配置差异可参考 gitbook/content/zh-CN/integration/cursor.md。【免费下载链接】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），仅供参考 9Router 集成 Cline：在 VSCode 中通过智能路由网关使用免费 AI 模型的完整配置指南
9Router 集成 Cline在 VSCode 中通过智能路由网关使用免费 AI 模型的完整配置指南【免费下载链接】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 项目官方集成指南的中文深度版本面向使用 Cline VSCode 扩展的开发者。你将学会如何把 Cline 的 AI 请求全部转发到 9Router 网关借助 9Router 的模型路由、提供商回退与用量跟踪能力在 Cline 中直接使用 40 上游提供商托管的 GPT、Claude、Gemini 等模型。读完本文你不仅能独立完成从 Cline 设置到故障排查的全流程配置还能从源码层面理解请求在网关内的真实处理链路。前置要求开始集成前请确保满足以下条件已安装 Visual Studio Code已从 VSCode 市场安装 Cline 扩展9Router 已在本地运行或已配置好云端 endpoint已从 9Router 仪表盘获取 API key其中 9Router 的默认运行端口为20128仪表盘位于/dashboardAPI 位于/v1见 CLAUDE.md。你可以用下面的命令验证本地实例是否健康curl http://localhost:20128/health该健康检查端点位于 src/app/api/health/route.js正常时会返回{ ok: true }。在 Cline 中配置 9Router整个配置过程只需六步核心思路是利用 Cline 对 OpenAI 风格 API 的兼容能力把它的 API Provider 指向 9Router 的/v1端点。1. 打开 Cline 设置打开 Visual Studio Code点击侧边栏的 Cline 图标打开 Cline 扩展面板点击 Cline 面板中的Settings齿轮图标2. 选择 API Provider在 Cline 设置中找到API Provider下拉菜单从列表中选择Ollama说明选择 Ollama provider 类型是因为它与 OpenAI 风格 API 兼容而 9Router 对外暴露的正是 OpenAI 兼容端点/v1/chat/completions因此可以无缝对接3. 配置 Base URL将 base URL 设为你的 9Router endpoint本地 9Routerhttp://localhost:20128/v1云端 9Routerhttps://9router.com步骤在Base URL字段中输入你的 9Router endpoint末尾必须包含/v1/v1前缀不是可选项。9Router 的 OpenAI 兼容路由全部挂载在该路径之下例如聊天补全端点 src/app/api/v1/chat/completions/route.js 接收并处理来自客户端的 POST 请求将其交给 src/sse/handlers/chat.js 中的handleChat完成格式检测、鉴权与上游转发。4. 添加 API Key在API Key字段中输入你的 9Router API key可在 9Router 仪表盘Settings → API Keys中找到 API keykey 应以sk-9router-开头关于 API key 的校验机制网关在 src/sse/handlers/chat.js 中通过extractApiKey从请求头提取 key并在设置开启requireApiKey时调用isValidApiKey校验。key 无效或缺失时网关会返回401 Unauthorized响应这与 Cline 中出现的 Invalid API Key 错误直接对应。5. 选择模型在Model下拉菜单中可以从可用模型中选择若 Cline 自动检测或手动输入 9Router 配置中的模型名常见模型名gpt-4gpt-4oclaude-opus-4-5claude-sonnet-4-5gemini-2.0-flash关于自动检测9Router 提供了/v1/models端点见 src/app/api/v1/models/route.js它会聚合你已配置的提供商连接、Combo、自定义模型与模型别名并针对 Kiro、Qoder、Kimchi、GitHub Copilot、Cline Pass、Grok CLI 等提供商动态拉取实时模型目录。若 Cline 未能自动列出模型直接手动输入与 9Router 配置完全一致的模型名即可。6. 保存配置点击Save或关闭设置面板。Cline 会自动保存你的配置。配置示例配置完成后你的 Cline 设置应如下所示API Provider: Ollama Base URL: http://localhost:20128/v1 API Key: sk-9router-xxxxxxxxxxxxx Model: gpt-4将其中的 API Key 替换为你自己在仪表盘生成的真实 key 即可直接使用。可用模型你可以使用 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 配置完全一致包括大小写与符号否则会触发 Model Not Found 错误如果模型名带提供商前缀如openai/gpt-4在 Cline 中同样按完整名称填写日常使用场景配置完成后Cline 与 9Router 的协作是透明的——你无需感知请求被转发到了哪家上游。与 AI 对话在 VSCode 中打开 Cline 面板在聊天输入框中输入消息按 Enter 发送Cline 会通过 9Router 处理你的请求生成代码让 Cline 生成代码创建一个登录表单的 React 组件Cline 会通过 9Router 生成代码检查并接受生成的代码代码解释在编辑器中选中代码让 Cline解释这段代码通过 9Router 获得 AI 驱动的解释文件操作让 Cline 创建、修改或删除文件Cline 会通过 9Router 理解上下文并进行修改在接受前检查变更故障排除Connection Failed 错误确认 9Router 正在运行curl http://localhost:20128/health确认 base URL 正确且包含/v1确保防火墙没有阻止 20128 端口尝试重启 VSCodeInvalid API Key 错误在 9Router 仪表盘中确认 API key确保复制了包含sk-9router-前缀在内的完整 key检查 API key 是否过期尝试重新生成 API key从源码层面看该错误通常意味着网关在 src/sse/handlers/chat.js 的鉴权环节拒绝了请求要么请求头没有携带 key要么 key 未通过isValidApiKey校验网关会返回401状态码。Model Not Found 错误确认模型名与 9Router 配置完全一致检查 9Router 仪表盘中提供商连接是否激活确认连接的提供商中包含该模型尝试使用完整模型名例如用openai/gpt-4代替gpt-4模型解析是请求处理的第一个关键环节。src/sse/handlers/chat.js 会在缺少model字段时直接返回400 Bad Request而 Combo多模型组合的判断发生在模型路由之前——getComboModels(modelStr)会先检查该模型名是否命中了仪表盘中配置的 Combo 组合命中则进入 Combo 特有的回退或融合策略见 open-sse/services/combo.js。Cline 无响应查看 Cline 输出面板中的错误信息确认 9Router 实例正在运行且健康重新加载 VSCode 窗口Cmd/Ctrl Shift P → Reload Window检查 9Router 日志是否有错误高级配置使用云端 Endpoint使用 9Router 云端 endpoint 而非 localhost在 Cline 设置中将 Base URL 设为https://9router.com确保已在 9Router 云端仪表盘中配置 API key确保云端 endpoint 已激活且可访问适用场景包括本地实例未常驻运行、多台机器共享同一网关或希望借助云端代理规避本地网络限制。多个模型可以快速切换模型打开 Cline 设置将Model字段改为另一个模型保存并继续使用新模型对话这一能力与 9Router 的 Combo 机制可以叠加使用即使 Cline 中只填了一个模型名只要该名字在 9Router 中配置为多模型 Combo网关也会自动执行回退或融合调度客户端完全无感。自定义超时如果大请求出现超时打开 VSCode 设置Cmd/Ctrl ,搜索 Cline timeout提高超时值默认通常为 30 秒对于长上下文、大代码库或流式生成任务适当调高超时能减少中途断连的概率。最佳实践使用合适的模型简单任务用更快的模型如 Haiku 或 Flash复杂任务用更强的模型如 Opus 或 GPT-4监控使用在 9Router 仪表盘查看用量统计和成本管理上下文保持对话聚焦以减少 token 用量切换模型根据任务复杂度切换模型优化成本和性能API Key 安全绝不将 API key 提交到版本控制深入 9Router 的路由与回退机制Cline 只是 9Router 的一个客户端入口真正的价值在于网关内部的路由决策。以下是文档所述功能对应的源码实现便于你理解请求被转发后发生了什么。模型路由9Router 会根据以下因素自动将请求路由到最佳提供商模型可用性提供商健康状态成本优化负载均衡从源码结构看路由决策分布在 src/sse/handlers/chat.js 与 open-sse/handlers/chatCore.js 中请求进入后先做格式探测OpenAI、Claude、Gemini、Responses API 等再由handleChatCore依据模型名、提供商连接状态与能力配置见 open-sse/providers/capabilities.js选择具体上游并完成协议翻译。回退支持某个提供商失败时9Router 会自动回退到仪表盘中配置的备用提供商。回退并非随机切换而是由错误规则驱动的智能降级。在 open-sse/config/errorConfig.js 中定义了一组规则429rate limit exceeded与包含 quota exceeded 文本的错误会触发指数退避退避冷却时间由 open-sse/services/accountFallback.js 中的getQuotaCooldown计算基础值按 2 的幂次递增最高封顶其余错误则进入短暂冷却后切换下一个可用账户。对用户而言一次失败的请求会自动重试到健康的上游这正是永不触顶体验的来源。使用跟踪通过 9Router 仪表盘监控你的 Cline 使用请求总数Token 使用每个模型的成本提供商分布对应的数据层位于 src/lib/usageDb.js本地用量持久化与 open-sse/services/usage.js用量统计逻辑仪表盘侧则有 src/app/api/usage/route.js 及stats、chart、request-details等子端点提供明细查询。你可以据此观察 Cline 产生的请求被哪些提供商承接、各模型消耗了多少 token从而持续优化模型选择策略。结语通过本文的六步配置Cline 已经接入 9Router 的智能路由体系。后续你只需在仪表盘中增删提供商连接或调整模型组合Cline 无需改动即可获得新的模型能力与更稳健的回退保障。相关的英文版集成指南见 gitbook/content/en/integration/cline.md其他客户端如 Cursor的配置差异可参考 gitbook/content/zh-CN/integration/cursor.md。【免费下载链接】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），仅供参考