文章目录Claude Code Router一个本地网关管住你所有的 AI 模型调用它解决什么问题桌面 UI 长什么样路由规则的具体玩法插件和扩展安装和上手适合谁用Claude Code Router一个本地网关管住你所有的 AI 模型调用用 Claude Code、Codex 这类 AI 编程工具的人大概都碰到过一个问题每个工具各配各的 API Key各连各的模型改一次 provider 得跑好几个地方改配置。Claude Code RouterCCR干的就是把这层乱麻理清楚。它是一个本地运行的桌面网关所有 agent 请求都走它由它决定转发给哪个模型 provider。35K 多 Star说明有这个痛点的人不少。它解决什么问题CCR 的核心逻辑很简单在你机器上起一个本地网关监听http://127.0.0.1:3456所有 agent 工具的请求都发到这里由 CCR 根据你设好的路由规则转发到实际的模型 provider。这样做有几个直接好处第一不用每个工具单独配 provider。Claude Code、Codex、ZCode包括其他兼容的客户端统一指向 CCR 就行。第二不同任务可以走不同模型。后台跑的轻量任务用便宜快速的模型需要深度推理的换强模型长上下文的换支持大窗口的图片任务换多模态的。每种场景单独配路由规则互不干扰。第三换 provider 不用改工作流。CCR 支持的协议和 provider 很多OpenAI 兼容接口、Anthropic Messages、Gemini Generate Content、OpenRouter、DeepSeek、SiliconFlow、Moonshot、Mistral、Z.AI、百炼以及自定义 provider。加一个 provider 只是在 CCR 的 UI 里填个表单agent 工具那边完全不用动。桌面 UI 长什么样CCR 是 Electron 应用装完打开就是一个桌面面板。主要几个模块Providers负责管理模型来源。可以选内置 preset 快速添加也可以手动填 endpoint、协议、API Key、模型列表。填完能测连通性确认没问题再保存。Routing负责路由规则。默认路由、后台任务、推理请求、长上下文、图片、网页搜索、子 agent每种场景都可以指定不同的 provider 和 model。还支持 model-prefix 路由、条件路由、fallback 等进阶用法。Server控制网关启停支持开机自启。Profiles管理 agent 配置。Claude Code、Codex、ZCode 的 profile 都在这里配置选好目标模型apply 就生效。Dashboard看用量和 provider 健康状态Network Logs 调试请求行为。路由规则的具体玩法路由是 CCR 最核心的能力。除了前面说的按场景分发它还支持API Key 轮换同一个 provider 配多个 Key请求自动轮转单个 Key 限流了也不怕。Fallback 路由主 provider 挂了自动切到备选。虚拟模型给客户端暴露一个别名背后可以是任意 provider 的任意模型。客户端以为自己在调 “gpt-4”实际走的是你指定的 DeepSeek。插件和扩展CCR 有两层插件体系。一层是核心网关插件管 provider 插件和虚拟模型 profile。另一层是 wrapper 插件可以注册本地 HTTP 后端、添加网关路由、拦截代理流量。插件模块导出一个setup(ctx)函数ctx 上挂着注册路由、注册后端、打开 SQLite 存储等方法。项目仓库里有 examples/plugins 目录照着写就行。还有一个有意思的功能是 Provider Deeplink。provider 的网站可以通过ccr://provider?...这种自定义协议链接一键把配置导入 CCR用户确认后自动写入。对 provider 来说是个不错的分发手段。安装和上手三个平台都有包macOS 的 dmg/zipWindows 的 exeLinux 的 AppImage。从 GitHub Releases 页面下载安装即可。首次启动会自动创建配置文件macOS/Linux 在~/.claude-code-router/config.jsonWindows 在%APPDATA%\Claude Code Router\config.json。上手顺序先加 provider再配路由然后启动网关最后在 Profiles 里把 agent 工具的 profile 指过来。整个过程都在桌面 UI 里完成不用手改 JSON。CCR 启动后会跑两个本地服务wrapper 网关在 3456 端口核心网关运行时在 3457 端口。适合谁用同时用多个 AI 编程工具、需要在不同模型之间灵活切换的人。特别是手里有好几个 provider 的 API Key想按场景、按成本、按能力分配模型的开发者。如果你只用一个工具、一个 providerCCR 的价值不大。但一旦 agent 工具多了、provider 多了手动管配置就是个负担。CCR 把这层管理收拢到一个地方改起来方便看用量也清楚。。但一旦 agent 工具多了、provider 多了手动管配置就是个负担。CCR 把这层管理收拢到一个地方改起来方便看用量也清楚。
