现在认真用 Coding Agent 的人,桌面上很容易堆出一把工具:Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw。每个都有自己的 provider、MCP、prompt、skills、session。刚开始还新鲜,过几天就乱成一锅粥。
CC Switch 这个项目解决的是一个很实际的问题:多套 AI CLI 的配置统一管理。它不是模型,也不是新 Agent,而是一个跨平台桌面控制台。
热度:约 52k stars,Rust/Tauri 桌面应用。
它适合谁
如果你只用一个 Claude Code 官方登录,CC Switch 不是刚需。但如果你有这些痛点,它就值得试:
- 不同 CLI 用不同模型供应商和代理配置。
- MCP server 越装越多,不知道哪个工具在哪个客户端生效。
- CLAUDE.md、AGENTS.md、GEMINI.md 到处散落。
- 想统计不同模型的请求、token 和费用。
- 想把 Skills 在多个 Agent 入口之间同步。
安装:按系统选择
macOS 推荐 Homebrew:
brew tap farion1231/ccswitch
brew install --cask cc-switch升级:
brew upgrade --cask cc-switchArch Linux 可以用:
paru -S cc-switch-binWindows 下载 `CC-Switch-v{version}-Windows.msi` 或 portable zip。Linux 下载 `.deb`、`.rpm` 或 AppImage。建议从 GitHub Releases 获取,别随便找第三方打包。
第一次配置:先导入现有 CLI
首次打开后,别急着新建一堆 provider。先把已有 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 配置导入成默认 provider。这样你可以确认“原来能用的东西没有被改坏”。
一个稳妥顺序是:
1. 导入已有配置。
2. 给每个 CLI 添加一个官方登录或主力 provider。
3. 只启用一个 MCP server 做测试。
4. 打开对应 CLI,确认工具可见。
5. 再同步 prompts 和 skills。Claude Code 的部分配置可以热切换,其他工具大多需要重启终端或 CLI 才生效。这个细节很重要,很多“配置没生效”其实只是没重启。
MCP 和 Skills 不要一把梭
CC Switch 的诱惑是:一个面板全同步。我的建议反而保守一点:MCP 先按项目分组,Skills 先按用途分组。
比如代码理解类:GitNexus、Context7;浏览器自动化类:Playwright;沙箱类:OpenSandbox。不要把所有 MCP 都开给所有 Agent,否则工具列表会膨胀,模型选择工具反而更慢。
配置备份要知道在哪
README 提到本地数据库和备份位置:
~/.cc-switch/cc-switch.db
~/.cc-switch/skill-backups/在你大规模改 provider、MCP 或 skills 之前,建议备份这个目录。桌面配置工具最怕“同步很方便,误删也很方便”。
CC Switch 的价值,不在于让你拥有更多 AI 工具,而是把已经失控的工具栈重新收口。Agent 生态越分裂,这种“控制面板”类工具就越有存在感。