CC Switch
跨平台桌面应用，把七个 AI 编程 CLI（Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent、Claude Desktop）的供应商配置、MCP 服务器、Prompts、Skills、代理、会话和成本追踪全部收进一个界面——10 个月从 0 冲到 100k Stars
简介
CC Switch 是一个开源跨平台桌面应用，专门解决 AI 编程重度用户面临的”运维碎片”问题。当你同时使用多个 AI 编程 CLI（如 Claude Code + Codex + Gemini CLI）时，API Key 散落在多个配置文件中，供应商切换需要改多个文件、重启终端。CC Switch 把这些零碎动作的摩擦成本压到了接近零。
项目由 farion1231 于 2025 年 8 月创建，截至 2026 年 6 月已获得 100k+ GitHub Stars，是 AI CLI 运维管理品类中几乎没有同类竞品的开源产品。MIT 协议，商业友好。
CC Switch 的核心定位不是做别人做不了的事，而是做好别人不愿意做的事——把散落在七个工具里的 AI CLI 配置统一管理起来。
关键信息
- 类型：工具 / 开源项目
- 领域：AI 编程工具管理 / CLI 配置管理
- GitHub：https://github.com/farion1231/cc-switch
- 官网：https://ccswitch.io
- 开源协议：MIT
- 跨平台支持：macOS（brew）、Windows（.msi/.zip）、Linux（.deb/.rpm/.AppImage）、Arch（paru）
- 管理的 CLI：Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent（共 7 个）
- Stars：100,569（截至 2026-06-14）
- Forks：6,641
- 核心维护者：约 1-2 人（farion1231 为主力）
- 最新版本：v3.16.2（2026-06-08）
- 相关概念：Claude Code、Codex、OpenCode、OpenClaw、Hermes Agent、MCP 模型上下文协议
核心特性
三层架构
CC Switch 采用三层架构设计：
- 代理层（中间层）：供应商配置不直接写给 CLI 工具，而是经过代理层做健康检查和故障转移，再分发给具体工具
- 同步层（侧面）：MCP 和 Skills 的变更经由同步层双向流转，不干扰主链路的稳定性
- 统一界面（顶层）：收拢七个 CLI 的配置管理、会话和成本追踪
这个设计把”配置管理”和”运行时路由”拆开了，是所有功能的基础。
供应商配置管理引擎
- 内置 50 多个供应商预设，覆盖官方登录、社区中转和自定义 endpoint
- 供应商片段机制：把 API 地址、模型名、认证方式绑定为可复用片段，一键应用到任何支持的 CLI
- Configuration as Code 理念从 SaaS 产品下沉到本地桌面端
MCP/Prompts/Skills 跨工具同步
- 在 Claude Code 装的 MCP 服务器，可以通过同步面板勾选后自动转换格式写入 Codex 等其他 CLI
- 支持四种配置类型的模糊匹配和冲突拒绝策略
- 检测双向修改时触发回填保护
- 这是 CC Switch 最有区分度的功能
代理与故障转移
- 内置本地代理层，在 CLI 和供应商之间架了健康监控
- endpoint 响应超时或返回 4xx 时，按预设策略自动切到备用供应商
- 代理层增加约 20-50ms 请求延迟
- 多一层代理意味着多一层故障点
成本追踪与用量监控
- 集中查看各 CLI 的 Token 开销，按项目统计
- 用户反馈”节省了 30% 开支”
- 精度受限于各 CLI 的 token 计数方式差异，目前”在持续改进中”
使用场景
| 场景 | 典型用户 | 优势 | 局限 |
|---|---|---|---|
| 多 CLI 日常切换 | 同时用 Claude Code + Codex 的开发者 | 一键切换，无需重启终端 | 代理层轻微延迟 |
| 多供应商故障转移 | 依赖 API 稳定性做生产级开发的团队 | 自动切换，减少中断 | 依赖 CC Switch 自身稳定 |
| MCP/Skills 跨工具同步 | 在不同 CLI 间复用工具链的深度用户 | 双向同步，回填保护 | 部分 CLI 的格式转换仍有边界情况 |
| 成本追踪与用量监控 | 关心 Token 开销的个人/团队 | 集中查看，按项目统计 | 精度受限于各 CLI 的 token 计数方式 |
不适用的情况
- 只用一个 CLI 且只用一家供应商：代理层是纯开销
- 高度受控的企业环境：目前没有纯 CLI 版本
- 对延迟极度敏感：代理层延迟虽小但不是零
不同素材中的观点
- 2026-06-17-cc-switch-7-cli-console：深度评测认为 CC Switch 是”实用主义”项目——不性感、没有新技术栈，但把”运维碎片”问题解决到位。核心价值在配置管理引擎和 MCP 跨工具同步。主要风险：单人维护的 Bus Factor 偏低（1,433 Open Issues + 1-2 核心维护者），以及单点故障风险（七个 CLI 全交给它管理，代理层出 bug 影响面大）。竞品不存在意味着品类尚未被验证，但 AI 编程工具碎片化趋势给了 CC Switch 至少两年窗口期。
项目健康度
| 指标 | 数据 | 风险评估 |
|---|---|---|
| Stars/Forks | 100k / 6.6k | 社区关注度高 |
| 核心维护者 | 1-2 人 | Bus Factor 偏低 |
| Open Issues | 1,433 | 绝对数值偏高 |
| 更新频率 | 3-5 天/版本 | 活跃 |
| 协议 | MIT | 项目停摆社区可接盘 |
关键观察：farion1231 的提交密度从 2026 年 3 月开始明显下降，同时 Issue 增长速度在加快。参照系：Star 数超 50k 的单人维护桌面应用，95% 会在 6 个月内引入第二核心维护者或进入维护缓慢状态。CC Switch 目前在临界点门口。
安装与使用
macOS：
brew tap farion1231/ccswitch
brew install --cask cc-switchWindows：下载 .msi 安装包或 .zip 便携版（公司电脑优先 .msi）
Linux：.deb / .rpm / .AppImage
Arch：paru -S cc-switch-bin
WSL 用户：CC Switch 需跑在 Windows 宿主机上，但能检测并管理 WSL 内的 CLI 配置。
首次启动自动扫描本机已安装的 CLI 工具，解析配置文件、提取供应商信息、确认后纳入管理。