CC Switch：Claude Code、Codex 与 Gemini CLI 的可视化服务商管理器

如果你同时使用多个 AI 编程 CLI，或者在同一个 CLI 背后挂了多个模型服务商，应该体会过这种摩擦：每个工具的配置位置和格式都不一样。Claude Code 读取一个 settings 文件，Codex 用它自己的配置，服务商路由通常又要靠手工改环境变量或 JSON。从一个后端切到另一个后端是一件琐碎、重复又容易出错的事，一个逗号放错就可能让整套配置失效。

CC Switch 是一款开源桌面应用，它把这件琐事变成一次点击。这篇文章讲清楚它能做什么、内部如何工作、什么时候值得用，以及在把 API Key 交给它之前需要注意什么。

一、CC Switch 是什么

CC Switch 是一款跨平台桌面应用，用一个可视化界面集中管理多个 AI 编程 CLI 的服务商配置。根据它的 GitHub 仓库和官方网站，它支持五个命令行工具：Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw。

该项目以 MIT 许可证开源，基于 Tauri 2 构建，后端用 Rust，前端用 React 加 TypeScript，并提供 Windows、macOS 和 Linux 的原生安装包。唯一的官方网站是 ccswitch.io；因为这是一个会接触 API 凭据的工具，对仿冒域名和非官方构建要保持警惕。

它的核心思路很克制也很实用：不再为了切换服务商去改配置文件，而是把服务商导入一次，然后从列表或系统托盘里切换。

二、它解决的问题

如今的 AI 辅助编程依赖终端工具，而每个工具都定义了自己的配置格式。Claude Code 用 JSON，Codex 用自己的文件，其它工具用 TOML 或环境变量。如果你保留了多个服务商，比如一个官方订阅加上一两个中转服务，你最终就要维护每份配置的多个版本，并手工来回替换。

除了服务商密钥，还有第二层割裂：MCP 服务、系统提示词和技能在每个工具里都要单独配置，没有内建的办法在 Claude Code、Codex 和 Gemini CLI 之间保持一致。

CC Switch 同时解决这两点。它集中管理服务商定义，并为 MCP、提示词和技能提供统一面板，让同一套配置能应用到多个工具，而不必手工复制。关于服务商路由对国内开发者为什么重要，可以参考我们的配套指南：在 Claude Code 中接入中国大模型。

三、核心功能

服务商切换。 CC Switch 内置 50 多个服务商预设，既有 AWS Bedrock、NVIDIA NIM 这类选项，也有社区中转服务。你复制密钥、导入预设，一键切换。系统托盘菜单让你不必打开完整应用就能换服务商，服务商还支持排序、导入和导出。

统一的 MCP、提示词与技能。 一个 MCP 面板跨多个应用管理服务，支持双向同步和 Deep Link 导入。提示词用 Markdown 编辑，并同步到每个工具实际读取的文件，比如 CLAUDE.md、AGENTS.md 和 GEMINI.md。技能可以从 GitHub 仓库或 ZIP 一键安装。

本地代理与故障转移。 可选的本地代理模式支持热切换、服务商 API 之间的格式转换、自动故障转移、熔断器和服务商健康监控。

用量与成本追踪。 一个仪表盘追踪花费、请求数和 token，带趋势图和按模型自定义价格。

会话、同步与体验细节。 它能浏览并恢复跨工具的对话历史，通过 Dropbox、OneDrive、iCloud 或 WebDAV 服务器在多设备间同步配置，并通过 ccswitch:// Deep Link 导入服务商、MCP 服务、提示词和技能。它还提供明暗主题、开机自启和自动更新。

四、内部如何工作

CC Switch 采用单一数据源（SSOT）设计。根据项目文档，所有可同步的数据都存放在 SQLite 数据库 ~/.cc-switch/cc-switch.db 中，而设备级的界面偏好放在 ~/.cc-switch/settings.json。自动备份位于 ~/.cc-switch/backups/，仅保留最近的十份。

切换是一次双向同步。当你启用某个服务商时，CC Switch 会把配置写入 CLI 实际读取的实时文件；当你编辑当前激活的服务商时，它会从这些实时文件回填改动，让数据库保持准确。写入采用「临时文件加重命名」的方式，因此即使保存被中断也不会损坏配置，数据库连接还用互斥锁保护以避免竞态。

有个细节对日常使用很关键：大多数工具在切换服务商后需要重启终端或 CLI 才能生效，但项目说明 Claude Code 目前支持热切换服务商数据而无需重启。

它的设计还遵循「最小侵入」原则。因为 CC Switch 写的是标准配置文件，而不是劫持工具，所以即使你卸载它，CLI 仍能正常工作。应用会刻意始终保留一个激活的服务商，这也是为什么它不允许你删除当前启用的那个。

五、安装

系统要求为 Windows 10 及以上、macOS 12（Monterey）及以上，以及主流 Linux 发行版，比如 Ubuntu 22.04+、Debian 11+ 或 Fedora 34+。

在 macOS 上，最简单的方式是用 Homebrew：

brew install --cask cc-switch

macOS 版本经过 Apple 的代码签名和公证，可以直接安装。在 Windows 上，从 Releases 页面下载 .msi 安装包或便携版 .zip。在 Linux 上，选择 .deb、.rpm 或 .AppImage 构建；Arch 用户可以通过 paru 安装 cc-switch-bin。

首次启动时，你可以把已有的 CLI 配置导入为默认服务商，这样就不必从空白开始。

六、实用的上手流程

从小处开始，先验证再依赖。把你已经在用的一个服务商加为默认，再加一个想对比的服务商，然后在两者间切换，确认每个 CLI 的表现符合预期。

对 Claude Code，得益于热切换，你可以切换服务商并继续工作。对 Codex、Gemini CLI 和其它工具，切换后请重启终端。想回到厂商的正常账号流程时，使用官方登录预设；切换到它之后，运行该工具的登录或 OAuth 流程。

当服务商切换稳定可靠后，再叠加其余功能：把 MCP 服务纳入统一面板，把共享提示词移到 Markdown 编辑器里让 CLAUDE.md 和 AGENTS.md 保持一致，并安装你在多个工具间复用的技能。

七、什么时候该用，什么时候未必需要

当你经常在多个服务商或多个 CLI 之间切换、想让 MCP 和技能在工具间保持一致、或者想要托盘级切换和用量追踪而又不想自己写脚本时，CC Switch 就很有价值。

如果你只用一个 CLI、一个服务商且从不更换，它的价值就小一些。如果你更偏好完全脚本化、纳入版本控制的环境配置，那么一份提交进仓库的 shell profile 或按项目的环境文件可能更合适。CC Switch 是一个便利和管理层，而不是这些工具运行的必要条件。

八、安全与运维注意事项

这是一个会保存 API 凭据的工具，请用对待任何密钥管理器的谨慎来对待它。

只从官方网站或项目的 GitHub Releases 下载。因为服务商和密钥都存在本地 SQLite 数据库里，任何能访问你机器和那个文件的人，实际上就拿到了你的密钥；要相应地保护好设备，并在把该数据库同步到第三方云盘之前慎重考虑。

让凭据远离你的代码仓库。服务商密钥应放在 CC Switch、你的 shell 环境或密钥管理器里，绝不要提交进 git。如果你启用了本地代理，要清楚请求会经它路由，并确认故障转移目标是你真正信任的服务商。

一如既往，切换层改变的是「哪个模型来回答」，而不是「答案是否正确」。请审阅 diff、运行项目的检查，并对任何涉及认证、支付、数据库迁移或发布的改动保留人工审批关口。

结语

CC Switch 针对一个真实的烦恼给出了聚焦的答案：在不手工修改脆弱配置文件的前提下，让多个 AI 编程 CLI 和多个服务商保持可用配置。它基于 SQLite 的单一数据源、双向同步和原子写入，让切换本身变得可靠；统一的 MCP、提示词和技能面板，则减少了同时运行多个工具时通常伴随的复制粘贴。

它不能替代你对「该用哪个服务商」或「某个输出是否可信」的判断。在把密钥留在本地、改动仍然经过审阅的前提下谨慎使用，它是一种让多服务商、多 CLI 开发更省心、更少出错的实用方式。