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当大部分请求都是简单任务时模型配置散落在各个 Agent 里既难维护也都在走云端计费接口。Claude Code RouterCCR是一个本地模型网关把 Claude Code、Codex 等编程 Agent 的请求统一转发到你指定的供应商或本地模型简单调用不必再走云端付费接口。它解决什么问题多个 Agent 共用一套模型配置。Claude Code、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode 等都指向同一个本地入口http://127.0.0.1:3456。切换供应商或模型时只改 CCR 一处不用逐个改 Agent 配置。简单任务走本地模型。Ollama 这类本地服务暴露 OpenAI 兼容端点通过自定义 API 地址接入 CCR 即可。代码补全、摘要、简单问答这类调用打到本地复杂推理任务再指定云端模型。简单任务占多数时走付费 API 的调用比例会随之下降。失败时自动兜底。主模型超时或报 5xx 时CCR 可以按配置继续重试或按顺序切到备用模型链Agent 侧通常无感。最短上手路径安装 CCR三条路线桌面应用适合本机日常使用、npm CLI、Docker。终端环境用 CLI 最短要求 Node.js 22 或更高版本npm install -g musistudio/claude-code-router ccr uiccr ui会启动后台服务并打开浏览器管理界面地址为http://127.0.0.1:3458。桌面端从 Releases 下载对应系统安装包Docker 方式在仓库根目录执行docker compose up -d --build入口同样是 3458 端口。配置供应商与 Agent在供应商页点击添加供应商内置预设会自动填入 API 地址和协议Ollama 等本地服务选其他/自定义 API 地址填名称、API 地址如http://localhost:11434/v1和密钥协议选 OpenAI Chat可用检测连通性确认链路。在Agent 配置页添加 Claude Code指定默认模型后保存。在服务页点击启动。本地模型网关默认监听http://127.0.0.1:3456配置数据存放在~/.claude-code-router。验证路由是否生效用配置卡片上的按钮从 CCR 启动 Agent发一条消息然后在请求日志里核对三个字段request model客户端原始模型、resolved provider最终供应商、resolved model最终模型。三者按预期命中说明请求确实经过了网关。CLI 中可用/model查看 CCR 暴露的模型列表。核心功能智能路由怎么配路由页的规则列表按顺序匹配第一条命中的启用规则改写请求。每条规则两部分条件对request.header或request.body的字段做等值、前缀、contains deep等判断和改写如把request.body.model设置为目标供应商/模型。一个典型的本地/云端分流配置添加一条规则条件判断请求消息内容命中简单任务的把request.body.model改写为ollama/本地模型其余请求走默认模型云端。规则底部还能单独设置失败时策略继续重试当前模型或按失败降级目标依次切换备用模型链。条件涉及多字段或需要读外部策略时可以把规则类型改为 Node.js 脚本在编辑器里用测试请求 JSON 试跑后再保存。除路由外CCR 还有 Fusion把文本模型与视觉、联网搜索、MCP 工具组合成新模型、ToolHub聚合多个 MCP server和 AgentClaw把 Agent 接进 IM 平台用法见各自的文档页。边界与下一步管理界面能打开不等于网关可用未配置供应商时请求会失败Docker 首次启动/health返回 502 属于预期行为。路由规则按列表顺序匹配顺序或条件不对就会命中错误模型先查请求日志里的 resolved 字段再调规则顺序。本地模型的能力取决于你自己的硬件和选型深度推理任务仍建议保留云端模型本地路由是成本优化而非完全替代。401、model not found、超时等常见问题先查常见问题文档路由字段和回退模式的完整说明在路由文档安装细节见安装指南。【免费下载链接】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），仅供参考
