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同一个仓库里你上午用 Claude Code 写功能下午切到 Codex 跑重构晚上又用 Kimi CLI 处理文档。每个 Agent 都要自己配 API 地址和 Key换一个模型就要改一遍配置供应商限流时还得手动切换。Claude Code RouterCCR的做法是在本机架一个模型路由网关所有 Agent 只对接一个本地端口请求由它转发给背后任意供应商路由规则、重试、降级、用量记录都在同一个面板里完成。项目定位一个端口管住所有编程AgentCCR 是一个本地模型网关兼控制平面。对外的价值可以压缩成一句话让 Claude Code、Codex、Grok CLI、Kimi CLI、OpenCode 等编程 Agent 共用同一个稳定入口供应商、模型、账号、路由规则与工具扩展全部集中管理。你不需要为每个客户端维护一套独立配置换供应商或换模型时不动 Agent 侧的任何设置。想跑通最小闭环不需要编译也不需要桌面端安装包。最小上手路径两条命令加一个本地模型先拿到源码git clone https://gitcode.com/GitHub_Trending/cl/claude-code-router cd claude-code-router装好依赖后启动服务也可以直接全局安装 CLI 版要求 Node.js 22 及以上再打开管理界面npm install -g musistudio/claude-code-router ccr ui启动后模型网关默认监听http://127.0.0.1:3456浏览器里的管理界面则运行在 3458 端口。界面是左右双栏左侧列供应商右侧写路由规则保存后立即生效。跑通入口之后下面两个功能是你最应该先配置的。亮点功能拆解 智能路由按任务类型分配模型CCR 的路由面板把常用档位拆成四档Default默认模型、Background后台任务、Think思考任务、Long Context长上下文每档都可以绑定不同供应商的模型长上下文档还能设置 Context Threshold当上下文超过指定 token 数时自动换档。具体做法日常补全交给 Ollama 上的本地模型架构分析和复杂推理留在云端旗舰模型超过 6 万 token 的长会话自动切到长窗口模型。最需要的用户是把多个 Agent 混着用、同时接了云和本地两套模型的开发者——任务分档一次配好之后不用手动切换。 本地模型一键接入Ollama 进路由想省 API 费用的第一步是把 Ollama 挂进来。在管理界面的 Providers 区点击添加选择自定义端点按下面格式填配置即可{ name: ollama, api_base_url: http://localhost:11434/v1/chat/completions, api_format: openai, models: [qwen2.5-coder:latest, codellama:latest] }保存后这些模型会出现在模型目录里可以被任意路由档位引用。云端与本地模型从此在同一张路由表里调度高频简单任务走本地关键任务走云端。 请求级可观测性每次调用都有账CCR 的日志面板逐条记录每个请求的最终供应商、模型、状态、耗时、输入输出 Token 与成本估算出错的请求能看到完整错误现场。排障、对账、估算月成本都从这一页开始而不是翻散落在各 Agent 里的零散输出。进阶与调优团队分工和成本策略路由配好之后两个方向值得花时间团队内按角色分档。新人默认路由到低价模型练手资深工程师的复杂任务走旗舰模型文档类任务统一进长上下文档位。每个人的 Agent 配置可以不同但供应商和路由规则集中在管理端统一维护。成本侧做减法。把高频简单任务固定到本地或低价模型只让关键推理走高价模型。概览页会持续显示请求数、输入输出 Token、缓存命中比例和成本估算——参考运行数据概览页可以实时看到 379 次请求、2M 输入 token、8.67 美元的估算成本。省没省下来用数字说话。两个常见卡点。本地模型连不上时先确认 Ollama 服务在运行用ollama ps看模型是否已加载再核对 CCR 里填的地址与端口是否一致。云端限流时给供应商配上凭据池或 Key 轮换再挂一条 Fallback 规则主模型不可用时请求自动切到备用模型日志里能查到每一次切换的原因。更多细节可以看 路由规则文档网关与路由的实现入口在 packages/core/src/gateway/。一句话收尾Claude Code Router 把多套 Agent 的模型调用收敛到一个本地网关你负责写代码模型选择、故障兜底和成本记录交给 CCR。下一步很简单——装上它接入一个 Ollama 模型把后台任务的默认路由指过去从最便宜的那条规则开始省。【免费下载链接】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），仅供参考