Claude Code Router 快速上手四步跑通本地模型路由的完整指南【免费下载链接】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 RouterCCR在本机接管了这件事它起一个本地网关统一负责模型路由、供应商切换和请求观测你按本文四步走完十分钟内能看到第一条请求被正确转发。先弄清楚请求都去了哪Claude Code 把请求发给 CCR 的本地网关默认127.0.0.1:3456CCR 根据供应商配置、路由规则和客户端 API Key 决定这次请求实际打到哪个上游模型的哪个 API响应再原路转回。你的客户端操作习惯完全不变变的只是上游指向哪。管理入口和模型网关是两个端口管理界面在127.0.0.1:3458模型网关在127.0.0.1:3456后面验证时会反复用到这两个地址。安装与验证一条命令加两个端口CLI 版本只需 Node.js 22 及以上装完得到ccr命令npm install -g musistudio/claude-code-router ccr uiccr ui会后台启动网关并自动打开浏览器里的管理界面。看到管理界面正常加载、服务页面显示网关已监听3456端口就算装好了。桌面应用README_zh.md 有下载入口功能相同额外提供系统托盘和原生窗口偏好容器就执行docker compose up -d --build管理界面与网关都走3458。如果ccr提示命令不存在先跑node --version确认不低于 22再用npm prefix -g检查全局 bin 目录是否在 PATH最后重开一个终端再试命令参考 packages/cli/README_zh.md。让第一个供应商跑起来最短四步在管理界面按固定顺序点下去即可每一步做什么看下表步骤界面上的位置含义建议值供应商 → 添加供应商选上游预设会自动填好 API 地址和协议选 DeepSeek 等内置预设只填 API Key勾选模型声明这个供应商可用哪些模型至少勾 1 个可点检测连通性验证API 密钥给 Claude Code 用的客户端 Key新建 1 个注意它和上游 Key 是两回事服务 → 启动启动本地模型网关状态变为运行中监听3456最后到Agent 配置建一条 Claude Code 配置填入上一步的客户端 Key、指定默认模型、启用配置然后从 CCR 直接拉起 Claude Codeccr Claude Code cli现在在 Claude Code 里发一句测试消息回到 CCR 的日志页面能看到这条请求的供应商、模型、状态和耗时说明整条链路已经通了。Claude Code 的完整接入参数见 docs/src/content/docs/zh/configuration/agents/claude-code.md。进阶按消息内容自动分流你想解决的问题默认模型一刀切但你希望消息像代码任务就走快模型像推理任务就走推理模型而普通条件规则只能匹配单个请求字段表达不了这种内容判断。做法在路由页面新建规则把规则类型改成Node.js 脚本指向一个本地.js文件。脚本按列表顺序执行返回null表示不命中继续下一条CCR 每次执行前会重新读取文件改脚本不用重新保存规则。脚本体直接写判断逻辑const text input.summary.lastUserText ?? ; if (/def |function |class |import /.test(text)) { return { model: deepseek/deepseek-chat }; } if (/推理|证明|为什么/.test(text)) { return { model: deepseek/deepseek-reasoner }; } return null;规则编辑器里可以直接贴一段测试请求 JSON 试跑脚本不发真实上游请求调试不用烧 token。字段全集input.summary、rewrites、超时 10–30000 毫秒等在 docs/src/content/docs/zh/configuration/routing.md 里有完整说明。进阶子代理不走默认模型你想解决的问题Claude Code 用 Agent / Task / Workflow 派生子代理时全部默认走主模型你想让梳理代码的子任务用便宜模型、架构分析的用推理模型。做法到模型页面给想被自动选中的模型填Description写清适合的任务、速度和成本。只要有一个模型填了 DescriptionCCR 就会把模型清单注入 Claude Code 的 Agent / Task 工具说明派生请求的 prompt 首行会自带模型标签CCR 识别后直接路由到标签指定的模型CCR-SUBAGENT-MODELdeepseek/deepseek-reasoner/CCR-SUBAGENT-MODEL 请给出这道题的完整推理步骤……Description 写得越具体派生选得越准参考文档里的示例写法比如适合代码搜索、文件梳理、低成本并行 Subagent。⚠️ 卡住了四个高频坑与排查路径ccr命令找不到。排查node --version低于 22 或 npm 全局目录不在 PATH。确认修好ccr --help能打印命令列表。管理界面能打开但网关调不通。管理服务可以在没有网关的情况下单独运行这是它的设计。排查服务页面看网关是否真的启动用ccr serve前台跑一次能直接看到启动报错。确认修好3456端口有监听日志页开始出现请求记录。改了供应商或模型客户端行为却没变。最常见原因是 Claude Code 不是从 CCR 拉起的还是连着旧地址。排查确认用ccr 配置名 cli启动且配置开关是启用状态再打开日志页看这条请求的解析供应商/模型是否为你预期的组合。确认修好日志里的最终路由与你的配置一致。推理模型请求超时。reasoner 类模型出结果慢默认超时会被打穿。排查给对应路由规则单独调大超时脚本规则可设 10–30000 毫秒另外检查上游错误里是否写明 token 上限——Claude Code 期望的输出长度可能超过模型单次上限可在规则里改写request.body.max_tokens调小。确认修好发一条典型难题日志状态为成功且能看到完整响应。谁适合用谁别用日常跑 Claude Code 且手上有两三家具额度的上游想在本地集中管路由、回退和请求日志这套方案能明显省切换成本。如果只是一次性调几个模型 API或者你本来就想换掉 Claude Code 客户端本身CCR 就是多余的一层直接用官方 SDK 或换客户端更轻。【免费下载链接】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 快速上手：四步跑通本地模型路由的完整指南
Claude Code Router 快速上手四步跑通本地模型路由的完整指南【免费下载链接】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 RouterCCR在本机接管了这件事它起一个本地网关统一负责模型路由、供应商切换和请求观测你按本文四步走完十分钟内能看到第一条请求被正确转发。先弄清楚请求都去了哪Claude Code 把请求发给 CCR 的本地网关默认127.0.0.1:3456CCR 根据供应商配置、路由规则和客户端 API Key 决定这次请求实际打到哪个上游模型的哪个 API响应再原路转回。你的客户端操作习惯完全不变变的只是上游指向哪。管理入口和模型网关是两个端口管理界面在127.0.0.1:3458模型网关在127.0.0.1:3456后面验证时会反复用到这两个地址。安装与验证一条命令加两个端口CLI 版本只需 Node.js 22 及以上装完得到ccr命令npm install -g musistudio/claude-code-router ccr uiccr ui会后台启动网关并自动打开浏览器里的管理界面。看到管理界面正常加载、服务页面显示网关已监听3456端口就算装好了。桌面应用README_zh.md 有下载入口功能相同额外提供系统托盘和原生窗口偏好容器就执行docker compose up -d --build管理界面与网关都走3458。如果ccr提示命令不存在先跑node --version确认不低于 22再用npm prefix -g检查全局 bin 目录是否在 PATH最后重开一个终端再试命令参考 packages/cli/README_zh.md。让第一个供应商跑起来最短四步在管理界面按固定顺序点下去即可每一步做什么看下表步骤界面上的位置含义建议值供应商 → 添加供应商选上游预设会自动填好 API 地址和协议选 DeepSeek 等内置预设只填 API Key勾选模型声明这个供应商可用哪些模型至少勾 1 个可点检测连通性验证API 密钥给 Claude Code 用的客户端 Key新建 1 个注意它和上游 Key 是两回事服务 → 启动启动本地模型网关状态变为运行中监听3456最后到Agent 配置建一条 Claude Code 配置填入上一步的客户端 Key、指定默认模型、启用配置然后从 CCR 直接拉起 Claude Codeccr Claude Code cli现在在 Claude Code 里发一句测试消息回到 CCR 的日志页面能看到这条请求的供应商、模型、状态和耗时说明整条链路已经通了。Claude Code 的完整接入参数见 docs/src/content/docs/zh/configuration/agents/claude-code.md。进阶按消息内容自动分流你想解决的问题默认模型一刀切但你希望消息像代码任务就走快模型像推理任务就走推理模型而普通条件规则只能匹配单个请求字段表达不了这种内容判断。做法在路由页面新建规则把规则类型改成Node.js 脚本指向一个本地.js文件。脚本按列表顺序执行返回null表示不命中继续下一条CCR 每次执行前会重新读取文件改脚本不用重新保存规则。脚本体直接写判断逻辑const text input.summary.lastUserText ?? ; if (/def |function |class |import /.test(text)) { return { model: deepseek/deepseek-chat }; } if (/推理|证明|为什么/.test(text)) { return { model: deepseek/deepseek-reasoner }; } return null;规则编辑器里可以直接贴一段测试请求 JSON 试跑脚本不发真实上游请求调试不用烧 token。字段全集input.summary、rewrites、超时 10–30000 毫秒等在 docs/src/content/docs/zh/configuration/routing.md 里有完整说明。进阶子代理不走默认模型你想解决的问题Claude Code 用 Agent / Task / Workflow 派生子代理时全部默认走主模型你想让梳理代码的子任务用便宜模型、架构分析的用推理模型。做法到模型页面给想被自动选中的模型填Description写清适合的任务、速度和成本。只要有一个模型填了 DescriptionCCR 就会把模型清单注入 Claude Code 的 Agent / Task 工具说明派生请求的 prompt 首行会自带模型标签CCR 识别后直接路由到标签指定的模型CCR-SUBAGENT-MODELdeepseek/deepseek-reasoner/CCR-SUBAGENT-MODEL 请给出这道题的完整推理步骤……Description 写得越具体派生选得越准参考文档里的示例写法比如适合代码搜索、文件梳理、低成本并行 Subagent。⚠️ 卡住了四个高频坑与排查路径ccr命令找不到。排查node --version低于 22 或 npm 全局目录不在 PATH。确认修好ccr --help能打印命令列表。管理界面能打开但网关调不通。管理服务可以在没有网关的情况下单独运行这是它的设计。排查服务页面看网关是否真的启动用ccr serve前台跑一次能直接看到启动报错。确认修好3456端口有监听日志页开始出现请求记录。改了供应商或模型客户端行为却没变。最常见原因是 Claude Code 不是从 CCR 拉起的还是连着旧地址。排查确认用ccr 配置名 cli启动且配置开关是启用状态再打开日志页看这条请求的解析供应商/模型是否为你预期的组合。确认修好日志里的最终路由与你的配置一致。推理模型请求超时。reasoner 类模型出结果慢默认超时会被打穿。排查给对应路由规则单独调大超时脚本规则可设 10–30000 毫秒另外检查上游错误里是否写明 token 上限——Claude Code 期望的输出长度可能超过模型单次上限可在规则里改写request.body.max_tokens调小。确认修好发一条典型难题日志状态为成功且能看到完整响应。谁适合用谁别用日常跑 Claude Code 且手上有两三家具额度的上游想在本地集中管路由、回退和请求日志这套方案能明显省切换成本。如果只是一次性调几个模型 API或者你本来就想换掉 Claude Code 客户端本身CCR 就是多余的一层直接用官方 SDK 或换客户端更轻。【免费下载链接】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），仅供参考