Claude Code Router 模型路由实战从 Gemini 最小接入到按需扩展【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router你日常写代码时Agent 往往绑死在同一个模型上简单提问和架构分析用同一个上下文一长就开始吃力。Claude Code Router 是一个本地模型路由网关把各编码 Agent 的请求统一收口到一个本地地址再按你定义的规则分发到不同供应商的模型。这篇文章先用 Gemini 跑通第一个路由再讲按需要求扩展回退和观测。它是什么为什么需要一层本地模型路由本节先说清它的定位方便你判断要不要引入。Claude Code Router下文简称 CCR把 Claude Code、Codex、Kimi CLI 等 Agent 的出口统一成一个本地网关默认http://127.0.0.1:3456供应商、模型、路由规则、凭据在同一界面管理。和直连上游 API 相比差异主要在四点关注点直连上游 API经 Claude Code Router切换模型/供应商改 Agent 配置甚至重启改一条路由规则即可上游失败报错中断可重试或按顺序降级备用模型用量与成本靠供应商后台本地日志看每次请求的 token 与估算成本多 Agent 共用每个 Agent 单独配一个本地网关统一接入当你有多个 Agent、多家供应商、不同任务量级时它的价值最明显。只用一个模型、一个 Agent直连就够。最小路径4 步跑通第一个 Gemini 路由本节只写能跑起来所需的最少步骤进阶内容都在下一节。安装并启动npm CLI 要求 Node.js 22 以上也有桌面版配置流程一致npm install -g musistudio/claude-code-router ccr uiccr ui会启动浏览器管理页面默认http://127.0.0.1:3458。添加 Gemini 供应商并设默认模型打开Providers → Add Provider选择内置的 Google Gemini 预设API 地址和协议Gemini Generate Content / Interactions都已预置你只需填 API Key、勾选模型例如gemini-2.5-flash和gemini-2.5-pro。保存后到Routing页面把 Default 设为gemini, gemini-2.5-flash供应商, 模型 的格式让请求默认走快且便宜的模型。保存时可用检测连通性发一次真实请求验证 Key 和模型 ID 是否可用注意检测会消耗 token。让 Agent 指向网关打开Server点启动模型网关开始监听http://127.0.0.1:3456确认服务存活curl http://127.0.0.1:3456/health最后在Agent Config里选你的 Agent如 Claude Code选一个模型并应用配置Agent 的 API 地址就会指向本地网关。之后换模型、换供应商都不用再动 Agent 配置。按需扩展3 个可以跳读的能力本节拆成三个独立模块按需要求选读即可。按条件改写目标模型这个模块解决不同请求走不同模型。Routing页面的规则列表支持条件规则对request.header或request.body字段做、starts with、contains deep等匹配命中后把request.body.model改写成目标供应商/模型。单个条件不够用时把规则类型切成Node.js 脚本脚本能读到完整请求含 token 数估算// 长上下文走 pro其余交给下一条规则 if (input.tokenCount 60000) { return { model: gemini/gemini-2.5-pro }; } return null;return null表示不命中、继续匹配下一条。规则按列表顺序生效上移下移即可调优先级字段细节见路由文档。失败自动回退这个模块解决上游抖动时请求别中断。路由页顶部的默认失败处理有两种模式继续重试408/409/429/5xx 时重试当前模型和失败降级目标任意 4xx/5xx 失败后按顺序切换备用模型。每条规则还能单独设失败时策略适合给高成本模型配专属兜底。每次重试前 CCR 会做指数退避上游返回 Retry-After 时优先遵守。用日志验证路由结果这个模块解决到底有没有路由到预期模型。Logs里每条请求都有request model客户端原始请求和resolved provider、resolved model最终命中以及状态码、token、延迟发生回退时还会记录重试尝试列表。总览页汇总请求数、token 用量和估算成本核对月度开销很方便。排错速查常见现象与解法本节把高频问题整理成现象 → 原因 → 解法短条目照着排。网关无响应或 /health 返回 502→ 模型网关未启动。至少添加一个供应商和模型再到Server点启动管理 UI 能打开不代表网关在跑。401 / Key 无效→ Key 与 API 地址不匹配。回供应商页核对 API Key用检测连通性定位。路由规则不生效→ 目标模型不在已配置列表或条件过窄比如用了不存在的数组下标。核对规则顺序和日志里的resolved model嵌套数组建议用contains deep。怀疑请求被错误改写→ 打开Logs详情看实际请求响应或在 DevTools 里查 Agent 发出的内容收尾上线前记住两件事CCR 的配置存在本地 SQLiteLinux/macOS 为~/.claude-code-router/config.sqlite建议在Settings里导出备份不要在运行中手改数据库。如果要把网关暴露到本机之外把 Host 改为0.0.0.0创建 CCR 客户端 API Key 收口访问并配合 TLS 与防火墙细节见服务配置文档。到这里一个本地网关加一套路由规则Gemini 就在你的编码工作流里随时可切、可回退、可观测了。【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Claude Code Router 模型路由实战：从 Gemini 最小接入到按需扩展
Claude Code Router 模型路由实战从 Gemini 最小接入到按需扩展【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router你日常写代码时Agent 往往绑死在同一个模型上简单提问和架构分析用同一个上下文一长就开始吃力。Claude Code Router 是一个本地模型路由网关把各编码 Agent 的请求统一收口到一个本地地址再按你定义的规则分发到不同供应商的模型。这篇文章先用 Gemini 跑通第一个路由再讲按需要求扩展回退和观测。它是什么为什么需要一层本地模型路由本节先说清它的定位方便你判断要不要引入。Claude Code Router下文简称 CCR把 Claude Code、Codex、Kimi CLI 等 Agent 的出口统一成一个本地网关默认http://127.0.0.1:3456供应商、模型、路由规则、凭据在同一界面管理。和直连上游 API 相比差异主要在四点关注点直连上游 API经 Claude Code Router切换模型/供应商改 Agent 配置甚至重启改一条路由规则即可上游失败报错中断可重试或按顺序降级备用模型用量与成本靠供应商后台本地日志看每次请求的 token 与估算成本多 Agent 共用每个 Agent 单独配一个本地网关统一接入当你有多个 Agent、多家供应商、不同任务量级时它的价值最明显。只用一个模型、一个 Agent直连就够。最小路径4 步跑通第一个 Gemini 路由本节只写能跑起来所需的最少步骤进阶内容都在下一节。安装并启动npm CLI 要求 Node.js 22 以上也有桌面版配置流程一致npm install -g musistudio/claude-code-router ccr uiccr ui会启动浏览器管理页面默认http://127.0.0.1:3458。添加 Gemini 供应商并设默认模型打开Providers → Add Provider选择内置的 Google Gemini 预设API 地址和协议Gemini Generate Content / Interactions都已预置你只需填 API Key、勾选模型例如gemini-2.5-flash和gemini-2.5-pro。保存后到Routing页面把 Default 设为gemini, gemini-2.5-flash供应商, 模型 的格式让请求默认走快且便宜的模型。保存时可用检测连通性发一次真实请求验证 Key 和模型 ID 是否可用注意检测会消耗 token。让 Agent 指向网关打开Server点启动模型网关开始监听http://127.0.0.1:3456确认服务存活curl http://127.0.0.1:3456/health最后在Agent Config里选你的 Agent如 Claude Code选一个模型并应用配置Agent 的 API 地址就会指向本地网关。之后换模型、换供应商都不用再动 Agent 配置。按需扩展3 个可以跳读的能力本节拆成三个独立模块按需要求选读即可。按条件改写目标模型这个模块解决不同请求走不同模型。Routing页面的规则列表支持条件规则对request.header或request.body字段做、starts with、contains deep等匹配命中后把request.body.model改写成目标供应商/模型。单个条件不够用时把规则类型切成Node.js 脚本脚本能读到完整请求含 token 数估算// 长上下文走 pro其余交给下一条规则 if (input.tokenCount 60000) { return { model: gemini/gemini-2.5-pro }; } return null;return null表示不命中、继续匹配下一条。规则按列表顺序生效上移下移即可调优先级字段细节见路由文档。失败自动回退这个模块解决上游抖动时请求别中断。路由页顶部的默认失败处理有两种模式继续重试408/409/429/5xx 时重试当前模型和失败降级目标任意 4xx/5xx 失败后按顺序切换备用模型。每条规则还能单独设失败时策略适合给高成本模型配专属兜底。每次重试前 CCR 会做指数退避上游返回 Retry-After 时优先遵守。用日志验证路由结果这个模块解决到底有没有路由到预期模型。Logs里每条请求都有request model客户端原始请求和resolved provider、resolved model最终命中以及状态码、token、延迟发生回退时还会记录重试尝试列表。总览页汇总请求数、token 用量和估算成本核对月度开销很方便。排错速查常见现象与解法本节把高频问题整理成现象 → 原因 → 解法短条目照着排。网关无响应或 /health 返回 502→ 模型网关未启动。至少添加一个供应商和模型再到Server点启动管理 UI 能打开不代表网关在跑。401 / Key 无效→ Key 与 API 地址不匹配。回供应商页核对 API Key用检测连通性定位。路由规则不生效→ 目标模型不在已配置列表或条件过窄比如用了不存在的数组下标。核对规则顺序和日志里的resolved model嵌套数组建议用contains deep。怀疑请求被错误改写→ 打开Logs详情看实际请求响应或在 DevTools 里查 Agent 发出的内容收尾上线前记住两件事CCR 的配置存在本地 SQLiteLinux/macOS 为~/.claude-code-router/config.sqlite建议在Settings里导出备份不要在运行中手改数据库。如果要把网关暴露到本机之外把 Host 改为0.0.0.0创建 CCR 客户端 API Key 收口访问并配合 TLS 与防火墙细节见服务配置文档。到这里一个本地网关加一套路由规则Gemini 就在你的编码工作流里随时可切、可回退、可观测了。【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考