CCR 智能路由Gemini 接入的 4 个关键动作【免费下载链接】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-routerClaude Code Router下文简称 CCR是一个运行在本地的模型路由网关把 Gemini 等多个供应商的模型接到同一个入口让编程 Agent 按请求内容自动选择模型。这篇文章按一次真实配置过程的顺序讲清把 Google Gemini 系列接进来之后路由规则怎么写、成本怎么控、结果怎么验证。先跑起来安装 CCR 并确认本地网关CCR 的 npm CLI 要求 Node.js 22 及以上版本。全局安装后运行ccr ui本机就会启动模型网关和浏览器管理界面npm install -g musistudio/claude-code-router ccr ui模型网关默认监听127.0.0.1:3456管理界面在127.0.0.1:3458。后续的供应商、模型和路由配置都在管理界面里完成命令行只负责启动。把 Agent 的请求地址指向 3456 端口链路就算通了。 接入第一个模型Gemini 预设、密钥与连通性在供应商页选择内置预设Google Gemini填入在 Google AI Studio 申请的 API 密钥通常以AIza开头再勾选模型。Gemini 系列建议至少留两个gemini-2.5-flash响应快、单价低gemini-2.5-pro推理能力更强但更贵探测不到的模型 ID 可以用自定义模型手动补上。保存后每个模型在路由里都以供应商/模型的形式出现例如gemini/gemini-2.5-flash。点检测连通性会向所选模型发一次真实请求用来验证密钥、协议和模型名注意它会计费只勾选需要确认的模型即可。字段含义见 供应商配置文档。 把路由调顺用条件规则改写目标模型CCR 的路由页维护一个规则列表请求进来后按列表顺序匹配第一条命中的启用规则生效。最常用的写法是给规则配一个条件然后把request.body.model设置成目标模型。日常请求和长请求的分工可以用一条 Node.js 脚本规则表达脚本能读到 CCR 估算的input.tokenCountif (input.tokenCount 40000) { return { model: gemini/gemini-2.5-pro }; } return { model: gemini/gemini-2.5-flash };脚本在独立 Worker 里执行返回null表示本条规则不命中、继续检查下一条。除了 token 数脚本还能读到最后一条用户消息、是否带图片等字段按关键词或任务类型分流都够用。如果客户端如 Claude Code没有显式选模型Claude Code 内置路由会直接采用 Agent 配置里设的默认模型自定义规则仍可改写它。完整条件与操作符说明见 智能路由文档。 压低调用成本默认模型分级与失败降级成本主要来自强模型被默认使用。两个开关能压住它默认模型分级Agent 配置里的默认模型指到gemini-2.5-flash只把长上下文、复杂推理交给上面的路由规则切到 pro。失败降级路由页顶部可以设全局的失败处理。选失败降级目标并填入备用模型链后主模型失败会自动按顺序切换{ mode: model-chain, models: [gemini/gemini-2.5-flash], retryCount: 0 }每条规则也可以在失败时单独设置回退覆盖全局配置。偶发限流、超时适合继续重试主模型不可用要换备用模型用模型链。请求日志里有每条记录的 token 和成本估算跑几天就能看出哪条规则在烧钱。验证与排查用请求日志确认最终命中的模型在设置 → 日志与观测打开请求日志发一次真实请求看单条记录的三个字段request model客户端原始请求、resolved provider和resolved model最终命中的供应商和模型。如果发生了降级响应头里还能看到x-ccr-fallback-model这类回退信息详见 日志与可观测性文档。常见对不上的原因有四个规则排在列表后面先命中了更早的规则规则开关没启用目标模型没写进供应商的模型列表条件字段路径写错嵌套内容用contains deep比固定下标稳。规则没命中时按这个顺序检查基本能定位问题。做完这四个动作你得到的是一个稳定的本地入口日常流量走 flash 控成本长任务和复杂推理自动切 pro失败时按模型链降级。后续想再细分策略路由脚本规则、凭据池和请求日志都留了扩展空间。【免费下载链接】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），仅供参考
CCR 智能路由：Gemini 接入的 4 个关键动作
CCR 智能路由Gemini 接入的 4 个关键动作【免费下载链接】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-routerClaude Code Router下文简称 CCR是一个运行在本地的模型路由网关把 Gemini 等多个供应商的模型接到同一个入口让编程 Agent 按请求内容自动选择模型。这篇文章按一次真实配置过程的顺序讲清把 Google Gemini 系列接进来之后路由规则怎么写、成本怎么控、结果怎么验证。先跑起来安装 CCR 并确认本地网关CCR 的 npm CLI 要求 Node.js 22 及以上版本。全局安装后运行ccr ui本机就会启动模型网关和浏览器管理界面npm install -g musistudio/claude-code-router ccr ui模型网关默认监听127.0.0.1:3456管理界面在127.0.0.1:3458。后续的供应商、模型和路由配置都在管理界面里完成命令行只负责启动。把 Agent 的请求地址指向 3456 端口链路就算通了。 接入第一个模型Gemini 预设、密钥与连通性在供应商页选择内置预设Google Gemini填入在 Google AI Studio 申请的 API 密钥通常以AIza开头再勾选模型。Gemini 系列建议至少留两个gemini-2.5-flash响应快、单价低gemini-2.5-pro推理能力更强但更贵探测不到的模型 ID 可以用自定义模型手动补上。保存后每个模型在路由里都以供应商/模型的形式出现例如gemini/gemini-2.5-flash。点检测连通性会向所选模型发一次真实请求用来验证密钥、协议和模型名注意它会计费只勾选需要确认的模型即可。字段含义见 供应商配置文档。 把路由调顺用条件规则改写目标模型CCR 的路由页维护一个规则列表请求进来后按列表顺序匹配第一条命中的启用规则生效。最常用的写法是给规则配一个条件然后把request.body.model设置成目标模型。日常请求和长请求的分工可以用一条 Node.js 脚本规则表达脚本能读到 CCR 估算的input.tokenCountif (input.tokenCount 40000) { return { model: gemini/gemini-2.5-pro }; } return { model: gemini/gemini-2.5-flash };脚本在独立 Worker 里执行返回null表示本条规则不命中、继续检查下一条。除了 token 数脚本还能读到最后一条用户消息、是否带图片等字段按关键词或任务类型分流都够用。如果客户端如 Claude Code没有显式选模型Claude Code 内置路由会直接采用 Agent 配置里设的默认模型自定义规则仍可改写它。完整条件与操作符说明见 智能路由文档。 压低调用成本默认模型分级与失败降级成本主要来自强模型被默认使用。两个开关能压住它默认模型分级Agent 配置里的默认模型指到gemini-2.5-flash只把长上下文、复杂推理交给上面的路由规则切到 pro。失败降级路由页顶部可以设全局的失败处理。选失败降级目标并填入备用模型链后主模型失败会自动按顺序切换{ mode: model-chain, models: [gemini/gemini-2.5-flash], retryCount: 0 }每条规则也可以在失败时单独设置回退覆盖全局配置。偶发限流、超时适合继续重试主模型不可用要换备用模型用模型链。请求日志里有每条记录的 token 和成本估算跑几天就能看出哪条规则在烧钱。验证与排查用请求日志确认最终命中的模型在设置 → 日志与观测打开请求日志发一次真实请求看单条记录的三个字段request model客户端原始请求、resolved provider和resolved model最终命中的供应商和模型。如果发生了降级响应头里还能看到x-ccr-fallback-model这类回退信息详见 日志与可观测性文档。常见对不上的原因有四个规则排在列表后面先命中了更早的规则规则开关没启用目标模型没写进供应商的模型列表条件字段路径写错嵌套内容用contains deep比固定下标稳。规则没命中时按这个顺序检查基本能定位问题。做完这四个动作你得到的是一个稳定的本地入口日常流量走 flash 控成本长任务和复杂推理自动切 pro失败时按模型链降级。后续想再细分策略路由脚本规则、凭据池和请求日志都留了扩展空间。【免费下载链接】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），仅供参考