Claude Code Router5 分钟装好本地网关把编程 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你让 Claude Code 修一个跨文件的 bug它背后调用的却不是 Claude而是更便宜的 DeepSeek——你的工作流和项目配置一个字没改。Claude Code RouterCCR就是干这件事的本地模型路由网关所有编程 Agent 的请求先打到它这里再按你配的规则转发到任意供应商。模型切换、密钥轮换、请求回退都发生在网关这一层终端里的 Agent 无感知。CCR 属于本地 AI 网关/控制平面这一类工具把 Claude Code、Codex、Grok CLI、Kimi CLI、OpenCode 等编程 Agent 和 API 兼容客户端统一接到你选的供应商。它的核心能力统一管理供应商、模型与凭据支持单 Key 和凭据池轮换按条件路由请求失败时自动重试、按序回退到备用模型给现有模型加视觉、联网搜索、MCP 工具等能力请求日志记录最终供应商、模型、耗时、Token 与成本装好 CLI 并启动本地网关Step 1全局安装 npm 包要求 Node.js 22 或更高版本# 安装 npm install -g musistudio/claude-code-router # 确认命令可用 ccr --helpStep 2启动后台服务并自动打开浏览器管理界面默认 http://127.0.0.1:3458# 启动服务 ccr ui没有桌面的服务器可以改用docker compose up -d --build起容器管理界面和网关共用 3458 端口。Step 3在供应商页添加供应商——选内置预设或自定义 API 地址填 API Key勾选至少一个模型点检测连通性确认 Key 和模型真实可调用然后保存。Step 4在API 密钥页创建 CCR 客户端密钥再到服务页点启动让模型网关开始监听 http://127.0.0.1:3456。Step 5验证网关存活# 健康检查返回 200 说明安装配置跑通 curl http://127.0.0.1:3456/health看到 200 之后网关就跑起来了下面把 Agent 接进来。完成最小可用配置CCR 的运行配置存在~/.claude-code-router/config.sqlite里由界面维护不要手动编辑。命令层面能跑通的最小区集就是验证加启动这两条# 网关健康检查 curl http://127.0.0.1:3456/health # 按配置名启动 Agent请求自动走网关 ccr Claude - Work三个配置项决定行为差异端口分工Agent 指向 3456 时请求命中的是模型网关指向 3458 打开的是管理面板拿不到模型响应。生效范围选仅从 CCR 打开时生效只影响从 CCR 启动的 Agent不碰你的全局配置改成系统默认则对所有项目生效建议试用稳定后再切换。凭据只填单条 API Key 时所有请求都走这一把展开凭据池后 CCR 按优先级选用某条 Key 触发rpm/tpm限额会被自动跳过。启动 Agent 并切换模型场景把 Claude Code 接到网关。在Agent 配置页添加 Claude Code 配置选一个模型留空则保留默认模型保存后用卡片上的终端按钮启动或在终端跑ccr Claude - Work。发一条消息能正常回复到日志页就能看到这条请求经过网关的记录。场景会话里切换模型。在 Agent 会话里输入/model查看 CCR 暴露的模型列表再用/model 供应商/模型直接切换。预期效果是后续请求立即改用新模型不用关会话、不用改任何配置文件。场景核对请求真实去向。打开日志页按模型或供应商筛选每条请求都能看到最终供应商、模型、状态码、耗时和 Token用来确认路由有没有按预期命中。用 Node.js 脚本写路由规则普通条件规则能覆盖Header/Body 满足 X 就改写模型的需求需要多字段判断或动态逻辑时在路由页把规则类型切到Node.js 脚本。脚本是异步函数体不需要写 import 或 module.exports直接用注入的input// 本地 .js 文件规则编辑器里选中它即可 if (input.body.model ! 供应商/原模型) { return null; // 不命中继续下一条规则 } return { model: 供应商/目标模型 };注意三点超时时间填 10–30000 毫秒脚本异常会 fail-open 继续匹配下一条规则不会把请求拦死编辑器里的测试请求 JSON可以不打真实上游先试跑一遍。规则的执行链路在 packages/core/src/routing/。排查高频报错现象装完找不到ccr命令 → 原因Node 版本低于 22或 npm 全局目录不在 PATH → 解决node --version确认版本npm prefix -g查全局路径并加入 PATH重开终端。现象管理 URL 端口不是 3458 → 原因首选端口被占用CCR 自动顺延 → 解决直接用 CCR 打印的实际 URL或停掉占用进程后重启。现象UI 能打开但网关不可用 → 原因供应商、模型或客户端密钥没配齐网关没起来 → 解决补完后从服务页启动网关用ccr serve看前台报错定位。现象Agent 请求没走 CCR → 原因Agent 不是从 CCR 启动的或配置未应用 → 解决用配置卡片的终端按钮启动 Agent确认配置已应用且作用范围覆盖当前项目。现象model not found→ 原因路由解析出的模型不在供应商模型列表里 → 解决对照供应商模型列表、路由规则、Agent 配置三处的模型名改到一致。CCR 把换模型从改一堆 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：5 分钟装好本地网关，把编程 Agent 接到任意模型
Claude Code Router5 分钟装好本地网关把编程 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你让 Claude Code 修一个跨文件的 bug它背后调用的却不是 Claude而是更便宜的 DeepSeek——你的工作流和项目配置一个字没改。Claude Code RouterCCR就是干这件事的本地模型路由网关所有编程 Agent 的请求先打到它这里再按你配的规则转发到任意供应商。模型切换、密钥轮换、请求回退都发生在网关这一层终端里的 Agent 无感知。CCR 属于本地 AI 网关/控制平面这一类工具把 Claude Code、Codex、Grok CLI、Kimi CLI、OpenCode 等编程 Agent 和 API 兼容客户端统一接到你选的供应商。它的核心能力统一管理供应商、模型与凭据支持单 Key 和凭据池轮换按条件路由请求失败时自动重试、按序回退到备用模型给现有模型加视觉、联网搜索、MCP 工具等能力请求日志记录最终供应商、模型、耗时、Token 与成本装好 CLI 并启动本地网关Step 1全局安装 npm 包要求 Node.js 22 或更高版本# 安装 npm install -g musistudio/claude-code-router # 确认命令可用 ccr --helpStep 2启动后台服务并自动打开浏览器管理界面默认 http://127.0.0.1:3458# 启动服务 ccr ui没有桌面的服务器可以改用docker compose up -d --build起容器管理界面和网关共用 3458 端口。Step 3在供应商页添加供应商——选内置预设或自定义 API 地址填 API Key勾选至少一个模型点检测连通性确认 Key 和模型真实可调用然后保存。Step 4在API 密钥页创建 CCR 客户端密钥再到服务页点启动让模型网关开始监听 http://127.0.0.1:3456。Step 5验证网关存活# 健康检查返回 200 说明安装配置跑通 curl http://127.0.0.1:3456/health看到 200 之后网关就跑起来了下面把 Agent 接进来。完成最小可用配置CCR 的运行配置存在~/.claude-code-router/config.sqlite里由界面维护不要手动编辑。命令层面能跑通的最小区集就是验证加启动这两条# 网关健康检查 curl http://127.0.0.1:3456/health # 按配置名启动 Agent请求自动走网关 ccr Claude - Work三个配置项决定行为差异端口分工Agent 指向 3456 时请求命中的是模型网关指向 3458 打开的是管理面板拿不到模型响应。生效范围选仅从 CCR 打开时生效只影响从 CCR 启动的 Agent不碰你的全局配置改成系统默认则对所有项目生效建议试用稳定后再切换。凭据只填单条 API Key 时所有请求都走这一把展开凭据池后 CCR 按优先级选用某条 Key 触发rpm/tpm限额会被自动跳过。启动 Agent 并切换模型场景把 Claude Code 接到网关。在Agent 配置页添加 Claude Code 配置选一个模型留空则保留默认模型保存后用卡片上的终端按钮启动或在终端跑ccr Claude - Work。发一条消息能正常回复到日志页就能看到这条请求经过网关的记录。场景会话里切换模型。在 Agent 会话里输入/model查看 CCR 暴露的模型列表再用/model 供应商/模型直接切换。预期效果是后续请求立即改用新模型不用关会话、不用改任何配置文件。场景核对请求真实去向。打开日志页按模型或供应商筛选每条请求都能看到最终供应商、模型、状态码、耗时和 Token用来确认路由有没有按预期命中。用 Node.js 脚本写路由规则普通条件规则能覆盖Header/Body 满足 X 就改写模型的需求需要多字段判断或动态逻辑时在路由页把规则类型切到Node.js 脚本。脚本是异步函数体不需要写 import 或 module.exports直接用注入的input// 本地 .js 文件规则编辑器里选中它即可 if (input.body.model ! 供应商/原模型) { return null; // 不命中继续下一条规则 } return { model: 供应商/目标模型 };注意三点超时时间填 10–30000 毫秒脚本异常会 fail-open 继续匹配下一条规则不会把请求拦死编辑器里的测试请求 JSON可以不打真实上游先试跑一遍。规则的执行链路在 packages/core/src/routing/。排查高频报错现象装完找不到ccr命令 → 原因Node 版本低于 22或 npm 全局目录不在 PATH → 解决node --version确认版本npm prefix -g查全局路径并加入 PATH重开终端。现象管理 URL 端口不是 3458 → 原因首选端口被占用CCR 自动顺延 → 解决直接用 CCR 打印的实际 URL或停掉占用进程后重启。现象UI 能打开但网关不可用 → 原因供应商、模型或客户端密钥没配齐网关没起来 → 解决补完后从服务页启动网关用ccr serve看前台报错定位。现象Agent 请求没走 CCR → 原因Agent 不是从 CCR 启动的或配置未应用 → 解决用配置卡片的终端按钮启动 Agent确认配置已应用且作用范围覆盖当前项目。现象model not found→ 原因路由解析出的模型不在供应商模型列表里 → 解决对照供应商模型列表、路由规则、Agent 配置三处的模型名改到一致。CCR 把换模型从改一堆 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），仅供参考