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还在为每个 AI 编程助手单独配一套模型和 Key 发愁Claude Code RouterCCR是一个运行在本地的模型网关与控制台把 Claude Code、Codex 等 Agent 的流量统一收敛到一个端点再按你的规则智能路由到任意供应商顺带完成重试、回退和成本统计。跑通只需 3 步、约 5 分钟换来的是灵活切换模型、多 Key 轮换和请求级成本可视化。先算一笔账统一路由带来的收益收益维度没有网关时接入 CCR 之后配置维护每个 Agent 各改一遍配置文件一处管理供应商、模型与路由规则故障处理Key 失效/超限时任务直接中断凭据池自动轮换 有序回退重试成本可见性只能去各家后台对账请求日志记录每条请求的模型、token 与成本估算能力扩展换协议、加工具要改客户端Fusion 组合视觉/搜索/MCP 工具为新模型从零跑通安装 Claude Code Router 三步走推荐用 CLI 安装需要 Node.js 22一条命令装完浏览器里管理npm install -g musistudio/claude-code-router ccr ui打开http://127.0.0.1:3458这是 Web 管理界面模型网关默认监听http://127.0.0.1:3456。在Server页点击Start看到 Running 即表示网关已就绪。在API Keys页创建一个 CCR 客户端 KeyAgent 调用网关时凭它鉴权。如果你偏好桌面应用或服务器部署可下载官方 Desktop 版或 clone 仓库后执行docker compose up -d --buildDocker 方式会把管理界面与网关合并发布在 3458 端口。接入第一个模型供应商进入Providers → Add Provider按下面顺序填选预设或自定义内置预设DeepSeek、OpenRouter、Moonshot、Mistral 等会带默认 API 地址与协议自定义 API 地址 可接入任意兼容 OpenAI / Anthropic / Gemini 协议的服务包括 Ollama 本地模型。填名称与 Key名称要唯一它是后续路由、日志里识别供应商的标识。勾选模型能探测到模型列表时直接搜索勾选探测不到就手动加模型 ID。点检测连通性对勾选的模型发一次真实请求验证 Key、协议与模型名是否真的可用。按量计费时建议只勾需要确认的模型避免白烧 token。让 Claude Code 走智能路由供应商就绪后让 Agent 把流量交给网关Agent Config → Add Profile选择 Claude Code填一个配置名。模型选一个刚才供应商里的模型作用范围先用默认的仅从 CCR 打开跑稳了再切系统默认。保存后从配置卡片的终端按钮启动 Claude Code发一条消息确认能回复。在Logs里查看这条请求核对命中的供应商、模型、状态、耗时与 token确认链路走通。用条件规则和脚本做精细化路由跑通之后路由页就是省钱开关所在内置路由自动识别 Claude Code 请求其 Subagent / Workflow 派生任务还能依据模型的 Description 说明自动选用更便宜或更合适的模型。条件规则按请求头或请求体字段匹配命中后改写目标模型规则按列表顺序取第一条命中项支持上移下移调优先级。Node.js 脚本规则普通条件表达不了的灰度分流、多字段判断可以挂一个脚本动态返回目标模型。脚本编辑器内置测试请求不发真实上游也能试跑。脚本只需返回模型或改写即可例如把指定模型的请求转到更便宜的供应商if (input.body.model ! 供应商/原模型) { return null; } return { model: 供应商/目标模型 };失败处理也有保障规则命中后上游失败可按规则级或全局配置自动重试、换 Key 或切换有序回退模型任务不中断。请求日志验证路由与排查成本波动打开设置 → 日志与观测启用请求日志与Agent 观测然后重新发一条任务请求日志记录每条请求的request model、resolved provider、resolved model、状态码、耗时、token 和成本估算支持按供应商、模型、凭据筛选。观测面板展示 Agent 的执行链路——每步耗时、工具调用与结果Agent 卡住时一眼定位在哪一环。成本突然升高时直接按模型或凭据筛选日志找增量来源而不是凭感觉猜。常见报错对照表症状先查什么处理动作Agent 没走 CCR网关是否在运行、Agent 是否从 CCR 启动、配置作用范围三项全对才会被网关接管401 / 403API Key 与凭据是否启用核对 Key、Base URL、协议后用连通性检测验证model not found三处模型名是否一致供应商列表/路由/Agent 配置对齐不一致的名称命中了错误模型请求日志中 request 与 resolved 对比 规则顺序调整规则顺序或匹配条件某条 Key 持续失败日志按凭据筛选确认失败是否集中在该 Key查该 Key 额度与账号状态请求超时日志耗时分布耗时集中在工具调用时调大 timeout更多细节可参考仓库内的 troubleshooting.md 与 智能路由文档。现在就去跑通你的第一条路由花 5 分钟把网关拉起来接上你最常用的模型供应商让 Claude Code 的第一个请求出现在请求日志里。剩下的事——规则、回退、Fusion 工具——都是在这条已验证的链路上做加法。模型可以随时换流量应该始终握在你自己手里。【免费下载链接】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还在为每个 AI 编程助手单独配一套模型和 Key 发愁Claude Code RouterCCR是一个运行在本地的模型网关与控制台把 Claude Code、Codex 等 Agent 的流量统一收敛到一个端点再按你的规则智能路由到任意供应商顺带完成重试、回退和成本统计。跑通只需 3 步、约 5 分钟换来的是灵活切换模型、多 Key 轮换和请求级成本可视化。先算一笔账统一路由带来的收益收益维度没有网关时接入 CCR 之后配置维护每个 Agent 各改一遍配置文件一处管理供应商、模型与路由规则故障处理Key 失效/超限时任务直接中断凭据池自动轮换 有序回退重试成本可见性只能去各家后台对账请求日志记录每条请求的模型、token 与成本估算能力扩展换协议、加工具要改客户端Fusion 组合视觉/搜索/MCP 工具为新模型从零跑通安装 Claude Code Router 三步走推荐用 CLI 安装需要 Node.js 22一条命令装完浏览器里管理npm install -g musistudio/claude-code-router ccr ui打开http://127.0.0.1:3458这是 Web 管理界面模型网关默认监听http://127.0.0.1:3456。在Server页点击Start看到 Running 即表示网关已就绪。在API Keys页创建一个 CCR 客户端 KeyAgent 调用网关时凭它鉴权。如果你偏好桌面应用或服务器部署可下载官方 Desktop 版或 clone 仓库后执行docker compose up -d --buildDocker 方式会把管理界面与网关合并发布在 3458 端口。接入第一个模型供应商进入Providers → Add Provider按下面顺序填选预设或自定义内置预设DeepSeek、OpenRouter、Moonshot、Mistral 等会带默认 API 地址与协议自定义 API 地址 可接入任意兼容 OpenAI / Anthropic / Gemini 协议的服务包括 Ollama 本地模型。填名称与 Key名称要唯一它是后续路由、日志里识别供应商的标识。勾选模型能探测到模型列表时直接搜索勾选探测不到就手动加模型 ID。点检测连通性对勾选的模型发一次真实请求验证 Key、协议与模型名是否真的可用。按量计费时建议只勾需要确认的模型避免白烧 token。让 Claude Code 走智能路由供应商就绪后让 Agent 把流量交给网关Agent Config → Add Profile选择 Claude Code填一个配置名。模型选一个刚才供应商里的模型作用范围先用默认的仅从 CCR 打开跑稳了再切系统默认。保存后从配置卡片的终端按钮启动 Claude Code发一条消息确认能回复。在Logs里查看这条请求核对命中的供应商、模型、状态、耗时与 token确认链路走通。用条件规则和脚本做精细化路由跑通之后路由页就是省钱开关所在内置路由自动识别 Claude Code 请求其 Subagent / Workflow 派生任务还能依据模型的 Description 说明自动选用更便宜或更合适的模型。条件规则按请求头或请求体字段匹配命中后改写目标模型规则按列表顺序取第一条命中项支持上移下移调优先级。Node.js 脚本规则普通条件表达不了的灰度分流、多字段判断可以挂一个脚本动态返回目标模型。脚本编辑器内置测试请求不发真实上游也能试跑。脚本只需返回模型或改写即可例如把指定模型的请求转到更便宜的供应商if (input.body.model ! 供应商/原模型) { return null; } return { model: 供应商/目标模型 };失败处理也有保障规则命中后上游失败可按规则级或全局配置自动重试、换 Key 或切换有序回退模型任务不中断。请求日志验证路由与排查成本波动打开设置 → 日志与观测启用请求日志与Agent 观测然后重新发一条任务请求日志记录每条请求的request model、resolved provider、resolved model、状态码、耗时、token 和成本估算支持按供应商、模型、凭据筛选。观测面板展示 Agent 的执行链路——每步耗时、工具调用与结果Agent 卡住时一眼定位在哪一环。成本突然升高时直接按模型或凭据筛选日志找增量来源而不是凭感觉猜。常见报错对照表症状先查什么处理动作Agent 没走 CCR网关是否在运行、Agent 是否从 CCR 启动、配置作用范围三项全对才会被网关接管401 / 403API Key 与凭据是否启用核对 Key、Base URL、协议后用连通性检测验证model not found三处模型名是否一致供应商列表/路由/Agent 配置对齐不一致的名称命中了错误模型请求日志中 request 与 resolved 对比 规则顺序调整规则顺序或匹配条件某条 Key 持续失败日志按凭据筛选确认失败是否集中在该 Key查该 Key 额度与账号状态请求超时日志耗时分布耗时集中在工具调用时调大 timeout更多细节可参考仓库内的 troubleshooting.md 与 智能路由文档。现在就去跑通你的第一条路由花 5 分钟把网关拉起来接上你最常用的模型供应商让 Claude Code 的第一个请求出现在请求日志里。剩下的事——规则、回退、Fusion 工具——都是在这条已验证的链路上做加法。模型可以随时换流量应该始终握在你自己手里。【免费下载链接】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），仅供参考