Claude Code Router 快速上手指南一个本地网关管住所有 AI Agent【免费下载链接】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 CLI模型、Key 各配各的换个模型要翻出好几份配置文件某次请求挂了你也说不清断在哪一环。Claude Code RouterCCR就是一个本地模型网关所有请求统一走本地127.0.0.1:3456路由、降级、日志在一个界面里完成。读完这篇你能带走三样东西一条最短配置路径10 分钟内让 Agent 的请求全部经过本地网关一张直连上游 vs 走 CCR的对比表看清它替你省掉哪些操作4 个高频坑的定位方法出问题时按图索骥。为什么值得先装到本地跑入口稳定Agent 只认127.0.0.1:3456这一个地址上游供应商随便换Agent 侧一行配置都不用动。看得见链路每条请求最终命中哪个供应商、哪个模型、耗时多少、消耗多少 token、成本估算多少全部落在日志页。失败不断链重试、多 Key 轮换、有序 Fallback 都配在路由页一条 Key 挂掉不会让整条工作流停摆。能力可拼装Fusion 能把文本模型和视觉、联网搜索、MCP 工具组合成会看图、能搜索的新模型。三步装好最小可用配置第一步安装并启动。CLI 方式要求 Node.js 22 及以上npm install -g musistudio/claude-code-router ccr uiccr ui会拉起服务并打开浏览器管理页在127.0.0.1:3458模型网关在127.0.0.1:3456。想用容器常驻服务器在仓库根目录执行docker compose up -d --build即可详细差异见安装文档。第二步加供应商。打开供应商 → 添加供应商选内置预设DeepSeek、Moonshot、OpenRouter、百炼等或填自定义 API 地址贴上 API Key。CCR 会自动探测协议和可用模型点检测连通性发一次真实请求验证通过后再保存。这一步的完整字段见接入供应商文档。第三步配 Agent 并验证。在服务页点启动然后在Agent 配置里添加配置选 Claude Code指定模型保存后用卡片上的按钮打开 Agent。发一条消息到日志页确认出现了这条请求——request model和最终命中的模型都在这一屏里。一次完整实测从提问到查账按上面的流程配好一个 Claude Code 配置后发一条给这个函数补类型注解。过程是这样的请求经 3456 网关进入路由规则决定最终用哪个供应商的哪个模型日志页随之多出一行记录含最终供应商、模型、状态码、耗时、token 和成本估算。请求失败时请求体和响应体也直接摆在同一条记录里不用再去上游后台翻。换模型时同样轻量把默认模型从 Claude 系换成国产预设比如 DeepSeekAgent 侧无感。项目作者在原理文章里给过一个真实参照——DeepSeek 的价格不到 Claude Sonnet 3.5 的十分之一长上下文场景再配一个大窗口模型做兜底就是典型的省钱路由。对比项Agent 直连上游经 CCR 网关换模型逐个改各 Agent 的配置文件路由页改一次模型选择Key 失效请求直接报错人工切换按规则重试、轮换或回退排查报错只有 Agent 侧的一句错误日志给出最终模型、耗时、token、请求体成本核算各供应商后台分别看每条请求的成本估算集中在一个页面按场景进阶需要哪个再上哪个如果你要 Key 挂了自动切换。在凭据步骤切到凭据池加多条上游 Key 并设优先级、权重和限额CCR 按规则轮换再到路由页给该供应商加上失败重试和有序 Fallback 模型。如果你要模型会看图、能联网。用 Fusion 组合模型选一个基础文本模型挂上视觉模型、联网搜索或 MCP 工具组合结果会作为一个新模型出现在模型目录里。如果你想在手机上指挥本机 Agent。AgentClaw 可以把本机 Agent 接力成 IM Bot支持企业微信、Slack、Discord、Telegram、飞书、钉钉等平台从聊天窗口下发任务。高频坑与对策先认现象再查三处现象Agent 的请求没走 CCR。原因服务没开、Agent 不是从 CCR 启动的、配置未应用或作用范围没覆盖三项中错一项就会绕过网关。对策按服务状态 → 是否从 CCR 启动 → 配置已应用且范围覆盖的顺序逐项检查。现象上游返回 401/403。原因这是凭据问题不是路由问题。对策核对 Key 是否启用、Base URL 与协议是否匹配改完在供应商页跑一次连通性检查。现象报model not found。原因模型名在三处不一致。对策逐一对比供应商模型列表、路由选中的模型、Agent 配置里的模型改齐不一致的那处。现象请求命中了错误的模型。原因规则按顺序匹配顺序或条件写偏了。对策先在请求日志对比request model与resolved model再回路由页调整规则顺序。更多症状见常见问题 QA。收尾第一条命令CCR 把每个 Agent 一套配置收敛成一个本地网关出问题时有日志可查、有 Key 可换。ccr ui打开 3458 管理页加上你的第一个供应商最小闭环就跑通了。【免费下载链接】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 快速上手指南：一个本地网关管住所有 AI Agent
Claude Code Router 快速上手指南一个本地网关管住所有 AI Agent【免费下载链接】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 CLI模型、Key 各配各的换个模型要翻出好几份配置文件某次请求挂了你也说不清断在哪一环。Claude Code RouterCCR就是一个本地模型网关所有请求统一走本地127.0.0.1:3456路由、降级、日志在一个界面里完成。读完这篇你能带走三样东西一条最短配置路径10 分钟内让 Agent 的请求全部经过本地网关一张直连上游 vs 走 CCR的对比表看清它替你省掉哪些操作4 个高频坑的定位方法出问题时按图索骥。为什么值得先装到本地跑入口稳定Agent 只认127.0.0.1:3456这一个地址上游供应商随便换Agent 侧一行配置都不用动。看得见链路每条请求最终命中哪个供应商、哪个模型、耗时多少、消耗多少 token、成本估算多少全部落在日志页。失败不断链重试、多 Key 轮换、有序 Fallback 都配在路由页一条 Key 挂掉不会让整条工作流停摆。能力可拼装Fusion 能把文本模型和视觉、联网搜索、MCP 工具组合成会看图、能搜索的新模型。三步装好最小可用配置第一步安装并启动。CLI 方式要求 Node.js 22 及以上npm install -g musistudio/claude-code-router ccr uiccr ui会拉起服务并打开浏览器管理页在127.0.0.1:3458模型网关在127.0.0.1:3456。想用容器常驻服务器在仓库根目录执行docker compose up -d --build即可详细差异见安装文档。第二步加供应商。打开供应商 → 添加供应商选内置预设DeepSeek、Moonshot、OpenRouter、百炼等或填自定义 API 地址贴上 API Key。CCR 会自动探测协议和可用模型点检测连通性发一次真实请求验证通过后再保存。这一步的完整字段见接入供应商文档。第三步配 Agent 并验证。在服务页点启动然后在Agent 配置里添加配置选 Claude Code指定模型保存后用卡片上的按钮打开 Agent。发一条消息到日志页确认出现了这条请求——request model和最终命中的模型都在这一屏里。一次完整实测从提问到查账按上面的流程配好一个 Claude Code 配置后发一条给这个函数补类型注解。过程是这样的请求经 3456 网关进入路由规则决定最终用哪个供应商的哪个模型日志页随之多出一行记录含最终供应商、模型、状态码、耗时、token 和成本估算。请求失败时请求体和响应体也直接摆在同一条记录里不用再去上游后台翻。换模型时同样轻量把默认模型从 Claude 系换成国产预设比如 DeepSeekAgent 侧无感。项目作者在原理文章里给过一个真实参照——DeepSeek 的价格不到 Claude Sonnet 3.5 的十分之一长上下文场景再配一个大窗口模型做兜底就是典型的省钱路由。对比项Agent 直连上游经 CCR 网关换模型逐个改各 Agent 的配置文件路由页改一次模型选择Key 失效请求直接报错人工切换按规则重试、轮换或回退排查报错只有 Agent 侧的一句错误日志给出最终模型、耗时、token、请求体成本核算各供应商后台分别看每条请求的成本估算集中在一个页面按场景进阶需要哪个再上哪个如果你要 Key 挂了自动切换。在凭据步骤切到凭据池加多条上游 Key 并设优先级、权重和限额CCR 按规则轮换再到路由页给该供应商加上失败重试和有序 Fallback 模型。如果你要模型会看图、能联网。用 Fusion 组合模型选一个基础文本模型挂上视觉模型、联网搜索或 MCP 工具组合结果会作为一个新模型出现在模型目录里。如果你想在手机上指挥本机 Agent。AgentClaw 可以把本机 Agent 接力成 IM Bot支持企业微信、Slack、Discord、Telegram、飞书、钉钉等平台从聊天窗口下发任务。高频坑与对策先认现象再查三处现象Agent 的请求没走 CCR。原因服务没开、Agent 不是从 CCR 启动的、配置未应用或作用范围没覆盖三项中错一项就会绕过网关。对策按服务状态 → 是否从 CCR 启动 → 配置已应用且范围覆盖的顺序逐项检查。现象上游返回 401/403。原因这是凭据问题不是路由问题。对策核对 Key 是否启用、Base URL 与协议是否匹配改完在供应商页跑一次连通性检查。现象报model not found。原因模型名在三处不一致。对策逐一对比供应商模型列表、路由选中的模型、Agent 配置里的模型改齐不一致的那处。现象请求命中了错误的模型。原因规则按顺序匹配顺序或条件写偏了。对策先在请求日志对比request model与resolved model再回路由页调整规则顺序。更多症状见常见问题 QA。收尾第一条命令CCR 把每个 Agent 一套配置收敛成一个本地网关出问题时有日志可查、有 Key 可换。ccr ui打开 3458 管理页加上你的第一个供应商最小闭环就跑通了。【免费下载链接】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），仅供参考