CC Switch v3.16.1

最近 Vibe Coding（意念编程）风很大，大家是不是都在高强度使用各种 AI 编程命令行工具？比如 Claude Code、Gemini CLI 或者 OpenCode。好用确实好用，但你要是想换个 API 渠道，或者主线路限流了想切个备用模型，那叫一个折腾！

CC Switch 是一个专门为 AI 编程工具打造的开源统一管理可视化平台。你可以把它理解成 Claude Code、Codex、Gemini CLI 这些工具的“供应商切换器 + 配置管理面板 + MCP/Skills 管理器”。

产品功能

我按实际使用频率捋一下，哪些功能是真有用的：

1. 多应用统一管理

一个界面直接接管 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes Agent。你在一个地方配好 API，所有软件都能跟着联动。

2. Provider 管理（最常用的功能）

内置 50+ 家供应商预设，包括官方 Anthropic、OpenAI、Google，也有硅基流动、DeepSeek、智谱 GLM、MiniMax、Kimi、PackyCode 这些国内能直连的服务商。填个 API Key 就能一键导入，不用自己拼 Base URL。

3. 本地路由 + 协议翻译（这块是真硬核）

这是 CC Switch 区别于普通”配置切换器”的地方。v3.16.0 之后，它能做 OpenAI Responses API ↔ Chat Completions API 之间的协议转换。

什么意思？Codex 原生只认 Responses API，但国内大部分服务商（DeepSeek、Kimi、GLM、硅基流动）给的都是 Chat Completions 接口。以前你直接改 base_url 必报 404 或 400，现在 CC Switch 在本地 127.0.0.1:15721 起一个代理，请求进来先翻译成对方能懂的格式，回来再翻回 Codex 认识的格式，全程无感。

⚠️ 这意味着你可以在 Codex 里用 DeepSeek，也可以在 Claude Code 里用 GPT——模型和应用解绑了。

4. 自动故障转移 + 熔断

主供应商挂了自动切备用，连续失败 N 次触发熔断避免雪崩。对我这种把 AI 当主力生产力的人来说，这个比什么都重要。

5. MCP / Prompts / Skills 统一管理

配一次 MCP Server，可以同步到 Claude Code、Codex、Gemini CLI、OpenClaw 四个应用。Skills 支持从 GitHub 仓库一键安装，还能按应用单独开关。

6. 用量与成本追踪

Token 消耗、请求次数、缓存命中率、按模型和供应商拆分的费用统计——这些信息在多个 AI 编程 CLI 之间切换时尤为重要。

7. 云同步

配置目录可以指到 Dropbox / OneDrive / iCloud / WebDAV，换电脑不丢配置。

使用教程

如果你是第一次用，按这个流程 5 分钟能跑通：

第一步：下载安装

去 GitHub Releases 页面下载对应安装包：

• Windows 选 .msi（支持自动更新）
• macOS 推荐 brew tap farion1231/ccswitch && brew install --cask cc-switch
• Linux 根据发行版选 .deb/ .rpm/ AppImage

⚠️ Windows 安装时 SmartScreen 可能会拦你，点”更多信息→仍要运行”就行；macOS 首次打开要去”隐私与安全”里放行。

第二步：进设置，开插件接管

左上角齿轮 → 通用 → 把”应用到 Claude Code / Codex / Gemini CLI 插件”都打开。这一步不做，后面切供应商不会生效。

第三步：加供应商

主界面右上角 +→ 选预设（比如”DeepSeek””智谱 GLM””硅基流动”）→ 填 API Key → 保存。

第四步：启用

在供应商列表里点”启用”，Claude Code 立刻生效，Codex/Gemini 可能需要重启一次终端。

第五步（可选）：开路由

设置 → 高级 → 路由服务 → 把需要用到的应用路由开关打开。开了之后你能解锁故障转移、用量统计、热切换。

验证方式很简单，终端里敲 claude或 codex，发一句测试请求，能收到回复就算通了。