用了三个月 Claude Code,换个模型又要手动改 JSON——cc-switch 可能是目前最完整的”AI 编程工具全能遥控器”
用了三个月 Claude Code,换个模型又要手动改 JSON——cc-switch 可能是目前最完整的”AI 编程工具全能遥控器”
如果你同时用 Claude Code、Codex、OpenCode 还不够,又加了 OpenClaw 或者最近火起来的 Grok Build,每天光是在不同工具之间切换 API 供应商、改配置文件,就能耗掉不少时间。更别提还得记住每个工具的配置文件格式(JSON、TOML、.env 各一套)、配置路径、还有 MCP 服务器和 Skills 的独立维护方式。
cc-switch 就是来解决这个问题的:在一个桌面上,把所有这些工具的供应商、MCP、Skills、Prompts、Session 全统一管理起来,一键切换,配置不打架。
目前 129,840 Star、MIT 协议、纯 Rust+Tauri 构建,上周刚发了 v3.20.1,维护频率几乎每周都有更新。
它到底在管什么
cc-switch 支持九种 AI 编程 CLI 的统一管理:
- Claude Code、Claude Desktop
- Codex(ChatGPT 版和 CLI 版都支持)
- OpenCode
- OpenClaw
- Grok Build
- Hermes Agent
- Gemini CLI
- 以及刚刚加入的 Pi
官方文档(ccswitch.io)和 GitHub(farion1231/cc-switch)都写着”唯一官方渠道”,没有任何内购、没有广告、从不收费。
核心功能就三类:
Provider 管理 — 50+ 内置预设,覆盖 Kimi、DeepSeek、GLM、MiniMax、硅基流动、AWS Bedrock、NVIDIA NIM 等常见中转和官方 API。选择预设 → 填入 API Key → 点 Enable,程序自动把配置写入对应 CLI 的配置文件(JSON、TOML 或 .env,视工具而定)。支持热切换,不用重启终端。v3.20.1 刚刚修了 Codex CLI 0.149 的一个导致第三方切换报 401 的问题,切换逻辑从”写 auth.json”改为”写 config-only”,算是根治了。
MCP 和 Skills 统一管理 — stdio / HTTP / SSE 三种传输方式全部支持,在 cc-switch 里配一次,同步到所有客户端,不用每个工具单独改。还支持从 GitHub 批量安装 Skills,带版本管理。v3.19.2 给 MCP 面板加了搜索和按应用批量开关。
用量统计 — 每个供应商的 Token 消耗、用量趋势,全部在一个面板里看。v3.19.2 修了用量统计里一个会把交错计数器文件多算几倍的缺陷,v3.20.1 新增了”自动扫描会话记录”开关,大会话文件的扫描从秒级降到毫秒级。
技术细节:轻量和安全是它的卖点
技术选型上,cc-switch 从 Electron 迁移到了 Tauri 2.0(Rust),内存占用约 45 MB,相比 Claude Code CLI(~200 MB)等 Electron 方案轻了很多。安装包只有几 MB,安装方式是 MSI / DMG / DEB / RPM 或者直接下二进制,Homebrew 用户 brew install –cask cc-switch 即可。
数据存储方面:v3.8.0 之后改为 SQLite + JSON 双层架构。可同步数据(供应商、MCP、Prompts、Skills)存在 SQLite 里,设备级数据(窗口状态、路径等)存 JSON。云同步功能已在路线图上,当前需要跨设备同步的用户可以通过 Dropbox / OneDrive / WebDAV 自行配置同步 ~/.cc-switch/ 目录。
隐私方面:所有数据存在本地 ~/.cc-switch/config.json,全程离线,无网络请求,不上传任何密钥。作者在官方文档里明确写了”任何向你收费或索取登录凭据的 CC Switch 网站或客户端均为假冒”,并给出了举报入口。
谁该用,谁不该用
适合:
- 同时跑两个以上 AI 编程 CLI(Claude Code + Codex + OpenCode 等)的开发者
- 需要在多个 API 供应商之间频繁切换、测试延迟和成本的人
- 管理团队共享 Skills 和 Prompt 模板的 AI 编程重度用户
- 讨厌每次切模型都要手动改 JSON 文件的人
- 跨平台办公(Windows + macOS + Linux)的程序员
不适合:
- 只用一个 AI 编程工具、没有任何切换需求的人 — cc-switch 反而增加了不必要的复杂度
- CI/CD 场景 — 它是桌面应用,没有 headless 模式
- 资源极其受限的机器 — 虽然 Tauri 很轻,但 WebView 桌面应用对老旧硬件仍有开销
和同类比怎么样
| 对比维度 | cc-switch | 手动改配置文件 | 第三方 Electron 工具 |
|---|---|---|---|
| 安装包体积 | ~5 MB | 无 | 50–100 MB |
| 切换方式 | GUI 一键,热切换 | 手动编辑,重启终端 | 图形界面,慢 |
| 多工具统一管理 | ✅ | ❌ | 部分支持 |
| 数据安全 | 本地离线,无网络请求 | 本地,有误改风险 | 部分工具后台采集 |
| 供应商预设 | 50+ | 0 | 几个 |
升级到 v3.20.1 的时候注意
v3.20.1 包含数据库迁移(v17 → v18),升级前会自动备份。如果从 v3.20.0 之前的版本升级,Codex CLI 0.149 相关的 API Key 写入手艺会有根本性变化(auth.json 不再承托密钥),已有配置的用户需要重新登录一次。同时,v3.20.0 引入了 Pi 作为第九个受管应用,以及 ChatGPT Team 多账号支持(同一个 workspace 下的多个账号不会再互相覆盖了)。
下一步可以做什么
- 去 GitHub 看 releases 页面,下载对应平台的最新版(github.com/farion1231/cc-switch/releases),macOS 用户如果没有签名证书,第一次会在系统设置里看到”无法验证开发者”提示,按官方文档操作即可
- 有多个 AI 编程 CLI 在手上跑,先把各自的配置文件 export 一份,然后导入 cc-switch,以后切换就不用再动文件了
- 团队场景,把 ~/.cc-switch/ 目录同步到共享的 WebDAV 地址,成员之间可以共享供应商配置和 Skills
- 关注一下云同步路线图,v3.8.0 的 SQLite 迁移就是为这一步铺垫的,后续官方云同步上线后同步体验会更顺
项目地址:github.com/farion1231/cc-switch
官网:ccswitch.io
当前版本:v3.20.1(2026-08-28)
评论区
登录后可评论。