最近这一年，AI 编码工具的竞争进入了白热化阶段。[[Claude Code]]、[[Gemini CLI]]、[[OpenAI Codex]]，每家都在拼命迭代，功能差距越来越小，价格战也越打越猛。于是我开始同时订阅好几个服务，针对不同的任务选用不同的工具——写复杂逻辑用 Claude，快速查文档用 Gemini，处理 Python 脚本用 Codex。
但问题随之而来：每次切换，我都要打开 ~/.config/ 下的各种配置文件，手动修改 API Key，重新指定默认命令，还要把 MCP 服务器的配置从一个工具迁移到另一个工具。这套操作做了几十次之后，我开始觉得这不是”使用多个工具”，而是”在维护多套配置文件”。
这就是 cc-switch 出现的原因。
在日常开发中，或多或少的可能遇到如下的痛点
- 频繁切换多个 API 供应商，官方，中转服务，每次都需要手动修改文件
- 配置分散，难以管理，Claude，Codex，Gemini，OpenCode，OpenClaw 各有独立的配置文件
- 无法监控使用量，不知道 API 调用的次数和数量
多工具并用的真实痛点
在聊 cc-switch 能做什么之前，我想先把痛点说清楚，因为只有真正踩过这些坑的人才会觉得它有价值。
第一个痛点是 API Key 管理混乱。每个工具都有自己存储 Key 的地方，有些放在环境变量里，有些放在 TOML 配置文件里，有些藏在工具自己的 config 目录下。一旦需要切换账号（比如从个人账号切到公司账号，或者切换到第三方代理），这些地方都要改一遍，漏改一处就会出现莫名其妙的认证错误。
第二个痛点是 [[MCP]] 服务器的重复配置。[[Model Context Protocol]] 是目前主流 AI 工具扩展能力的标准方式，我在 Claude Code 里配置了一堆 MCP 服务器之后，发现切换到 Gemini CLI 又要重新配置一遍，而且两边的配置格式还不完全一样。久而久之，两边的配置开始出现不一致，某些工具能用某个 MCP 服务，另一个工具却找不到。
第三个痛点是余额不透明。当你同时订阅了好几个 AI 服务，又对接了第三方代理，每个服务的用量和余额分散在不同的控制台里，根本无法一眼看出今天用了多少、还剩多少。
cc-switch 针对这三个痛点都给出了答案。
cc-switch 是什么
cc-switch 是一款面向开发者的 AI 编码 CLI 工具管理器，支持在 [[Claude Code]]、[[Gemini CLI]]、[[OpenAI Codex]]、[[OpenCode]] 等主流工具之间一键切换。它提供桌面端 GUI 版本和纯命令行版本（cc-switch-cli）两个选择，功能基本对等。
它的定位不是替代任何一个 AI 编码工具，而是作为这些工具上面的一层管理层，把散落各处的配置、密钥、模型选择和 MCP 服务器统一集中到一个地方。
核心功能解析
cc-switch 的功能设计非常务实，每一项都直接对应一个具体的痛点。
一键切换 AI 提供商是最核心的能力。打开 cc-switch，主界面会列出所有已安装的 AI CLI 工具，选择目标工具后，cc-switch 会自动完成背后的切换操作——修改系统默认命令指向、切换活跃的配置文件、更新环境变量。这个过程原本需要手动操作好几个地方，现在变成了一次点击。
统一的 MCP 服务器管理是我个人最看重的功能。通过 cc-switch，我只需要配置一次 MCP 服务器列表，它会负责把这份配置同步到所有已安装的 AI 工具中。这样不管我当前切换到哪个工具，都能使用同一套 MCP 扩展能力。
余额与额度的可视化展示也解决了我日常的困扰。cc-switch 支持直接读取官方 Claude、Gemini、Codex 的余额信息，同时也支持 Token Plan、[[Copilot]] 以及各类第三方代理 API 的余额查询，集中展示在一个界面里，省去了逐一登录控制台的麻烦。
此外，cc-switch 还内置了连接诊断工具，可以针对每个提供商做速度测试和流式响应健康检查，帮助快速定位”为什么这个工具今天特别慢”这类问题。对于 [[Claude Code]] 用户，它还支持管理 Skills 扩展插件，省去了手动维护 .claude/skills/ 目录的操作。
安装与使用
桌面版从 GitHub Releases 下载对应平台的安装包，双击安装即可，没有特别的前置依赖。
CLI 版本的安装方式：
npm install -g cc-switch-cli
或者直接用 npx 运行，不需要全局安装：
npx cc-switch-cli
启动后进入交互式界面，用方向键选择目标工具，回车确认即完成切换。第一次使用时会引导你添加各个工具的 API Key 和配置信息，之后就不需要再手动操作了。
MCP 服务器的配置也在同一个界面完成，添加一次之后 cc-switch 会自动同步到所有已注册的工具。
适合哪类开发者
cc-switch 对以下几类人最有价值：同时订阅了多个 AI 编码服务、需要根据任务特点选用不同工具的开发者；使用第三方代理（如 [[OpenRouter]]、各类国内中转 API）并且需要频繁切换 endpoint 的用户；以及对 AI 工具使用成本比较敏感、需要实时监控余额的场景。
如果你只用一个 AI 工具，并且没有多账号切换的需求，cc-switch 对你的价值就很有限了，这点需要说清楚。
潜在风险与注意事项
cc-switch 集中管理了所有 AI 工具的 API Key，这在带来便利的同时也意味着需要信任这个工具的安全实现。建议在使用前看一下它的源码，确认 Key 是本地存储而不是上传到任何服务器。
另一个需要关注的点是版本兼容性。cc-switch 依赖对各个 AI 工具配置文件格式的理解，一旦 Claude Code 或 Gemini CLI 更新了配置结构，cc-switch 可能会出现短暂的滞后期，这段时间内某些功能可能不可用。关注项目的 issue 和 release 页面是个好习惯。