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、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 不低于 22npm 全局目录在 PATH 里Shell 缓存了命令路径就开个新终端。UI 能打开但网关不可用通常是没加供应商/模型、没建客户端 Key或没在服务页启动网关用ccr serve看前台报错最快。管理端口变了默认 3458 被占用时 CCR 会顺延端口直接用它打印的实际 URL。安全红线没建客户端 Key 之前不要暴露网关监听地址保持127.0.0.1CCR 运行时别手改 SQLite 配置。 桌面、CLI、Docker 怎么选一张表看部署三种部署方式共享同一套配置模型按场景挑一个就行。部署方式适合谁管理入口网关地址桌面应用本机日常使用、托盘、多开 Agent 应用应用内窗口127.0.0.1:3456npm CLIccr ui终端、SSH、无 Electron 环境127.0.0.1:3458127.0.0.1:3456Dockerdocker 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），仅供参考