CC Switch 是 118k Stars 的开源 All-in-One AI CLI 桌面管理器，MIT 协议 + Tauri 2 写就，统一管理 Claude Code/Codex/Gemini/Grok 等 8 大 AI CLI，50+ 厂商预设一键切换。
🎤 引言
Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes —— 用过三个以上的人都知道，每个工具有自己的 API key 管理、自己的 settings.json / ~/.codex/config.toml / 环境变量。
每次切 API 中转商，都要手改 JSON 和 TOML。MCP server 也是每个工具独立配置一遍。
CC Switch 把这事儿一刀解决。118,720 Stars / 7,959 Forks / MIT / Tauri 2 + Rust，GitHub 全平台开源项目里能排进 AI CLI 管理品类全球 Top 5 的硬核作品。一键切换 API provider、系统托盘快速切换、统一 MCP / Skills 管理、跨云同步配置 —— 你想到的它都做了。
今天拆解这个由个人开发者 farion1231 维护的"AI CLI 神器"。
⭐ 核心功能
1. 一个面板管 8 大 AI CLI
CC Switch 当前原生支持的工具有 8 个：
| AI CLI | 厂商 | 评价 |
|---|---|---|
| Claude Code | Anthropic | ⭐⭐⭐⭐⭐ 最热 |
| Claude Desktop | Anthropic | 桌面 GUI 版 |
| Codex | OpenAI | ⭐⭐⭐⭐⭐ 顶级 |
| Gemini CLI | ⭐⭐⭐⭐ | |
| Grok Build | xAI | 新晋 |
| OpenCode | sst/opencode | ⭐⭐⭐⭐ 终端 Agent |
| OpenClaw | ssitu/openclaw | ⭐⭐⭐⭐⭐ |
| Hermes | NousResearch | 开源 LLM |
不需要打开 8 个配置文件。
2. 50+ 内置 Provider 预设
不用复制 Base URL、不用查文档，内置 50+ 厂商预设，包括：
- 官方：
AWS Bedrock/NVIDIA NIM - 第三方中转：
PackyCode/AICodeMirror/Cubence/Crazyrouter等十几家中转商 - 自定义：用户可加
一键 Import，无需手动填 key。
3. 一键切换 + 系统托盘快速切换
切换 provider 只需要：
- 主界面：选 provider → 点 Enable
- 系统托盘：右键单击 → 选 provider
除 Claude Code 外，其他 CLI 都需要重启终端才能生效。Claude Code 支持热切换（独家优势）。
4. 本地代理 + 自动故障转移
CC Switch 启动内置本地代理，做的事：
- 格式转换：Anthropic ↔ OpenAI ↔ Gemini 格式互转
- 自动故障转移：provider 报错自动切下一个
- 熔断器：连续失败的 provider 自动剔除
- 请求整流：自动过滤危险请求
- 应用级 takeover：可以独立代理 Claude / Codex / Gemini / Grok
5. 统一 MCP / Prompts / Skills 管理
跨工具同步 MCP server（双向）：
| 资源类型 | 支持的 CLI |
|---|---|
| MCP servers | Claude / Codex / Gemini / Grok / OpenCode / Hermes |
| Prompts (CLAUDE.md / AGENTS.md / GEMINI.md) | Claude / Codex / Gemini（Markdown 编辑器 + 反填空保护） |
| Skills（GitHub 仓库或 ZIP 一键安装） | 同 MCP |
6. 用量 + 成本可视化
- 仪表盘：开销、请求数、token 用量趋势图
- 详细请求日志
- 自定义模型单价：手动配每个模型的 $/M token 价格，CC Switch 自动算账
7. 会话管理器
跨工具浏览 / 搜索 / 恢复对话历史，支持多个会话源。
8. OpenClaw Workspace 编辑器
针对 OpenClaw 单独集成：可视化编辑 AGENTS.md / SOUL.md 等智能体文件，带 Markdown 预览。
9. 跨设备云同步
- 自定义配置目录（Dropbox / OneDrive / iCloud / NAS）
- WebDAV 服务器同步
- 配置变更原子写入 + 自动备份（保留最近 10 个快照）
10. Deep Link (ccswitch://)
URL 一键导入 provider、MCP server、prompt、skill。可以把常用配置做成短链发到群里。
📥 安装使用
方式一：Homebrew（macOS 推荐）
brew install --cask cc-switch
brew upgrade --cask cc-switch # 升级方式二：直接下载安装包
去 Releases 页 选对应平台：
- Windows 10+：
.msi安装包 或.zip便携版 - macOS 12+：
.dmg（已 Apple 公证 + code signed，不用手动xattr） - Linux：
.deb/.rpm/.AppImage（Ubuntu 22.04+ / Debian 11+ / Fedora 34+）
方式三：Arch Linux
paru -S cc-switch-bin首次配置 4 步走：
- 启动应用 → 选语言（支持 en / zh / zh-TW / ja）
- 加 Provider：点
Add Provider→ 选预设 → 粘 API Key → 保存 - 系统托盘启用：右键单击系统托盘图标 → 选你的 provider → 激活
- 重启 Claude Code / Codex / Gemini CLI（Claude Code 不用重启）
支持的格式：
- macOS：
.dmg（推荐，已 Apple 公证） - Windows：
.msi或 Portable.zip - Linux：
.deb/.rpm/.AppImage
数据库位置（Linux/macOS）：
~/.cc-switch/
├── cc-switch.db # SQLite（providers + MCP + prompts + skills）
├── settings.json # 设备级别 UI 偏好
├── backups/ # 自动备份（保留最近 10 份）
├── skills/ # 默认符号链接到对应 app
└── skill-backups/ # 卸载前自动备份（保留最近 20 份）典型使用场景 - 跨工具同步 MCP：
- 在 CC Switch 点
MCP→ 加一个 GitHub MCP server - 勾选 "Sync to Claude Code" + "Sync to Codex" + "Sync to Gemini"
- 一键分发到 3 个 CLI，不用分别配置 3 次
🎯 适用场景
- AI 重度用户：每天在 Claude Code / Codex / Gemini 间来回切的人
- 企业 + 个人双账号：正式版账号 + 中转商账号，一键切不需要改 env
- 多厂商试用：想对比 PackyCode / AICodeMirror / 官方三家的响应速度和稳定性
- MCP 生态玩家：用 CC Switch 统一管理 6+ 工具的 MCP server 列表
- OpenClaw / Claude Code 重度玩家：CC Switch 是这两个工具的"必装伴侣"
- 同款工具多账户：Codex 多 Plus 账号、Claude Max + Pro 双账号
- 教学 / Demo：把"MCP 怎么配"做成 ccswitch:// 深链接发群里
🔍 对比/替代方案
| 工具 | 平台 | Stars | License | 覆盖 CLI 数 | MCP 统一 | 托盘切换 |
|---|---|---|---|---|---|---|
| CC Switch | Win/Mac/Linux | 118.7k⭐ | MIT ✅ | 8 | ✅ | ✅ |
| claude-code-router | CLI 路由器 | 12k⭐ | MIT | 1（仅 Claude） | ❌ | ❌ |
| gcopa gcopa **（Grok-only） | CLI 工具 | <1k | - | 1 | ❌ | ❌ |
| OpenCode | 自身是 AI CLI | 5k⭐ | MIT | 0（自身） | ✅ | ❌ |
| 手动编辑 ~/.config/xxx.json | - | 0 | - | 8 | ❌ | ❌ |
CC Switch 的独特价值：
- ✅ 覆盖最广：8 个主流 AI CLI 一个面板管理（没有第二家）
- ✅ 真正统一 MCP：跨 6+ 工具的双向同步
- ✅ Apple 公证 + code signed：macOS 用户不用
xattr，开箱即用 - ✅ 本质设计哲学："minimal intrusion" —— 卸载后 CLI 工具仍能正常工作
- ✅ MIT：商用完全自由（包括二次开发）⚡ vs 其他协议（EdgeEver AGPL / Antigravity CC-NC-SA / Aidoku GPL+CLA）
横向对比结论：
- 想只路由 Claude Code → 用 claude-code-router（更轻量）
- 想统一管理 5+ 个 AI CLI → CC Switch 是唯一选择
⚠️ 注意事项
- 重启终端：除 Claude Code 外，其他 CLI 切换 provider 需要重启终端或工具才能生效（已写入 FAQ）。
- macOS 切换 Apple 渠道：如要从第三方切回官方账号，需要在 CC Switch 加
Official Login预设 → 切换 → 重启 CLI → 走 OAuth 流程。 Linux Wayland + NVIDIA 黑屏：CC Switch 默认强制
GDK_BACKEND=x11绕过 native Wayland 崩溃。如要切回 Wayland：CC_SWITCH_GDK_BACKEND=wayland ./CC-Switch-*.AppImage- 不能删当前 active provider：CC Switch 设计哲学"minimal intrusion"——即使卸载，应用仍能正常工作。所以系统总是保留一个 active 配置（用于"卸载后 CI 还能跑"）。
- MCP 双向同步要小心：勾错工具可能把测试用 MCP 推到生产 CLI。建议先在单工具验证，确认无误再勾别的。
- Prompts 的"反填空保护"：跨 CLI 同步 Markdown 文件时，CC Switch 会避免覆盖你已有的关键内容。但首次同步前建议手动备份
CLAUDE.md。 - 第三方赞助商众多：README 含 17+ 赞助商 banner（Kimi / PackyCode / AICodeMirror / 火山引擎 / 字节 Dola Seed 等），项目生态已商业化。免费版完全够用，但赞助商轮换可能影响默认推荐。
- 配置文件位置：数据库 + Settings + 备份都在
~/.cc-switch/，卸载前手动备份整个目录。 - Skills 的符号链接 vs 复制：默认 symlink 安装到各 CLI 工具目录，卸载 CC Switch 后链接失效。如要持久化，编辑时选"复制"模式。
- Skills 备份机制：自动备份在
skill-backups/，保留最近 20 份。数据库 backup 只保留 10 份，需要手动扩散请自己cp -r。
✅ 总结
CC Switch 是 2026 年 AI CLI 生态里"管理工具"细分赛道的全球 Top 1。118k⭐ / MIT / Tauri / 8 大 CLI / 50+ 厂商预设 / 系统托盘切换 / 统一 MCP —— 每一个模块都做到行业标杆。
它不仅是开发者工具，更是 AI CLI 重度玩家的工作刚需。如果你每天混用 2 个以上 AI CLI，CC Switch 就是必装。
适合人群：AI CLI 重度玩家 / OpenClaw 用户 / MCP 生态实践者 / 多中转商比价党 / 企业 + 个人双账号切换者。
不适合人群：只在终端用一种 CLI 的轻度用户（没必要装）/ 对系统托盘有洁癖的人（可用主界面替代）。
推荐指数：⭐⭐⭐⭐⭐（5/5，MIT + 118k + 跨平台 + 0 广告 拉到顶）
去 GitHub 仓库 看看，去 ccswitch.io 看官网教程（官方唯一网站），去 Releases 下载对应平台。如果觉得有用，给作者 farion1231 打 ⭐ 支持。