
你有没有遇到过这种情况?
用 Claude Code 写着代码,想换个 API 供应商,得手动去改 JSON 配置文件;用 Codex 跑着任务,想切到 Gemini 试试,又得翻 TOML 配置;OpenClaw 的 AGENTS.md 改了又改,MCP 插件在不同的 AI 工具之间来回复制粘贴……
每个 AI 编程工具都有自己的配置格式,切换供应商就像在 JSON、TOML、.env 文件之间玩拼图游戏。
说真的,这事挺烦的。
今天给你介绍一个开源工具——CC Switch,一个桌面应用就能管理 8 个 AI 编程工具的供应商配置,可视化界面一键切换,再也不用手动编辑配置文件了。
这是什么?
CC Switch 是 GitHub 上的一个开源项目(github.com/farion1231/cc-switch),作者是 Jason Young。最新版本 v3.17.0,2026年7月13日发布。
它做的事情说起来很简单:把 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes 这 8 个工具的配置管理,统一到一个桌面应用里。
你可以把它理解成 AI 编程工具的"控制面板"——不用去翻每个工具的配置文件,在一个界面里就能搞定所有工具的供应商切换、MCP 管理、Skills 安装。

上面是它的主界面。左侧是工具列表,右侧是供应商列表。选一个供应商点"启用",配置就自动写入对应工具的配置文件了。
核心功能
一键切换供应商
CC Switch 内置了 50 多个供应商预设,包括 AWS Bedrock、NVIDIA NIM 以及各种社区中转服务。你也可以添加自定义配置——把 API Key 和请求地址填进去就行。

切换供应商有两种方式:
- 主界面
:选一个供应商,点"启用" - 系统托盘
:直接在托盘菜单里点供应商名字,立即生效
大多数工具切换后需要重启终端才能生效,但 Claude Code 支持热切换,不用重启。
统一 MCP 和 Skills 管理
这个功能特别实用。如果你同时用 Claude Code、Codex 和 Gemini CLI,每个工具都要单独配 MCP 服务器,改起来很麻烦。
CC Switch 提供了一个统一的 MCP 管理面板,一处配置,同步到所有支持的工具。而且支持双向同步——在 CC Switch 里改了会写入工具的配置文件,在工具里改了也会回填到 CC Switch。
Skills 管理也是类似的逻辑,可以从 GitHub 仓库或 ZIP 文件一键安装到支持的应用。
项目级一键切换(v3.17.0 新功能)
这是最新版的重磅功能。你可以把当前的供应商、MCP、Skills、记忆文件整套保存为一个"项目"。
举个例子:你有一个目录用来编程,配了代码审查的 MCP 和 Skills;另一个目录用来写作绘图,配了另一组供应商和 MCP。保存为两个项目后,在主页顶部一键切换,所有配置整套换过来。
切换的时候还会自动把你离开的项目当前状态存回去,所以每个项目里保存的永远是你上次离开时的样子。
本地代理热切换
CC Switch 内置了一个本地代理,支持:
- 格式转换
:不同供应商的 API 格式可能不同,代理自动转换 - 自动故障转移
:一个供应商挂了自动切到备用 - 熔断器
:防止反复请求已经挂掉的服务 - 供应商健康监控
:实时监控供应商状态
还可以为 Claude、Codex、Gemini 或 Grok Build 单独配置代理,精细到单个供应商。
用量仪表盘
跨供应商追踪支出、请求数和 Token 用量,有趋势图表和详细请求日志。如果你同时用多个供应商,这个功能可以帮你分析哪个最划算。
其他实用功能
- 云同步
:支持 Dropbox、OneDrive、iCloud、坚果云、NAS 和 WebDAV 服务器,不同设备之间同步供应商数据 - Deep Link
:通过 ccswitch:// 链接一键导入供应商、MCP、Prompts 和 Skills - 会话浏览
:浏览、搜索和恢复支持的会话来源 - 工作区编辑器
:针对 OpenClaw,可以直接编辑 AGENTS.md、SOUL.md 等文件,支持 Markdown 预览 - 自动备份
:原子写入机制,保护配置不被损坏,自动轮换保留最近 10 个备份
技术架构
CC Switch 是基于 Tauri 2 构建的原生桌面应用,前端用 React + TypeScript,后端用 Rust。
核心设计模式:
- SSOT(单一事实源)
:所有数据存在 SQLite 数据库(~/.cc-switch/cc-switch.db) - 双层存储
:SQLite 存可同步数据,JSON 存设备级设置 - 双向同步
:切换时写入工具的 live 配置文件,编辑当前供应商时从 live 回填 - 原子写入
:临时文件 + 重命名模式,防止配置损坏 - 并发安全
:Mutex 保护的数据库连接,避免竞态条件
数据存储位置:
数据库:~/.cc-switch/cc-switch.db 设置:~/.cc-switch/settings.json 备份:~/.cc-switch/backups/(保留最近 10 个) Skills:~/.cc-switch/skills/
怎么安装?
Windows
从 GitHub Releases 页面下载 .msi 安装包或 .zip 绿色版。需要 Windows 10 及以上。
macOS
推荐用 Homebrew:
brew install --cask cc-switch
更新:
brew upgrade --cask cc-switch
也可以从 Releases 页面下载 .dmg 安装包。已经通过 Apple 代码签名和公证,直接安装就行。
Linux
Arch 用户可以用 paru:
paru -S cc-switch-bin
其他发行版从 Releases 下载:
.deb(Debian/Ubuntu) .rpm(Fedora/RHEL/openSUSE) .AppImage(通用)
数据安全
CC Switch 的设计原则是"最小侵入性"——即使卸载了软件,也不会影响 AI 工具的正常使用。系统总会保留一个正在激活的配置,不会因为删了所有供应商配置导致工具无法使用。
所有数据都存在本地,不经过任何第三方。配置文件采用原子写入(临时文件 + 重命名),就算写到一半断电也不会损坏现有配置。
总结
CC Switch 解决的是一个非常实际的问题:AI 编程工具越来越多,每个都有自己的配置格式,手动管理太痛苦了。
它把 8 个工具的配置管理收到一个桌面应用里,50+ 供应商预设一键切换,MCP 和 Skills 统一管理,再加上本地代理、用量统计、云同步这些功能,基本上覆盖了日常使用 AI 编程工具的所有配置需求。
完全开源免费,基于 Tauri 2 构建,跨平台支持,数据存在本地 SQLite,不经过任何第三方。
项目地址:github.com/farion1231/cc-switch
官网:ccswitch.io

👋 学到这里了?扫码加我微信,备注【AI交流】,拉你进群和一群爱折腾AI的朋友一起玩~
📚 往期精选
看到这里了,说明你是真爱👀
点个赞和在看支持一下。
搜索公众号「AI小白笔记本」,每周都有 AI 实用干货,不整虚的。
夜雨聆风