先说结论#

CC Switch 适合这几类用户：

• 同时使用 Claude Code、Codex、Gemini CLI、OpenCode 等多个 AI 编程工具的人。
• 经常在官方 API、第三方 API、企业网关、本地模型之间切换的人。
• 不想手动编辑 settings.json、config.toml、.env 等配置文件的人。
• 有多个 MCP Server、提示词模板、Skills，需要跨工具同步的人。
• 想把配置备份、迁移、云同步做得更稳一点的人。
• 需要托盘快速切换、用量统计、本地代理和故障转移的人。

如果你只偶尔用一次 Claude Code，而且只有一个官方账号、一个默认配置，那 CC Switch 可能有点“功能过剩”。但只要你开始接入多个供应商，或者一台电脑上同时跑几种 AI CLI，它的价值会很快体现出来。

它到底解决了什么问题#

现代 AI 编程工具的配置方式并不统一。

Claude Code 有自己的配置逻辑，Codex 有自己的配置文件，Gemini CLI 又是另一套方式。再加上 MCP Server、系统提示词、Skills、代理地址、API Key、模型名、用量统计，最后就会变成一堆散落在不同目录里的配置文件。

手动维护不是不能用，但有几个明显问题：

1. 容易改错配置。
2. 切换供应商慢。
3. 多工具之间无法统一管理。
4. API Key 和配置备份不够直观。
5. 换设备时迁移成本高。
6. 出问题时很难快速定位是哪一层配置错了。

CC Switch 的思路是把这些复杂度收回来：用一个可视化界面管理多个 AI 编程工具，把常见供应商做成预设，把切换、同步、备份、代理、故障转移这些动作变成按钮和面板。

核心功能#

1. 供应商管理：一键切换不同 API 配置#

CC Switch 最核心的能力就是 Provider Management，也就是供应商管理。

你可以在里面给 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等工具添加不同供应商配置，比如官方登录、Anthropic/OpenAI/Google 相关接口、AWS Bedrock、NVIDIA NIM、社区中转服务、自建 New API 网关、本地模型网关等。

添加完成后，切换就不再需要手动改配置文件：

• 在主界面选中供应商，点击启用。
• 在系统托盘里直接点供应商名称快速切换。
• 对 Claude Code，官方说明目前支持供应商数据热切换，通常不需要重启终端。
• 对多数其他工具，切换后仍建议重启对应 CLI 或终端，让配置稳定生效。

这点对于经常比较模型效果的人很实用。比如同一个项目里，你可以快速在 Claude、Codex、Gemini、DeepSeek、Kimi、GLM、本地模型之间切换，观察速度、成本和代码质量差异。

MCP、Prompts、Skills：不只是切换 API#

如果 CC Switch 只做供应商切换，那它就是一个“配置切换器”。但它现在更像一个 AI CLI 工作台，因为它把 MCP、Prompts、Skills 也一起管起来了。

本地代理与故障转移#

CC Switch 还有一块更进阶的能力：Local Proxy，也就是本地代理。

它可以在本地做协议适配、格式转换和路由切换。比如某些工具只认特定 API 结构，而你手里是 OpenAI-compatible 接口，CC Switch 可以在中间做转换，让不同供应商更容易接入同一个工具。

同时，它还提供自动故障转移、熔断、健康检查等能力。对于长时间跑任务的人，这一点很重要：如果主供应商临时不可用，可以切到备用供应商，减少任务中断。

这类功能对普通轻度用户不是必需品，但对重度用户、团队环境、自建网关用户会很有价值。

会话和用量统计#

CC Switch 也在做会话与用量相关功能。

会话管理器可以浏览、搜索和恢复多个受管应用的对话历史。对于经常同时跑 Claude Code、Codex、Gemini CLI 的人，统一查看历史记录会比到处找目录舒服很多。

用量仪表盘则可以按供应商、模型、日期等维度查看请求、Token 和费用情况。尤其是接入多个供应商后，账单和用量很容易分散，统一面板能帮助你判断哪个模型更适合日常任务、哪个供应商成本更高、缓存命中是否正常。

v3.15.0 新变化#

截至我写这篇文章时，GitHub Releases 上的最新版本是 v3.15.0，发布时间是 2026-05-16。

这个版本比较值得关注，因为它把 Claude Desktop 提升成了一等受管对象。也就是说，CC Switch 不只管 Claude Code、Codex、Gemini CLI 这类命令行工具，也开始面向 Claude Desktop 做第三方供应商管理。

v3.15.0 里几个重点变化包括：

• 新增 Claude Desktop 管理面板。
• 支持通过应用内代理网关为 Claude Desktop 切换第三方供应商。
• 引入基于角色的模型映射，例如 sonnet、opus、haiku。
• 支持复用 Copilot / Codex OAuth 供应商。
• 增加 44 个 Claude Desktop 供应商预设。
• Codex OAuth 可以按需从 ChatGPT 后端获取实时模型列表。
• 用量仪表盘根据日期、供应商、模型筛选动态更新。
• 多项代理、Responses API、DeepSeek tool calls、DashScope 用量解析等稳定性修复。

如果你已经在用较旧版本，建议看看更新日志再升级，尤其是已经配置过代理和第三方供应商的人。

安装方式#

CC Switch 支持 Windows、macOS 和 Linux。

1
brew tap farion1231/ccswitch
2
brew install --cask cc-switch

1
brew upgrade --cask cc-switch

1
chmod +x CC-Switch-v{版本号}-Linux-*.AppImage
2
./CC-Switch-v{版本号}-Linux-*.AppImage

基础使用流程#

第一次使用可以按这个顺序来：

1. 安装并启动 CC Switch。
2. 在应用切换器里确认要管理的工具，比如 Claude Code、Codex、Gemini CLI。
3. 如果本机已有旧配置，先导入现有配置作为默认供应商。
4. 点击添加供应商，选择预设或自定义填写 API 地址、Key、模型名。
5. 在主界面点击启用，或从系统托盘快速切换。
6. 根据工具类型决定是否重启终端。Claude Code 通常支持热切换，其他工具建议重启后再测。
7. 打开 MCP、Prompts、Skills 面板，把常用扩展和提示词统一整理进去。
8. 如果多设备使用，可以把配置目录放到 iCloud、OneDrive、Dropbox、坚果云、NAS 或 WebDAV 这类同步环境里。

数据存在哪里#

官方 README 里说明，CC Switch 的主要数据默认放在 ~/.cc-switch/ 下：

• 数据库：~/.cc-switch/cc-switch.db
• 本地设置：~/.cc-switch/settings.json
• 配置备份：~/.cc-switch/backups/
• Skills：~/.cc-switch/skills/
• Skills 备份：~/.cc-switch/skill-backups/

它采用 SQLite 存储核心数据，并通过自动备份、原子写入等方式降低配置损坏风险。这个设计比“直接散落写一堆 JSON 文件”更稳，也更适合后续做同步和迁移。

使用建议#

CC Switch 很强，但它管理的是 API Key、供应商、代理和本地配置，所以使用时建议注意这几件事：

• 添加第三方供应商前，确认服务商是否可信。
• 不要把 API Key 随便截图、贴到公开 issue 或博客里。
• 切换供应商后，先跑一个小任务测试连通性，再跑长任务。
• 如果某个工具切换后没有立刻生效，先重启对应终端或 CLI。
• 开启云同步时，注意同步工具的冲突处理，避免多台设备同时改同一份配置。
• 团队共享配置时，不要把个人 API Key 一起导出给别人。

重点安全提醒：只认官方渠道#

这里必须单独提醒一下。

官方在 v3.15.0 Release 里明确说明：CC Switch 是完全免费、开源的桌面应用，官方不向用户收费。

官方渠道只认：

• 官网：https://ccswitch.io/zh/
• GitHub 仓库：https://github.com/farion1231/cc-switch
• Releases 下载：https://github.com/farion1231/cc-switch/releases

如果你在搜索引擎里看到某个“CC Switch”网站要求你充值、购买套餐、输入账号密码或提交登录凭据，务必提高警惕。它很可能不是官方项目。

简单判断标准：CC Switch 本体是配置管理工具，不是收费 API 平台。

和手写脚本相比，它的优势在哪里#

如果只是切换一个环境变量，写个 shell 脚本当然也能解决。但 CC Switch 的价值在于它把很多分散问题合到一起了：

所以它不是要取代所有脚本，而是适合那些已经有复杂 AI CLI 工作流的人，把“配置维护”这件事从日常开发里拿掉。

总结#

CC Switch 是一款很适合 AI 编程重度用户的开源工具。

它最打动我的地方不是“能切换供应商”这一点，而是它把 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes、Claude Desktop 这些工具背后的配置管理问题统一收拢了：供应商、模型、MCP、Prompts、Skills、会话、用量、代理、备份，都能在一个地方处理。

如果你现在还在手动改配置文件，或者经常因为切换模型、切换供应商、同步 MCP 而打断工作流，可以试试 CC Switch。它会让 AI 编程工具从“能用”变得更像一套可维护的个人开发环境。

项目地址#

• 官网：https://ccswitch.io/zh/
• GitHub：https://github.com/farion1231/cc-switch
• Releases：https://github.com/farion1231/cc-switch/releases
• 中文用户手册：https://github.com/farion1231/cc-switch/tree/main/docs/user-manual/zh