CC-Switch是一款开源桌面工具,支持Windows、macOS和Linux。它能在统一界面中管理Claude Code、Codex、Gemini CLI等多个CLI工具的API配置、MCP服务器、提示词和Skills。支持环境变量冲突检测、API测速与配置自动备份,适合同时使用多个AI编程工具的开发者。
Tags:
本文字数 1902,阅读大约需 4 分钟
用 Claude Code 的朋友,应该都经历过这么一个阶段。
想换个 API 服务商,得去 ~/.claude/settings.json 里手动改配置。
改完 Claude 的,又想调一下 Codex 的,于是再跑去 ~/.codex/auth.json 里折腾。
如果你同时还在用 Gemini CLI,那恭喜你,又多了一个 ~/.gemini/.env 要伺候。
三个工具,三套配置文件,路径不一样,格式也不一样。
改错一个字段,配置无法正常生效,还得回去排查半天。
这种体验,真的不丝滑。
之前在七牛云 API 聚合平台这篇文章里,顺带提了一嘴 CC-Switch 这个工具,当时没展开说,就一笔带过了。
最近再看了一下它的更新记录,发现已经不是当初那个只能切换模型配置的小工具了。
CC-Switch 是什么?
CC-Switch 是一个开源的桌面端工具,做的事情用一句话就能说清楚:帮你在一个界面里,统一管理 Claude Code、Codex、Gemini CLI 等多个 CLI 工具的配置。
Windows、macOS、Linux 都支持。
macOS 用户可以直接用 Homebrew 安装:
# 安装命令行工具(CLI)
brew tap farion1231/ccswitch
# 桌面应用(GUI App)
brew install --cask cc-switch
Windows 和 Linux 用户去 GitHub Releases 页面下载对应的安装包就行。
GitHub 地址:https://github.com/farion1231/cc-switch/releases
安装完打开,你会看到一个很简洁的主界面,上面列着你目前配置好的 Provider(也就是 API 服务商)。
基本操作逻辑很简单:点「添加」创建一个新的 Provider 配置,填上 API Key 和请求地址,保存。
想切换的时候,选中它,点一下「启用」就行了。
切换完重启终端,新的配置就生效了。
如果你嫌每次还要打开主界面太麻烦,它还有系统托盘的快捷菜单,右键直接切换,连界面都不用开。
以前每次想从一个服务商切到另一个,都要打开配置文件、改字段、保存、关终端、重新打开。现在点两下鼠标就搞定了。
不只是切换配置,还有需要其他功能
如果 CC-Switch 只是一个配置切换器,那也没必要专门写一篇文章来介绍它。
真正让我觉得值得聊聊的,是它后来陆续加上的这些功能。
1、MCP 统一管理
用 MCP 的朋友应该有感触,给 Claude Code 配 MCP 服务器,要去改 ~/.claude.json;
给 Codex 配,要去改 ~/.codex/config.toml;
给 Gemini 配,又是 ~/.gemini/settings.json。
三个工具,三个地方,三种格式。
CC-Switch 把这件事统一了。
点击界面右上角的「MCP」按钮,你能在一个面板里管理所有应用的 MCP 服务器。添加、删除、启用、禁用,都在这里完成。
它支持 stdio、http、SSE 三种传输类型,还内置了一些常用的 MCP 模板,比如 mcp-fetch、mcp-filesystem 这些,直接选就行,不用自己手写配置。
改完之后,它会自动同步到对应应用的配置文件里。
如果你已经在某个工具里配好了 MCP 服务器,也可以一键导入到 CC-Switch 里统一管理。
对于重度使用 MCP 的人来说,这个功能是刚需。
2、Prompts 管理
这个功能,我觉得特别适合经常要调整系统提示词的朋友。
Claude Code 的系统提示词在 CLAUDE.md,Codex 在 AGENTS.md,Gemini 在 GEMINI.md。
CC-Switch 的 Prompts 管理模块,可以创建多套提示词预设,用内置的 Markdown 编辑器来编写,还有语法高亮和实时预览。
想切换的时候,选一套预设,点「激活」,它就会自动写入到对应应用的提示词文件里。
比如在做不同类型的项目时,可能需要不同的系统提示词。以前得手动复制粘贴,现在提前存好几套,随时切换。
3、Skills 管理
Claude Code 的 Skills 机制,简单说就是让你给 Claude 预置一些特定领域的知识或行为规范。
手动安装 Skills 的流程,你需要去 GitHub 仓库找到对应的 Skill 文件,然后手动复制到 ~/.claude/skills/ 目录下。
CC-Switch 把这个流程简化了。
它预配置了几个常用的 Skills 仓库(包括 Anthropic 官方的),打开 Skills 面板就能浏览、搜索。
看到想用的,点一下「安装」,它就会自动下载并放到正确的位置。不想用了,点「卸载」就行。
最新版本还加了一个自动备份的功能:卸载 Skill 之前,它会先把文件备份一份,万一后悔了还能恢复。
你也可以添加自己的 GitHub 仓库作为 Skills 来源,支持子目录扫描。
4、OpenClaw 配置管理
这个要单独提一下。
如果你在用 OpenClaw,应该知道它自带的配置管理界面并不是很好用。
CC-Switch 可以直接编辑和管理 OpenClaw 的常用配置文件,操作上会方便很多。
一些值得留意的细节
除了上面这些主要功能,CC-Switch 还有许多小功能,单独拎出来说可能不够写一段,但放在一起,能看出作者在这个工具的细节上也下了不少功夫。
环境变量冲突检测。 当同时给多个工具配了不同的 API 环境变量时,它会自动检测是否存在冲突,并给出提示和解决建议。这个对于配置多个服务商的用户来说很实用,能避免很多莫名其妙的报错。
API 测速。 添加完 Provider 之后,可以直接在界面里测试 API 端点的延迟,快速判断哪个服务商更快。
macOS 签名公证。 最新版已经通过了 Apple 的签名和公证,不会再弹「未知开发者」警告了。之前 macOS 用户第一次打开都需要手动去安全设置里放行,现在不用了。
配置自动备份。 每次切换 Provider,它都会自动备份当前配置,保留最近 10 份。万一改坏了,可以随时回滚。
云同步支持。 可以把配置目录指向 Dropbox、iCloud、OneDrive 等云盘文件夹,实现多设备间的配置同步。
写在最后
以上就是 CC-Switch 目前的部分主要功能(还有好多其他功能,太多了介绍不完,大家可以自行去体验)。
如果你同时在用多个 CLI 工具,又经常需要切换不同的 API 服务商,那它确实能省不少事。
当然,如果你只用一个工具、配置也很固定,那手动改文件也完全够用,没必要多装一个软件。
工具这东西,合适自己的才是最好的。
感兴趣的朋友可以去试试 👉 https://github.com/farion1231/cc-switch
以上,就是本文全部内容,如果觉得这篇文章对你有启发,点赞、比心、分享三连就是对我最大的支持,谢谢~
• 用 Gemini 解锁 YouTube 新用法,信息获取效率提升 10 倍
• 有了 NotebookLM 后,还需要 Obsidian 吗?
• 我试了 NotebookLM 学习法后,彻底抛弃传统学习方式
• 我用 NotebookLM 解锁 PPT 的 5 种玩法,实现了 PPT 自由
没有评论:
发表评论