如果你同时在用 Claude Code、Codex、Gemini CLI 这几款 AI 编程工具，你大概率遇到过这个问题：每次换一个 API 供应商（官方直连、国内中转、本地模型），都要手动打开 ~/.claude/settings.json、~/.codex/config.toml、~/.gemini/.env 分别改一遍，还得记住每个工具的配置字段格式。CC Switch 就是为了解决这个痛点而生的——它是一个跨平台桌面 App，让你用一个界面管理所有 AI CLI 工具的 Provider 配置、MCP 服务器和 Skills，一键切换，不再手写配置文件。

CC Switch 是什么？

CC Switch（官网：ccswitch.io，GitHub: farion1231/cc-switch）是由开发者 Jason Young 创建的开源桌面应用，基于 Tauri 2 框架构建，安装包体积约 10 MB。截至 2026 年 6 月，项目已获得超过 67,000 颗 GitHub Star，125 位贡献者参与开发，是目前社区最活跃的 AI CLI 管理工具。

它支持同时管理以下 7 款 AI 编程工具的配置：

  • Claude Code（Anthropic 官方 CLI）
  • Claude Desktop
  • Codex（OpenAI 官方 CLI）
  • Gemini CLI（Google 官方 CLI）
  • OpenCode
  • OpenClaw
  • Hermes Agent

CC Switch 的核心价值

每款 AI CLI 都有自己的配置格式、Provider 语法、MCP 配置方式和 Skills 目录。CC Switch 把这些差异抹平，提供统一的可视化界面，让你不需要记住每个工具的配置细节就能完成切换。

为什么开发者需要 CC Switch？

随着 AI 编程工具的爆发，一个开发者同时使用 2-3 款 CLI 工具已经很常见。在 CC Switch 出现之前，切换 API Provider 的流程是这样的：

  • 找到 ~/.claude/settings.json，手动修改 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN
  • 找到 ~/.codex/config.toml，修改 base_url 和 API Key
  • 找到 ~/.gemini/.env，更新对应变量
  • 重启终端，验证是否生效
  • 下次再切换，重复上面的步骤

有了 CC Switch，这个流程变成：在系统托盘右键 → 选择目标 Provider → 完成。Claude Code 和 Gemini CLI 甚至支持热切换，不需要重启终端。

对于国内开发者来说，CC Switch 还内置了 50+ 中转站/第三方 Provider 预设，不需要手动填写 base_url，直接选预设、粘贴 API Key 即可。这也是它在国内技术社区被频繁推荐的核心原因。

安装方法

macOS

推荐使用 Homebrew，支持自动更新：

brew tap farion1231/ccswitch
brew install --cask cc-switch

也可以从 GitHub Releases 页面下载 .dmg 文件，双击安装后拖入应用程序文件夹。系统要求：macOS 12+（Monterey 及以上）。

Windows

从 GitHub Releases 页面下载 CC-Switch-vX.X.X-Windows.msi 安装包，双击运行，按提示完成安装。也有便携版 .zip，解压后直接运行 CC-Switch.exe，无需安装。系统要求：Windows 10+。

Linux

根据发行版选择对应格式：

  • Ubuntu/Debian：下载 .deb 包，sudo dpkg -i cc-switch_*.deb
  • Arch Linux：paru -S cc-switch-bin（AUR）
  • Fedora/RHEL：下载 .rpm 包
  • 通用：下载 .AppImage，赋予执行权限后直接运行

注意：Linux 下如果系统托盘图标消失，需要安装 gnome-shell-extension-appindicator 并重启会话。

无图形界面（服务器环境）

CC Switch 是桌面 App，无法在纯命令行服务器上运行。如果你需要在 headless 环境使用相同功能，可以考虑社区项目 SaladDay/cc-switch-cli，它读取相同的配置格式，但以纯 CLI 形式运行。

核心功能详解

1. Provider 管理（核心功能）

首次启动后，CC Switch 会自动检测你已安装的 AI CLI 工具并导入现有配置。添加新 Provider 的步骤：

  1. 点击界面右上角的 "+" 按钮
  2. 选择 Provider 类型：App 专属 Provider（仅作用于当前 CLI）或 通用 Provider（跨 Claude Code、Codex、Gemini CLI 共享）
  3. 从 50+ 预设中选择目标供应商（支持 AWS Bedrock、NVIDIA NIM、国内主流中转站等），或手动填写自定义 base_url
  4. 粘贴 API Key，CC Switch 自动填充端点 URL 和协议格式
  5. 点击 "启用" 完成切换

切换生效时机因工具而异：Claude Code 和 Gemini CLI 支持热切换（无需重启终端）；Codex、OpenCode、OpenClaw 和 Hermes Agent 需要重启终端才能生效。

CC Switch 把配置直接写入各工具的原生配置文件，不引入额外的运行时依赖：

  • Claude Code → ~/.claude/settings.json
  • Codex → ~/.codex/auth.json + ~/.codex/config.toml
  • Gemini CLI → ~/.gemini/.env + ~/.gemini/settings.json
  • OpenCode → ~/.config/opencode/opencode.json

Codex 用户注意

Codex 0.137.0+ 已放弃对 wire_api = "chat" 的支持，只接受 Responses API。如果你的中转站不支持 OpenAI Responses API，即使配置了 CC Switch 也会报 404 错误。选择 Provider 时建议先确认中转站明确支持 Responses API，或在 CC Switch 中开启 "Needs Local Routing" 选项，让 CC Switch 的本地代理层做协议转换。

2. 本地代理与热切换

CC Switch 内置一个本地代理层，不只是写配置文件。它还支持：

  • 热切换：无需重启终端，切换后立即生效（适用于支持的 CLI）
  • 协议转换：把 Codex 的 Responses API 请求转成 OpenAI Chat Completions 格式，让不支持 Responses API 的中转站也能接 Codex
  • 自动故障转移：配置多个 Provider 后，主 Provider 不可用时自动切换备用
  • 健康检查：对已配置的 Provider 发起测试请求，验证 API Key 和端点是否有效

3. MCP 服务器统一管理

MCP（Model Context Protocol）是让 AI CLI 工具连接外部工具（数据库、文件系统、搜索引擎等）的标准协议。CC Switch 提供了统一的 MCP 管理面板，可以：

  • 查看并管理各 CLI 的 MCP 服务器列表（从各工具的原生配置位置读取，如 Claude Code 的 ~/.claude.json）
  • 按 CLI 单独开关 MCP 服务器
  • 通过 Deep Link 一键导入 MCP 配置
  • 在多个 CLI 之间双向同步 MCP 服务器配置

4. Skills 安装与管理

Skills 是给 AI CLI 扩展额外指令和提示词能力的插件机制（类似 Claude Code 的 /commands 和 Prompts）。CC Switch 支持：

  • 从 GitHub 仓库或 ZIP 文件一键安装 Skills
  • 批量更新已安装的 Skills
  • 选择安装模式：符号链接模式（一份文件同步给多个 CLI）或 文件复制模式（适合不支持 symlink 的沙盒 CLI）

5. 用量统计与会话历史

CC Switch 内置用量仪表板，记录每个 Provider 的 Token 消耗和费用支出，以及按 CLI 工具分类的调用历史。会话管理器支持浏览和检索跨多款应用的历史对话记录。

6. 云同步

CC Switch 的本地数据存储在 ~/.cc-switch/ 目录（SQLite 数据库 + JSON 配置 + Skills 目录），支持通过 Dropbox、OneDrive、iCloud、NAS 或 WebDAV 同步到多台设备。注意：不建议直接同步 cc-switch.db SQLite 文件到普通云存储（缺乏文件锁），推荐使用 WebDAV 或支持文件锁的同步方案。

快速上手：3 步跑通第一次切换

  1. 安装并启动：按上方对应平台的安装步骤完成安装，首次启动会自动检测已安装的 CLI 工具。
  2. 添加 Provider：点击右上角"+"，选择中转站预设（或填写自定义 base_url），粘贴 API Key，保存。
  3. 启用并验证：在 Provider 列表中点击目标配置的"启用"按钮，然后点"健康检查"验证连通性，打开终端运行 claude（或 codex/gemini）确认生效。

如果是 Codex 用户，切换后需要完全退出 Codex 进程（不只是关掉提示符），重新启动才能加载新配置——这是 Codex 的启动时缓存机制，不是 CC Switch 的问题。

CC Switch 适合哪些开发者？

以下情况下 CC Switch 特别有价值：

  • 同时使用 Claude Code + Codex，或者加上 Gemini CLI 三件套
  • 在官方 API、国内中转站、本地模型之间频繁切换
  • 团队共用一套 Provider 配置，需要通过云同步分发给多台设备
  • 需要统一管理跨工具的 MCP 服务器，避免重复配置
  • 想监控多个 AI CLI 的 Token 消耗和费用

如果你只用一款 AI CLI，且只接一个固定的 API 供应商，CC Switch 提供的便利性相对有限——直接把 Key 写进环境变量就够了。但只要你有"多 CLI、多 Provider、频繁切换"的需求，CC Switch 几乎是目前最成熟的解决方案。

配合中转站使用的提示

CC Switch 内置的 50+ 预设覆盖了国内主流中转站（PoloAPI、SiliconFlow、302.AI、ofox.ai 等）。如果你的中转站不在预设列表里，可以选"自定义 Provider"，手动填写 base_url（格式通常是 https://your-relay.com/v1）和 API Key。注意 Claude Code 用的是 Anthropic 协议，Codex 用的是 OpenAI Responses API 协议，选中转站时要确认对方支持你需要的协议。

相关资源

关于国内主流中转站的横向评测，可以参考我们的 AI API 中转站测评 页面。

延伸阅读