什么是 CC Switch？

CC Switch 是一款跨平台桌面应用，一站式管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 等多款 AI 编程助手。基于 Tauri 2 构建，支持 Windows / macOS / Linux，当前最新版本为 v3.14.1。

如果你同时使用多款 AI 编程工具——比如用 Claude Code 做架构设计、用 Codex 写代码、用 Gemini 做代码审查——CC Switch 能让你在一个统一的界面里切换、配置和管理它们，不用在多个终端窗口之间来回折腾。

核心能力一览

功能 说明
🔄 多工具管理 统一管理 Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw
⚙️ 提供商切换 支持 Anthropic 官方、AWS Bedrock、Google Vertex、Azure Foundry 及各类中转 API
📊 用量监控 系统托盘实时显示各工具用量、订阅配额、颜色编码利用率
🔐 OAuth 反向代理 内置 Codex OAuth 代理，支持 FAST 模式切换
🧩 Skills 管理 导入、安装、更新各类 Agent Skills
📝 会话管理 查看、恢复、切换各工具的历史会话
🌐 MCP 配置 图形化管理 Model Context Protocol 服务器
🏠 Hermes 集成 提供商管理、记忆编辑、Web UI 启动

安装指南

下载安装包

访问 Releases 页面 下载对应平台的安装包：

平台 安装包格式
Windows .msi 安装程序 / .exe 便携版
macOS .dmg（Apple Silicon / Intel）
Linux .AppImage / .deb

Windows 安装

  1. 下载最新版 .msi 安装包
  2. 双击运行，按向导完成安装
  3. 安装完成后，桌面和开始菜单会出现 CC Switch 图标

或者使用便携版（无需安装），直接运行 .exe。

macOS 安装

# 下载 .dmg 后双击挂载，将 CC Switch 拖入 Applications
# 或通过 Homebrew（如有）

首次打开时，macOS 可能提示”无法验证开发者”，去系统设置 → 隐私与安全性中点击”仍要打开”即可。

Linux 安装

# AppImage（推荐）
chmod +x CC-Switch-*.AppImage
./CC-Switch-*.AppImage

# deb 包
sudo dpkg -i cc-switch_*.deb

使用指南

1. 初始配置

首次打开 CC Switch 后，你会看到主界面。左侧是工具列表（Claude Code / Codex / Gemini CLI 等），右侧是配置面板。

第一步：添加 AI 工具

  1. 点击左侧工具图标（如 Claude Code）
  2. 在右侧面板中配置：
    • 提供商：选择 Anthropic（官方）/ Bedrock / Vertex / 自定义 API 中转
    • API 地址：如果用中转服务，填入对应的 ANTHROPIC_BASE_URL
    • API Key：填入你的密钥
    • 模型：选择默认使用的模型
  3. 点击「测试连接」确认配置正确
  4. 点击「保存」

CC Switch 支持同时配置多个提供商，你可以为 Claude Code 配一个 Anthropic 官方、一个 Bedrock、一个便宜的中转站，随时切换。

2. 切换工具和提供商

在左侧工具栏点击对应图标即可切换不同的 AI 编程工具。

对于同一工具的不同提供商，在主界面顶部或设置面板的提供商下拉菜单中一键切换。CC Switch 会自动更新对应的环境变量和配置文件。

3. 启动对话会话

配置好工具后，可以：

  • 直接启动：点击「启动」按钮，CC Switch 会在新终端窗口中打开对应工具
  • 恢复历史会话：在会话列表中双击之前的会话，自动恢复到上次的对话状态
  • 继续最近会话：点击工具旁边的「继续」图标

对于 Gemini CLI，CC Switch 会读取 .project_root 元数据，确保恢复到正确的项目目录。

4. 用量监控（系统托盘）

CC Switch 最小化后会驻留在系统托盘中，右键托盘图标可以看到：

  • 当前工具的用量概览：Claude / Codex / Gemini 各自的消耗情况
  • 订阅配额摘要：显示配额的百分比和颜色标记（🟢 正常 / 🟡 警告 / 🔴 耗尽）
  • 用量脚本摘要：基于自定义 usage_script 的详细统计

对于国内的 Kimi / 智谱 / MiniMax 等编码套餐，托盘还会显示 5 小时 + 周度双窗口用量，格式类似 🟢 h12% w80%。

5. Skills（技能）管理

CC Switch 内置了 Skills 管理功能，可以导入和安装社区分享的 Agent Skills：

  1. 进入 Skills 管理页面
  2. 点击「导入」→ 输入 Skills 的 GitHub URL
  3. CC Switch 自动下载并安装到对应工具的配置目录
  4. 支持一键更新已安装的 Skills

导入过程中会自动去重，防止重复安装。

6. MCP 服务器配置

在 MCP 配置页面，你可以图形化管理 Model Context Protocol 服务器：

  • 添加新的 MCP 服务器（本地或远程）
  • 配置环境变量和启动参数
  • 测试 MCP 连接状态
  • 一键启用/禁用特定服务器

7. Hermes 集成

Hermes 是 CC Switch 内置的配置管理中心：

  • 提供商展示：查看所有已配置的 AI 提供商
  • 默认切换：设置默认使用的提供商
  • 记忆编辑：编辑 Agent 的持久化记忆
  • Web UI 启动：一键跳转到 Hermes Web 控制台，进行深度配置

注意：v3.14.1 起移除了应用内的 Hermes 配置健康扫描功能，深度配置诊断请使用 Hermes Web UI。

Codex OAuth 反向代理

CC Switch 内置了 Codex OAuth 反向代理功能，主要特性：

  • 缓存路由：使用客户端提供的会话 ID 作为缓存键，保持缓存一致性
  • FAST 模式：可选择开启 service_tier="priority"，降低延迟（会消耗更多 ChatGPT 配额，默认关闭）
  • Stream Check：代理请求使用与实际请求相同的配置参数，确保连接测试结果与实际使用一致
  • SSE 聚合：非流式请求也能正确处理上游的 SSE 响应

在 Codex 提供商的设置面板中，可以找到 OAuth 代理的开关和 FAST 模式选项。

常见问题

Q: CC Switch 收费吗？

完全免费开源（MIT 协议），从 GitHub Release 直接下载。

Q: 需要自己安装 Claude Code / Codex / Gemini CLI 吗？

需要。CC Switch 是管理工具，不是这些 AI 工具本身的安装器。请确保你要使用的工具已经安装在系统中。

Q: 支持哪些 API 中转服务？

CC Switch 本身不限制中转服务。任何兼容 Anthropic / OpenAI 接口规范的中转 API 都可以配置使用。项目 README 中列出了一批赞助商（PackyCode、AIGoCode、Cubence、Crazyrouter 等），使用 CC Switch 专属优惠码充值有折扣。

Q: 数据安全吗？

CC Switch 是本地桌面应用，所有配置和密钥保存在本地，不会上传到任何服务器。OAuth 代理也在本地运行。

总结

CC Switch 解决了一个真实痛点：开发者同时使用多款 AI 编程工具时的管理混乱。它把 Claude Code、Codex、Gemini CLI 等工具的配置、切换、监控、会话管理都整合到了一个桌面应用里，配合系统托盘用量监控和 Skills/MCP 管理，是目前这个细分领域最成熟的工具之一。