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、Codex、Grok CLI 单独改 API Key 和模型配置发愁？限流一来任务就中断，花费更是一笔糊涂账。Claude Code Router 是一个本地模型网关加智能路由控制平面：把你手里的 Agent 全部指向同一个入口，由它统一完成路由、失败回退和成本记录。三步装好跑通，换模型不用改任何 Agent 配置。
🚀 先跑通网关：三步完成安装与首次接入
只需要记两个端口：网关 3456，管理界面 3458。
第一步，安装（CLI 方式要求 Node.js 22 及以上）：
npm install -g @musistudio/claude-code-router ccr ui第二步，自动打开的管理界面里进入供应商页，选择内置预设——OpenRouter、DeepSeek、Kimi、Moonshot、Mistral、Z.AI、百炼等开箱即用，填好 API Key 保存；没有合适预设时，任何兼容 OpenAI 或 Anthropic 协议的自定义端点也能直接添加。
第三步，在API 密钥页创建 CCR 客户端 Key，再到服务页点启动。此时网关已在http://127.0.0.1:3456运行，把任意 Agent 的端点指过去就算接入完成。
🤖 一份配置，10 类 Agent 全部接入
同一套配置档案，管住你机器上所有编程 Agent。
在Agent 配置中选择 Claude Code、Codex、Grok CLI、Kimi CLI、Kilo Code、OpenCode、Pi、ZCode 或 WorkBuddy，指定模型后应用档案，之后一条命令ccr "Codex - Work"就能带着配置启动对应 Agent，还能透传它自己的参数。好处很直接：换供应商只改 CCR，不再翻 10 份配置文件；模型覆盖、环境变量、多开工作流也都在这一侧完成。
🧭 让每次请求都走对模型
一条规则决定请求用哪个模型，规则不够还能写脚本。
CCR 的路由分两层：
- 内置路由：自动识别 Claude Code / Codex 请求。Claude Code 主请求落到你配置的模型，而 Subagent、Task、Workflow 派生的请求会按你在模型页写的 Description（这个模型适合什么任务）自动选便宜快速的模型，复杂推理留给强模型；非 GPT 三方模型的
apply_patch也会自动做协议桥接。 - 自定义规则：在路由页按 Header / Body 条件命中后改写目标模型，并配置失败重试与有序 Fallback；更复杂的多字段判断、灰度分流可以写 Node.js 脚本规则，保存后热加载生效。详见 智能路由文档。
省钱的本质就在这里：搜索、摘要这类日常请求走便宜模型，难题走强模型，主 Key 限流自动轮换备用，全程不用人盯着。
🧩 给看不见的模型补上视觉与联网能力
Fusion 能把纯文本模型组合成带视觉、联网搜索的新模型。
Fusion页可以把文本模型与视觉、联网搜索、生图或自定义 MCP 工具组合成一个新模型，Agent 侧像选普通模型一样使用；ToolHub则把多个 MCP server 收束成一个动态工具检索入口。想更进一步，AgentClaw 还能把本机 Agent 接力到 Slack、Discord、企业微信、飞书、Telegram 等 IM 平台。
💰 钱花在哪了：把每次请求变成台账
日志页记录每条请求的最终供应商、模型、耗时、Token 与成本估算。
每个请求落在哪个供应商、用了哪个模型、耗时多久、花了多少 Token、估算多少钱，都有据可查；各账号的余额与额度余量也在同一屏展示。总览页还会汇总请求数、输入/输出 Token、缓存命中率和总花费。再配合 Claude Code 状态行自定义，工作目录、Git 分支、当前模型和 Token 用量一屏可见，干活时心里始终有数。
⚠️ 新手最常踩的 4 个坑，速查表
- 找不到
ccr命令：先确认 Node.js 不低于 22，npm 全局目录在 PATH 里；Shell 缓存了命令路径就开个新终端。 - UI 能打开但网关不可用：通常是没加供应商/模型、没建客户端 Key，或没在服务页启动网关；用
ccr serve看前台报错最快。 - 管理端口变了：默认 3458 被占用时 CCR 会顺延端口，直接用它打印的实际 URL。
- 安全红线：没建客户端 Key 之前不要暴露网关；监听地址保持
127.0.0.1；CCR 运行时别手改 SQLite 配置。
📦 桌面、CLI、Docker 怎么选：一张表看部署
三种部署方式共享同一套配置模型，按场景挑一个就行。
| 部署方式 | 适合谁 | 管理入口 | 网关地址 |
|---|---|---|---|
| 桌面应用 | 本机日常使用、托盘、多开 Agent 应用 | 应用内窗口 | 127.0.0.1:3456 |
npm CLI（ccr ui） | 终端、SSH、无 Electron 环境 | 127.0.0.1:3458 | 127.0.0.1:3456 |
Docker（docker compose up -d --build） | 常驻服务器、容器运维 | Nginx 单入口 3458 | 共用入口 |
更多端口、鉴权与持久化细节，见 安装与启动指南。
别让每个 Agent 各养一套配置，让一个本地网关管住路由、回退和成本。现在运行ccr ui，加上第一个供应商，三分钟就能让 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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
