Skip to main content

CC Switch 是什么？

· 5 min read

AI Coding 工具越来越多，配置文件越来越乱——CC Switch 用一个 GUI把 Claude Code、Codex、Gemini CLI 等工具的 Provider、MCP Server、Skills 全管起来，一键切换，不用再手改 JSON。

  1. What：桌面应用，系统托盘常驻。50+ 内置 Provider 预设，一键盘切换 API 供应商，所有工具的配置自动同步。
  2. Why：Claude Code 一天切三次模型，Codex 用 Kimi，Gemini CLI 用 DeepSeek——三个工具三套配置，手动改早晚改出问题。
  3. How：Tauri 2 + React + Rust。本地 SQLite 存配置，内置代理做请求转发和自动故障转移。配置修改走原子写入，不会写到一半断电变砖。
  4. 隐藏能力：MCP 双向同步——在 CC Switch 加一个 MCP 服务，Claude Code 和 Codex 都能用。Skills 从 GitHub 一键安装，自动检测更新。
  5. 一句话记住：你不需要手动改 settings.json 了。

一个 GUI 管所有​

如果你同时用 Claude Code、Codex 和 Gemini CLI，你应该经历过这种体验：

Claude Code 要切个供应商，去 ~/.claude/settings.json 改。Codex 换模型，去另一个文件夹改 YAML。Gemini CLI 再换，又得改 GEMINI.md。一天下来，干的活还没改配置文件多。

CC Switch 把所有东西收进一个 GUI。

系统里常驻一个托盘图标，点开就是当前所有工具的 Provider、MCP Server、Skills 一览。从 Claude Code 切到 Codex 再切到 Gemini CLI，每个工具用哪个供应商，看一眼就知道。

切换呢，不是"选完、保存、重启终端"三步走，是托盘右键 → 点一下 → 继续干活。

到底解决了什么问题​

说白了就一句话：AI Coding 工具太多了，管起来烦。

Claude Code 是主力写代码的，但 Codex 处理某些任务更便宜，Gemini CLI 的长上下文又可以用来读大型仓库。三个工具各有各的好，但它们的配置完全独立——

  • Claude Code：~/.claude/settings.json 里写 env block
  • Codex：~/.codex/config.toml 里配 provider
  • Gemini CLI：~/.gemini/settings.json 里填 API key

你如果要三个工具都切换到同一个第三方 API 供应商（比如都走 DeepSeek），就得改三个文件，填三次 key，确认三遍 endpoint。错了任何一个，工具就报 401，你又要排查半天。

CC Switch 的解法：一次配置，到处生效。在它的面板里加一个 Provider，所有支持的工具自动更新配置。你用不着知道 Claude Code 的 env block 格式和 Codex 的 TOML 有什么区别，CC Switch 帮你翻译。

而且它的本地代理机制更进一步——你切供应商不用重启工具。代理在本地监听，工具永远连同一个 localhost 端口，代理再根据你在 CC Switch 里的选择把请求转发到不同上游。

内置代理：比一键切换更值钱的东西​

很多人把 CC Switch 当成"可视化配置编辑器"，这不完全对。

它更有价值的部分是本地代理（Local Proxy）。这个代理跑在本地，工具的所有 API 请求先经过它，再由它转发到真正的供应商服务器。中间多了一层，带来了三个好处：

  1. 自动故障转移：当前供应商挂了，代理自动切到备用。你甚至不会注意到——除非打开 CC Switch 看状态。
  2. 请求整流（Rectifier）：非官方 API 的 think signature 格式可能和官方不一致，代理层自动修正，不用你改任何东西。
  3. 用量统计：所有工具、所有供应商的 token 消耗、API 费用，代理层统一计，一个面板看全貌。

这对重度 AI Coding 用户很实用。我一个月切四五次供应商（新出个便宜的要试、某个供应商抽风了要切），每次切完最烦的不是配置，是不知道"花了多少钱"——每个供应商的计费页面不一样，查一轮十分钟。代理层统一统计直接解决了这个。

它不只是一个切换器​

CC Switch 还管 MCP Server 和 Skills。

MCP 配置在 Claude Code、Codex、Gemini CLI 之间是不互通的——你在 Claude Code 配了一个 Google Workspace MCP，Codex 里想用还得再配一遍。CC Switch 做了双向同步：在一个面板里加 MCP 服务，所有支持的工具自动注册。

Skills 也是。Claude Code 的 skill 放在项目 .claude/skills/ 目录里，CC Switch 内置了一个公共仓库浏览器，看到合适的 skill 一键安装，GitHub 上有更新还会提示。

这些能力才是它真正的定位：AI CLI 工具的"系统设置"。就像 macOS 的"系统偏好设置"不是某一个 App 的设置页，是所有 App 共享的底层配置——CC Switch 想做的事情一样。

References​

  1. CC Switch GitHub —— farion1231, 开源桌面应用
  2. CC-Switch Beginner Guide —— Apiyi.com
  3. CC Switch 新手指南：5 分钟掌握多 API 配置 —— Apiyi.com 中文版