claude-code-router 完全指南:给 Claude Code 请求装上路由中枢
【免费下载链接】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
写代码、跑搜索、读长文档,三类任务你都想用不同模型,但 Claude Code 只认一个出口,账单全算在同一个头上。claude-code-router(命令简称 ccr)是个本地路由网关:它把 Claude Code 发出的请求按规则拆开,分发给不同的模型或后端,帮你省钱、省限流、也少配几步。
三分钟跑起来的安装步骤
只要三行 shell 命令,装完即走:
npm install -g @anthropic-ai/claude-code npm install -g @musistudio/claude-code-router ccr code第一行装 Claude Code 本体,第二行装 ccr,第三行用它启动 Claude Code——启动后所有请求都从 ccr 本地网关过一遍,你原来的工作流不用改。
它怎么工作:请求匹配路由规则,落到对应模型
整条链路就三步:
- 进来:Claude Code 把请求发给 ccr 的本地端口
- 匹配:ccr 按你写的路由规则判断这条请求属于哪类任务
- 出去:请求落到对应的模型或后端服务
| 你的场景 | 路由规则 | 实际效果 |
|---|---|---|
| 日常编码 | 默认规则 | 稳定模型兜底 |
| 复杂推理 | 命中"think"场景 | 切到推理强的模型 |
| 联网搜索 | 命中"web search"场景 | 走带搜索能力的模型 |
| 本地快速调试 | 命中本地规则 | 走 Ollama 之类的本地模型,不花一分钱 |
三个高频玩法
多模型混用:一个会话里按需换脑
日常任务用一个便宜稳的模型,遇到复杂推理自动切到更强的,你不用来回敲命令换配置。比如:后端工程师晚上写业务逻辑走默认模型,周末啃一个并发难题时,ccr 把"think"类请求转给推理模型,答完又自动回来。
请求聚合与分发:多个后端统一入口
ccr 能接 DeepSeek、Gemini、OpenRouter、本地 Ollama 等多路 Provider,对 Claude Code 来说只有一个入口。比如:前端团队把搜索类请求集中到带联网能力的模型,代码审查类请求分给另一个实例,互不抢额度。
控制调用成本:把贵的模型用在刀刃上
最省钱的玩法不是换便宜模型,而是别让贵模型空转。比如:把 Web Search 路由到便宜的 flash 档模型,只保留核心编码用主力模型——同样的活,token 账单能砍掉一大截。
能不能自己扩展:插件机制和配置门槛
ccr 的扩展点是插件:一段 JS 挂到请求链路上,就能改路由判断或改写请求内容。官方已经带了两个示例插件——自定义路由和重写提示词,仓库的 插件目录 里可以直接看实现和接入方式。配置文件本身就是个简单明了的 JSON,想加一条规则就加一条,不用学框架。
适合谁用:先看你的账单长什么样
如果你符合下面任意一条,值得花五分钟试试:
- Claude Code 是主力工具,账单或限流已经让你肉疼
- 团队多人共用几个 API Key,需要按任务分账、分流
- 手里有多个 Provider,不想在每个工具里各配一遍
现在装好,先把 Web Search 路由到便宜模型,第一笔成本账今天就回来。后续 ccr 还在推进更细粒度的模型切换和定时任务,路由这件事只会做得更深。
【免费下载链接】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),仅供参考