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 走 Kimi、Codex 走 OpenRouter,却不想在各自的配置里改 API 地址时,Claude Code Router(CCR)能帮上忙。它在本机跑一个模型网关,多模型路由、供应商切换、请求日志全部收敛到一个入口。一个本地模型网关,接管所有 Agent 的请求CCR 的定位是本地模型网关加控制面。Claude Code、Codex、Kimi CLI、OpenCode 等 Agent 全部指向同一个本地地址,默认是http://127.0.0.1:3456,背后接什么供应商、走哪个模型,由 CCR 决定。网关内部按供应商 → 路由 → 凭据三层组织。供应商负责协议适配,OpenAI、Anthropic、Gemini 等协议都支持,也兼容任意自建端点;路由按规则顺序匹配,可以改写请求、配置重试和有序回退;凭据支持单 Key 或凭据池轮换。另外还有一个管理入口,默认http://127.0.0.1:3458,负责供应商、模型、路由和日志的可视化管理。CCR 桌面端 Overview 页:各供应商余额、配额用量、token 统计和估算成本都集中展示环境搭建:安装 ccr CLI 并启动本地模型网关前提只有一个:Node.js 22 或更高版本。CLI 版不需要 Electron,ccr ui会启动后台服务并打开浏览器管理界面,适合开发机和无桌面环境。这条命令全局安装 CLI,然后启动服务并打开管理界面:npm install -g musistudio/claude-code-router ccr ui关键是安装后不用改任何 Agent 配置,先让网关自己跑起来。浏览器中的 CCR 管理界面,左侧是供应商、路由、模型、日志等模块接下来按顺序做 3 件事:Providers → Add Provider:选内置预设或自定义地址,填 API Key,勾选模型,可先检测连通性验证。API Keys:创建一个客户端 Key。这是访问网关的凭据,和上游供应商 Key 是两回事。Server:点 Start,确认网关在 3456 端口运行,再到Logs里等第一条请求。Claude Code 启动时读取环境变量,API Base URL 已指向本地网关 3456 端口核心场景:把 Claude Code 指向你的供应商场景:让 Claude Code 跑在非 Anthropic 模型上。操作分两步。先在 Agent Config 里添加一个 Claude Code 配置,选好默认模型,比如Moonshot/kimi-k3,保存后用配置名启动:ccr Claude Code - Work关键在启动后进入会话执行/model,列出的就是 CCR 暴露的全部模型,随时可切。效果是:每次请求在 Logs 里都能看到最终命中的供应商、模型、token 数、延迟和错误,切模型不用重启,改 Agent 配置更是不用碰。场景:同一台机器开多套配置。如果工作项目用强推理模型、日常问答用便宜模型,不必复制环境变量。建两个配置,各选各的模型,ccr Claude Code - Work和ccr Claude Code - Quick分别启动即可,实例之间互不干扰。进阶:路由规则改写请求与 Fusion 能力扩展如果你需要按条件分流,可以在路由页添加规则:条件匹配请求的 header 或 body,命中后改写模型或请求参数,并可为该规则单独配置失败回退。单条规则表达不了逻辑时,把规则类型设为 Node.js 脚本,例如按模型名做定向改写:if (input.body.model ! openrouter/gemini-2.5-flash) { return null; } return { model: moonshot/kimi-k3 };关键在返回null表示不命中,继续匹配下一条规则。如果你需要让 Claude Code 的 Subagent 自动选模型,可以给模型填 Description,CCR 会注入到 Agent/Task 工具说明,派生请求按标签路由。如果你要给没有联网或视觉能力的模型补能力,Fusion 可以叠加 web search、视觉和 MCP 工具;桌面版还支持自定义状态栏,把当前模型、token 用量拖成组件实时显示。状态栏配置:组件、变量和颜色都可以拖拽预览踩坑记录:端口占用、登录态导入与网关未启动问题:安装后提示ccr找不到。原因是 npm 全局 bin 目录不在 PATH,或 Node 版本低于 22。解法:先跑node --version和npm prefix -g,把 bin 目录加进 PATH,再开一个新终端。问题:管理界面地址不是 3458 端口。原因是目标端口被占用,CCR 自动顺延到下一个可用端口。解法:直接用终端实际打印的 URL,或者停掉冲突进程后ccr stop ccr start重建服务。问题:UI 能打开,但 Agent 请求全部失败。原因是管理服务可以独立于网关运行,常见于还没添加供应商或没建客户端 Key。解法:补上供应商和模型,创建 API Key,再到 Server 页启动或重启网关,最后用/health验证。CCR 更适合已经在用 Claude Code、Codex 这类 Agent,且手头不止一家模型供应商的开发者,典型姿势是:网关常开,供应商按预算配置回退顺序,日常切模型只动路由不动 Agent。完整的中文文档在 docs 目录,路由细节见 智能路由说明。【免费下载链接】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 走 Kimi、Codex 走 OpenRouter,却不想在各自的配置里改 API 地址时,Claude Code Router(CCR)能帮上忙。它在本机跑一个模型网关,多模型路由、供应商切换、请求日志全部收敛到一个入口。一个本地模型网关,接管所有 Agent 的请求CCR 的定位是本地模型网关加控制面。Claude Code、Codex、Kimi CLI、OpenCode 等 Agent 全部指向同一个本地地址,默认是http://127.0.0.1:3456,背后接什么供应商、走哪个模型,由 CCR 决定。网关内部按供应商 → 路由 → 凭据三层组织。供应商负责协议适配,OpenAI、Anthropic、Gemini 等协议都支持,也兼容任意自建端点;路由按规则顺序匹配,可以改写请求、配置重试和有序回退;凭据支持单 Key 或凭据池轮换。另外还有一个管理入口,默认http://127.0.0.1:3458,负责供应商、模型、路由和日志的可视化管理。CCR 桌面端 Overview 页:各供应商余额、配额用量、token 统计和估算成本都集中展示环境搭建:安装 ccr CLI 并启动本地模型网关前提只有一个:Node.js 22 或更高版本。CLI 版不需要 Electron,ccr ui会启动后台服务并打开浏览器管理界面,适合开发机和无桌面环境。这条命令全局安装 CLI,然后启动服务并打开管理界面:npm install -g musistudio/claude-code-router ccr ui关键是安装后不用改任何 Agent 配置,先让网关自己跑起来。浏览器中的 CCR 管理界面,左侧是供应商、路由、模型、日志等模块接下来按顺序做 3 件事:Providers → Add Provider:选内置预设或自定义地址,填 API Key,勾选模型,可先检测连通性验证。API Keys:创建一个客户端 Key。这是访问网关的凭据,和上游供应商 Key 是两回事。Server:点 Start,确认网关在 3456 端口运行,再到Logs里等第一条请求。Claude Code 启动时读取环境变量,API Base URL 已指向本地网关 3456 端口核心场景:把 Claude Code 指向你的供应商场景:让 Claude Code 跑在非 Anthropic 模型上。操作分两步。先在 Agent Config 里添加一个 Claude Code 配置,选好默认模型,比如Moonshot/kimi-k3,保存后用配置名启动:ccr Claude Code - Work关键在启动后进入会话执行/model,列出的就是 CCR 暴露的全部模型,随时可切。效果是:每次请求在 Logs 里都能看到最终命中的供应商、模型、token 数、延迟和错误,切模型不用重启,改 Agent 配置更是不用碰。场景:同一台机器开多套配置。如果工作项目用强推理模型、日常问答用便宜模型,不必复制环境变量。建两个配置,各选各的模型,ccr Claude Code - Work和ccr Claude Code - Quick分别启动即可,实例之间互不干扰。进阶:路由规则改写请求与 Fusion 能力扩展如果你需要按条件分流,可以在路由页添加规则:条件匹配请求的 header 或 body,命中后改写模型或请求参数,并可为该规则单独配置失败回退。单条规则表达不了逻辑时,把规则类型设为 Node.js 脚本,例如按模型名做定向改写:if (input.body.model ! openrouter/gemini-2.5-flash) { return null; } return { model: moonshot/kimi-k3 };关键在返回null表示不命中,继续匹配下一条规则。如果你需要让 Claude Code 的 Subagent 自动选模型,可以给模型填 Description,CCR 会注入到 Agent/Task 工具说明,派生请求按标签路由。如果你要给没有联网或视觉能力的模型补能力,Fusion 可以叠加 web search、视觉和 MCP 工具;桌面版还支持自定义状态栏,把当前模型、token 用量拖成组件实时显示。状态栏配置:组件、变量和颜色都可以拖拽预览踩坑记录:端口占用、登录态导入与网关未启动问题:安装后提示ccr找不到。原因是 npm 全局 bin 目录不在 PATH,或 Node 版本低于 22。解法:先跑node --version和npm prefix -g,把 bin 目录加进 PATH,再开一个新终端。问题:管理界面地址不是 3458 端口。原因是目标端口被占用,CCR 自动顺延到下一个可用端口。解法:直接用终端实际打印的 URL,或者停掉冲突进程后ccr stop ccr start重建服务。问题:UI 能打开,但 Agent 请求全部失败。原因是管理服务可以独立于网关运行,常见于还没添加供应商或没建客户端 Key。解法:补上供应商和模型,创建 API Key,再到 Server 页启动或重启网关,最后用/health验证。CCR 更适合已经在用 Claude Code、Codex 这类 Agent,且手头不止一家模型供应商的开发者,典型姿势是:网关常开,供应商按预算配置回退顺序,日常切模型只动路由不动 Agent。完整的中文文档在 docs 目录,路由细节见 智能路由说明。【免费下载链接】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），仅供参考