用 Claude Code、Codex、Gemini CLI 这些 AI 编程工具，最烦的是什么？不是写代码，是切 API。官方 API 额度用完了要换中转站，中转站挂了要切备用，每次都要手动改配置文件，改错了还报错。
今天五哥介绍一个神器——CC Switch，一个桌面工具，一键切换 API 提供商，再也不用手动改 JSON 配置了。
CC Switch 是什么？
CC Switch 是由开发者 farion1231 构建的开源桌面工具，核心解决的是"AI 编程工具 API 切换"的痛点。它提供一个统一的图形界面，让你可以：
- 一键切换 Provider：保存多套 API 配置，点一下即可切换
- 多应用统一管理：同时管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五款工具
- 本地 API 代理：内置高性能 HTTP 代理，支持自动故障转移
- MCP 服务器管理：可视化添加、编辑 MCP 服务器配置
- 用量统计：实时查看 Token 消耗与 API 费用
- 备份与恢复：自动备份配置，防止误操作
支持管理的应用
- 🤖 Claude Code（Anthropic）
- ⚡ Codex（OpenAI）
- ✨ Gemini CLI（Google）
- 🧩 OpenCode（开源）
- 🦅 OpenClaw
安装教程
前往 GitHub Releases 下载对应平台的安装包：https://github.com/farion1231/cc-switch/releases/latest
Windows
- 推荐：CC-Switch-vX.X.X-Windows.msi（MSI 安装包，支持自动更新）
- 便携版：CC-Switch-vX.X.X-Windows-Portable.zip（解压即用）
macOS
方式一：下载 zip 解压后将 CC Switch.app 拖入应用程序文件夹。首次启动右键→打开，或去「系统设置→隐私与安全性→仍要打开」。
方式二：Homebrew 安装（推荐）
# 添加 tap 并安装
brew tap farion1231/ccswitch
brew install --cask cc-switch
# 更新
brew upgrade --cask cc-switchLinux
根据发行版选择：
- Ubuntu/Debian/Mint：
sudo apt install ./CC-Switch-*.deb - Fedora/RHEL/Rocky：
sudo dnf install ./CC-Switch-*.rpm - openSUSE：
sudo zypper install ./CC-Switch-*.rpm - Arch/其他：下载 .AppImage，
chmod +x后直接运行
快速上手
第一步：启动 CC Switch
首次启动会自动检测已安装的 CLI 工具并导入现有配置。系统托盘会出现 CC Switch 图标。
第二步：选择要管理的应用
主界面顶部是应用切换栏，点击对应图标（Claude Code / Codex / Gemini CLI 等）即可切换。可以在设置中隐藏不需要的应用。
第三步：添加 Provider
点击右上角的 +，从内置预设中选择（如 Anthropic API、DeepSeek、阿里百炼等），或手动填写：
- 名称：便于区分的备注名
- API Key：服务商提供的密钥
- Base URL（可选）：自定义代理地址
- 模型：指定默认使用的模型
- API 格式：Anthropic Messages 原生格式 或 OpenAI Chat Completions 兼容格式
第四步：一键切换
在列表中点击目标 Provider，再点击「启用」。CC Switch 会自动将配置写入对应 CLI 工具的配置文件。终端直接运行 claude 或 codex 时就会使用新配置。
第五步：验证配置
点击 Provider 旁的「健康检查」按钮，发送测试请求验证 API Key 和网络连通性。
进阶功能
MCP 服务器管理
在「MCP」面板中可视化管理 MCP 服务器，配置自动同步到对应 CLI 工具，支持从已安装应用一键导入。
Skills 管理
支持从 GitHub 仓库或本地 ZIP 安装 Skills，管理 Claude Code 和 Codex 的提示词增强功能。内置 baoyu-skills 等预设仓库。
会话管理器
在「会话」页面浏览全部五个应用的历史对话记录，支持目录导航和会话内搜索。
用量统计
「用量」页面展示 Token 消耗统计，支持缓存命中率分析，按模型和 Provider 分类查看费用，帮你掌控 API 开支。
WebDAV 同步
支持将数据库同步到 WebDAV 服务（如坚果云），实现多设备间配置共享。
Claude Rectifier（思考签名修复）
使用第三方 API 网关时，Claude 的 thinking block 格式可能不兼容。开启 Rectifier 后，代理层会自动修复此问题。
总结
CC Switch 解决的核心问题就是"API 配置管理"。对于同时使用多个 AI 编程工具的开发者来说，它能省掉大量手动改配置的时间，一键切换 Provider，还能统一管理 MCP 服务器和 Skills。
如果你经常在 Claude Code、Codex、Gemini CLI 之间切换使用，CC Switch 基本就是必备工具了。