经常使用 Claude Code、Codex、Gemini CLI 这类 AI 编程工具，一定遇到过这样的情况：换了不同的 API 提供商，就得手动修改配置文件，改错了还得排查半天。CC Switch 就是专门解决这个痛点的桌面端统一管理工具。
CC Switch 是一个跨平台的桌面应用，它用图形界面的方式统一管理多款 AI 编程 CLI 工具的供应商配置、API 路由、MCP 服务器、Skills 插件、历史会话和用量统计。你不需要再对着 JSON 配置文件发愁了，点几下鼠标就能完成切换。
目前 CC Switch 支持的应用包括 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes Agent 共 7 款主流工具。无论你是用 Anthropic 官方 API，还是通过国内镜像或第三方代理接入，都可以在 CC Switch 里统一配置和管理。
当前最新版本为 CC Switch v3.16.3，该版本持续优化了本地代理的稳定性，新增了对更多 API 格式的兼容支持，改进了 MCP 服务器管理的界面交互，并修复了多个已知问题。新版本还引入了更完善的 Skills 管理功能，支持从 GitHub 仓库安装 Skills 插件。
CC Switch安装
CC Switch安装包下载：CC Switch安装包（源自GitHub，长期维护，放心使用）
Windows选择.msi文件（推荐，支持自动更新）或.zip便携版，macOS选择.zip文件，Linux根据发行版选择.deb、.rpm或.AppImage格式。
1) Windows平台安装
下载.msi文件后双击启动，按照安装向导依次点击下一步：
默认安装到 C 盘，这里建议安装到其他盘，然后点击 Next：
等待安装完成即可：
如果不想写注册表，下载Portable便携版，解压后直接运行exe文件：
需要注意的是，Windows版本已禁用"一键安装"功能，如果需要安装Claude Code等工具，请手动安装后再通过CC Switch来管理。
2) macOS平台安装
下载 .dmg 文件后双击打开，将CC Switch.app拖入「应用程序」文件夹。首次启动时会提示"未知开发者"，因为作者没有Apple开发者账号，这是正常情况。关闭提示后，前往系统设置 → 隐私与安全性，点击「仍要打开」即可正常使用。
也可以使用Homebrew安装：brew tap farion1231/ccswitch + brew install --cask CC Switch。
3) Linux平台安装
Ubuntu/Debian/Mint用户下载.deb文件，执行sudo apt install ./CC Switch-*.deb。
Fedora/RHEL用户下载.rpm文件，执行sudo dnf install ./CC Switch-*.rpm。
其他发行版可以直接下载.AppImage文件，加执行权限后运行即可：
chmod +x CC-Switch-*.AppImage
./CC-Switch-*.AppImage
CC Switch基础使用
安装完成后首次启动，CC Switch会自动检测已安装的CLI工具并尝试导入现有配置，系统托盘中会出现CC Switch的图标。
1）选择要管理的应用
启动 CC Switch 后，主界面顶部有一个应用切换栏。这里会列出你已安装的 CLI 工具图标——Claude Code、Codex、Gemini CLI 等，点击对应的图标即可切换到该工具的配置管理界面。你也可以在设置中隐藏不需要的应用，让界面更清爽。
2）添加Provider
每个应用都需要配置 API 提供商。点击右上角的"+"按钮，你可以从内置预设中选择（比如官方 Anthropic API、DeepSeek、阿里百炼等），也可以手动填写。
填写的内容包括：名称（方便区分）、API Key（服务商提供的密钥）、Base URL（自定义代理地址）、模型（默认使用的模型名称）和 API 格式（Anthropic Messages 原生格式或 OpenAI Chat Completions 兼容格式）。
3）切换Provider
在列表中点击目标 Provider，再点击"启用"按钮，CC Switch 会自动将配置写入对应 CLI 工具的配置文件。之后你在终端直接运行 claude 或 codex 命令时，就会自动使用新配置了。
4）健康检查
每个 Provider 旁边都有"健康检查"按钮，点击后 CC Switch 会发送一个测试请求，验证 API Key 是否有效以及网络是否通畅。这个功能在更换 API 提供商后非常实用，几秒钟就能确认配置是否正常。
配置正常的话，CC Switch 会给出“运行正常”的提示：
5) MCP服务器管理
MCP（Model Context Protocol）服务器是Claude Code等工具用来扩展能力的接口。
在"MCP"面板中，你可以可视化地添加、编辑和删除 MCP 服务器配置。配置会同步到对应的 CLI 工具中，也可以从已有的应用中一键导入现有的 MCP 配置。
CC Switch常见使用问题
添加 Provider 后无法正常连接，这时可以先检查 API Key 是否正确填写，再确认网络环境是否能正常访问对应的 API 服务。如果使用自定义 Base URL，要确保地址格式正确且以 /v1/ 结尾。使用"健康检查"功能是排查连接问题最快的方式。
如果你切换 Provider 后发现 CLI 工具没有生效，可能是因为配置文件没有被正确覆盖。可以在 CC Switch 的"设置"中检查配置文件路径是否正确，也可以尝试重新启用目标 Provider。对于 Claude Code 来说，首次使用可能需要手动在终端执行 claude 命令进行一次初始化操作。
Windows 版 CC Switch 默认禁用了"一键安装"功能，这是为了避免协议处理器带来的副作用。如果你需要安装 Claude Code 等工具，请手动下载安装后，再通过 CC Switch 来管理它们的配置。这个限制只影响 Windows 平台。
