你用 Claude Code,他用 Codex,我用 Gemini CLI——每换一个模型就要改配置文件、重启终端、手敲 JSON……直到我发现了 CC Switch,才知道原来可以这么爽。
一、CC Switch 到底是什么?
一句话:AI 编程工具的万能遥控器。
CC Switch 是一款开源的跨平台桌面应用,专门给 AI 编程 CLI 工具做配置管理和一键切换。
它目前支持的五大工具:
| 工具 | 厂商 | 说明 |
|---|---|---|
| Claude Code | Anthropic | 终端里的 AI 编程助手 |
| Codex | OpenAI | OpenAI 代码生成 CLI |
| Gemini CLI | Google 命令行 AI | |
| OpenCode | 开源社区 | 开源代码助手 |
| OpenClaw | 开源社区 | 本地 AI Agent 平台 |
项目在 GitHub 上已经拿到 22k+ Stars,活跃开发中,最新版本 v3.15。
二、为什么需要 CC Switch?
用之前:改配置的痛苦
每天用 Claude Code 写代码的人,大概率踩过这些坑:
坑 1:配置文件分散
Claude Code 的配置在 ~/.claude/settings.json,Codex 在 .codex/config.toml,Gemini CLI 又有自己的 .env 文件。想换一个模型?三个文件挨个改,格式还都不一样。
坑 2:来回切模型太折腾
上午用 Claude Sonnet 写业务逻辑,下午想试试 DeepSeek 的效果,晚上又想对比一下智谱 GLM——每次都要改 API 地址、改 Key、改模型名,改错一个字符就报错。
坑 3:MCP 和 Skills 分散管理
MCP 服务器在每个工具里都要单独配,技能包也是。想给 Claude Code 加个文件系统 MCP?改 JSON。想给 OpenClaw 也加上?再改一遍。
坑 4:改崩了没法回退
手动改 JSON,少个逗号或多个引号,整个配置就废了。没有备份、没有版本控制,只能凭记忆恢复。
用之后:一键搞定
- 一个界面管 5 个工具:不用到处翻配置文件,全部在一个面板里操作
- 50+ 预设供应商:Claude、DeepSeek、智谱 GLM、Kimi、通义千问、Gemini、AWS Bedrock……选一个填 Key 就行
- 系统托盘秒切:右键托盘图标直接切换,Claude Code 支持热重载,不用重启终端
- MCP/Skills/Prompts 统一管理:配一次,同步到所有工具
- 配置自动备份:SQLite 存储 + 原子写入,改坏了随时回退
三、怎么安装?三步搞定
CC Switch 支持 Windows、macOS、Linux 三大平台。
Windows(推荐 MSI 方式)
- 打开 GitHub Releases:github.com/farion1231/cc-switch/releases
- 下载最新版
.msi安装包 - 双击安装,一路 Next
- 开始菜单搜索 "CC Switch" 启动
如果遇到 SmartScreen 提示"无法验证发行者",点「更多信息 → 仍要运行」即可。也可下载便携版(Portable ZIP),解压直接运行。
macOS(推荐 Homebrew)
brew tap farion1231/ccswitch
brew install --cask cc-switch
Linux
sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f
四、怎么使用?从零开始配置
第一步:添加模型供应商
打开 CC Switch 主界面,点击右上角的橙色「+」按钮。你会看到供应商列表,分两类:
1️⃣ 预设供应商:Claude、DeepSeek、智谱 GLM、Kimi、通义千问、MiniMax 等,选一个,系统自动填好 API 地址,你只需填 API Key
2️⃣ 自定义供应商:用第三方中转服务的,选「自定义」,手动填 API 地址和 Key
以 DeepSeek 为例:选「DeepSeek」→ 填入 API Key(platform.deepseek.com 注册获取)→ 主模型填 deepseek-coder → 点击「添加」。搞定。
第二步:启用并切换
在主界面看到供应商卡片,点击「启用」按钮,CC Switch 会自动把配置写入对应的 CLI 工具。Claude Code 无需重启终端,直接热加载生效。Codex 和 OpenClaw 需要关掉终端重新打开。
第三步:验证配置
claude
> 你好,介绍一下你自己
AI 正常回复,说明配置成功!
第四步:系统托盘快捷操作
CC Switch 在系统托盘常驻,右键图标可以直接选供应商秒切模型,不用打开主界面。这是日常最高频的操作——上班切 Claude,下班切 DeepSeek,一个右键搞定。
五、进阶配置:MCP、Skills、Prompts
MCP 统一管理
MCP 是让 AI 工具连接外部服务的协议(文件系统、数据库、浏览器等)。以前每个 CLI 都要单独配,现在 CC Switch 一处搞定:点击「MCP」→ 添加服务器 → 勾选要同步的应用 → 保存后自动同步。
Skills 一键安装
Skills 是 Claude Code / OpenClaw 的技能包。CC Switch 支持从 GitHub 仓库一键安装,从 ZIP 导入,跨工具同步——装一次,所有支持的 CLI 都能用。
Prompts 模板管理
多套系统提示词(写代码 / 写文档 / Review 模式)统一管理,一键切换同步到工具配置文件。
六、和什么搭配用?推荐组合
🏆 组合 1:CC Switch + Claude Code + DeepSeek
日常开发者的最爱。Claude Code 做主力,DeepSeek 做备选(性价比高、中文强),一键切换。
🔥 组合 2:CC Switch + OpenClaw + MCP
本地 AI Agent 玩家。OpenClaw 做 Agent 平台,CC Switch 管理模型和 MCP,接入微信/飞书做成私人助手。
⚡ 组合 3:CC Switch + Claude Code + 智谱 GLM
国产大模型爱好者。GLM-5.1 的 SWE-Bench 得分很高,用 CC Switch 秒切测试效果。
🔬 组合 4:CC Switch + Codex + Gemini CLI
多模型对比评测。同一个问题丢给三个模型,对比代码质量。
七、实用技巧
- 跳过 Claude Code 登录:CC Switch 设置里开启「跳过首次运行确认」,不用登录 Anthropic 账号也能用第三方 API
- 配置云同步:支持 Dropbox、OneDrive、iCloud、WebDAV,多电脑自动同步配置
- Deep Link 分享:生成 ccswitch:// 链接发给朋友,一键导入你的供应商和 MCP 配置
- 代理故障转移:内置代理服务,主供应商挂了自动切备用,不影响工作流
八、写在最后
CC Switch 本质上解决的是 AI 编程工具爆发后的配置管理问题。
以前只有一个 Claude Code,配置还好说。现在 Claude Code、Codex、Gemini CLI、OpenClaw……工具越来越多,配置越来越散,管理越来越乱。
CC Switch 就像这些工具的中央控制台——一个界面管所有,点一下就切换,改错了能回退,换了电脑能同步。
如果你每天都在用 AI 写代码,且不止用一个模型,装一个 CC Switch 绝对不亏。
项目地址:github.com/farion1231/cc-switch
如果这篇文章对你有帮助,欢迎点赞、收藏、转发~
夜雨聆风