Claude Code Router：一个本地网关，管住你所有的 AI 模型调用

用 Claude Code、Codex 这类 AI 编程工具的人，大概都碰到过一个问题：每个工具各配各的 API Key，各连各的模型，改一次 provider 得跑好几个地方改配置。

Claude Code Router（CCR）干的就是把这层乱麻理清楚。它是一个本地运行的桌面网关，所有 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/zip，Windows 的 exe，Linux 的 AppImage。从 GitHub Releases 页面下载安装即可。

首次启动会自动创建配置文件，macOS/Linux 在 ~/.claude-code-router/config.json，Windows 在 %APPDATA%\Claude Code Router\config.json。

上手顺序：先加 provider，再配路由，然后启动网关，最后在 Profiles 里把 agent 工具的 profile 指过来。整个过程都在桌面 UI 里完成，不用手改 JSON。

CCR 启动后会跑两个本地服务：wrapper 网关在 3456 端口，核心网关运行时在 3457 端口。

适合谁用

同时用多个 AI 编程工具、需要在不同模型之间灵活切换的人。特别是手里有好几个 provider 的 API Key，想按场景、按成本、按能力分配模型的开发者。

如果你只用一个工具、一个 provider，CCR 的价值不大。但一旦 agent 工具多了、provider 多了，手动管配置就是个负担。CCR 把这层管理收拢到一个地方，改起来方便，看用量也清楚。

。但一旦 agent 工具多了、provider 多了，手动管配置就是个负担。CCR 把这层管理收拢到一个地方，改起来方便，看用量也清楚。