cc-switch 本地路由：让 GPT 跑进 Claude Code

手改配置文件切换供应商这件事，用 AI 编码工具多的同行都懂，烦得很。Claude Code 改 settings.json，Codex 改 config.toml，Gemini CLI 改 .env，三套格式、三个路径，切一次供应商要在文件之间来回横跳，改错一个引号直接启动报错。

今天我把 farion1231/cc-switch 认真拆了一遍。GitHub API 实测 137,199 Star / 9,338 Fork，MIT 协议，Rust 写的，去年 8 月创建，一年出头冲到 137k，已迭代到 v3.20.4，维护活跃。

先说结论：它把"AI 编码工具的配置管理"从手改文件变成了切卡片，本地路由那一层是真正有技术含量的部分。

一句话定位

cc-switch 是一个跨平台桌面 App（Windows / macOS / Linux，Tauri 2 框架），把 10 个 AI 编码工具的 API 供应商切换、MCP、Skills、Prompts 管理收进一个界面。和手动改配置的最大区别：选预设、填 Key、点一下就完成切换，配置文件的读写、格式、原子性它全包了。

三个核心亮点

能力层面：一个 App 管 10 个工具。 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code 全在支持列表里。README 里有一张逐工具的功能矩阵：哪些支持本地路由、哪些支持 MCP/Skills 同步、Prompts 写进哪个文件，标得清清楚楚。

配置层面：90+ 供应商预设免手改。 DeepSeek、智谱 GLM、Kimi、MiniMax、通义、AWS Bedrock、NVIDIA NIM 都有现成预设，请求地址预填好，只需填 API Key。看官方截图：

架构层面：本地路由做协议转换。 这是全项目最有含金量的部分，等下单独拆。

本地路由怎么让 GPT 跑进 Claude Code

旧方案的困境：每家工具只认自家 API 格式。Claude Code 说 Anthropic 方言，Codex 说 OpenAI 方言，想让 Claude Code 用 GPT 的供应商，过去只能靠第三方中转服务——请求出本机、走别人的服务器。

cc-switch 的思路是在本机起一个路由进程：默认监听 127.0.0.1:15721，把工具发出的请求在 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses、Gemini generateContent 四种格式之间本地转换，再转发给目标供应商。请求不出本机就完成协议翻译。

路由层还带三件套：

故障转移：配置一个供应商队列，请求失败自动切下一个，带熔断器和健康监控——某个供应商抽风不至于卡死你的工作流。

整流器：自动修复上游不接受的请求，比如 Thinking 签名不兼容、图片不支持时自动回退，省去手动排查。

用量仪表盘：自动扫描各工具的本地会话日志，按供应商和模型统计请求数、token、缓存命中率、花费；订阅配额（Claude、ChatGPT、Gemini）和账户余额直接显示在供应商卡片和托盘上。按模型自定义价格，或从 models.dev 导入价目。

一句话总结架构：把协议差异从"人工翻译"变成"本地路由自动转"，把供应商状态从"黑盒"变成"卡片上的数字"。

快速上手

三步跑通：

1. 从官网 ccswitch.io 或 GitHub Releases 下载安装包
   系统要求：Windows 10+ / macOS 12+ / Ubuntu 22.04+ 等 glibc 2.35+ 发行版
2. 打开 App，选工具标签页，点添加供应商：选预设、填 API Key
3. 点卡片切换，回终端正常用你的工具，配置已自动写入

需要注意的两个细节：

• 托盘常驻，右键即可切换供应商，不用打开主窗口
• 数据存在 ~/.cc-switch，SQLite 存储 + 原子写入 + 自动备份（每 24 小时一份，保留最近 10 份），改坏了能回滚

企业团队落地方案

1）团队改造思路。 把"每人自己搜文档改配置"收敛成"统一入口配供应商"。新人入职装一个 cc-switch，导入团队配置模板就能对齐环境，省掉半天环境调试。

2）部署方案。 供应商配置支持导出/导入，也支持 ccswitch:// Deep Link 一键导入——团队把标准配置放进内部 Wiki，点链接即生效。跨设备同步走 WebDAV（坚果云、Nextcloud、群晖 NAS）或 S3 兼容存储（AWS S3、Cloudflare R2、阿里云 OSS、腾讯云 COS）。

3）成本集成。 用量仪表盘按供应商、模型归集花费，做团队的 AI 用量报表足够用；"关于"页可以统一查看和升级各 CLI 工具版本，避免成员版本漂移。

4）团队规范定制。 Prompts 库按工具管理，启用后自动写入 CLAUDE.md / AGENTS.md / GEMINI.md——团队编码规范、提交规范沉淀成 prompt 模板统一下发，比在群里发文档再人肉粘贴可靠。Skills 支持从 GitHub 仓库或 ZIP 一键安装、批量同步到各工具。

真实适用场景

• 同时用 Claude Code + Codex + Gemini CLI 的多工具开发者——一处配置，处处生效
• 频繁切换官方/国产供应商的人——预设 + 托盘切换，告别手改 JSON
• 关注 token 成本的团队——用量仪表盘按模型归集花费
• 想在 Claude Code 里用 GPT/DeepSeek 的人——本地路由做格式转换，无需第三方中转

优缺点与避坑

优势：一个 App 管 10 个工具、90+ 预设、本地路由跨格式转换、MIT 开源、三平台、文档极完善（含多语言完整用户手册）。

局限：README 赞助区被大量第三方 API 中转服务的广告占据，选择时需要自己甄别；本地路由配合中转服务的用法，在合规上属于灰色地带——官方 OAuth 认证中心的说明原话是"在官方客户端外使用订阅可能违反供应商服务条款，风险自负"；用第三方中转意味着 API Key 要经过中转方，存在泄露面。功能繁多，上手有认知成本；RHEL/Rocky/Alma 暂不在支持列表。

避坑：

• 用第三方中转时，开独立子 Key、设消费上限，别把主力 Key 交出去
• 涉及公司代码和敏感数据，优先走官方 API 或自建网关，别把生产代码跑在来路不明的中转上
• 认准唯一官网 ccswitch.io（README 特意强调 Only official website），防仿冒站点钓鱼

写在最后

AI 编码工具越来越多，配置管理这个"配套脏活"终于有人认真做了。cc-switch 的价值不只是省时间——本地路由那一层把协议转换做成了本机基础设施，这个思路比"切换器"三个字值钱。合规则要自己把关：工具是中性的，Key 交给谁、代码跑在哪条链路上，装之前想清楚。

开源地址：https://github.com/farion1231/cc-switch

如果你也在同时管理多个 AI 编码工具的配置，不妨在云栈社区分享你的切换方案，或者聊聊本地路由在实际项目中踩过的坑。