2026年4月10日星期五

CC-Switch:统一管理Claude Code/Codex配置,MCP与提示词一键切换

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 这个工具,当时没展开说,就一笔带过了。

最近再看了一下它的更新记录,发现已经不是当初那个只能切换模型配置的小工具了。

img

CC-Switch 是什么?

CC-Switch 是一个开源的桌面端工具,做的事情用一句话就能说清楚:帮你在一个界面里,统一管理 Claude Code、Codex、Gemini CLI 等多个 CLI 工具的配置。

img

Windows、macOS、Linux 都支持。

macOS 用户可以直接用 Homebrew 安装:


    
     
    # 安装命令行工具(CLI)
brew tap farion1231/ccswitch   

# 桌面应用(GUI App)
brew install --cask cc-switch

Windows 和 Linux 用户去 GitHub Releases 页面下载对应的安装包就行。

img

GitHub 地址:https://github.com/farion1231/cc-switch/releases

安装完打开,你会看到一个很简洁的主界面,上面列着你目前配置好的 Provider(也就是 API 服务商)。

img

基本操作逻辑很简单:点「添加」创建一个新的 Provider 配置,填上 API Key 和请求地址,保存。

img

想切换的时候,选中它,点一下「启用」就行了。

切换完重启终端,新的配置就生效了。

如果你嫌每次还要打开主界面太麻烦,它还有系统托盘的快捷菜单,右键直接切换,连界面都不用开。

img

以前每次想从一个服务商切到另一个,都要打开配置文件、改字段、保存、关终端、重新打开。现在点两下鼠标就搞定了。

不只是切换配置,还有需要其他功能

如果 CC-Switch 只是一个配置切换器,那也没必要专门写一篇文章来介绍它。

真正让我觉得值得聊聊的,是它后来陆续加上的这些功能。

1、MCP 统一管理

用 MCP 的朋友应该有感触,给 Claude Code 配 MCP 服务器,要去改 ~/.claude.json

给 Codex 配,要去改 ~/.codex/config.toml

给 Gemini 配,又是 ~/.gemini/settings.json

三个工具,三个地方,三种格式。

CC-Switch 把这件事统一了。

点击界面右上角的「MCP」按钮,你能在一个面板里管理所有应用的 MCP 服务器。添加、删除、启用、禁用,都在这里完成。

img

它支持 stdio、http、SSE 三种传输类型,还内置了一些常用的 MCP 模板,比如 mcp-fetch、mcp-filesystem 这些,直接选就行,不用自己手写配置。

img

改完之后,它会自动同步到对应应用的配置文件里。

如果你已经在某个工具里配好了 MCP 服务器,也可以一键导入到 CC-Switch 里统一管理。

img

对于重度使用 MCP 的人来说,这个功能是刚需。

2、Prompts 管理

这个功能,我觉得特别适合经常要调整系统提示词的朋友。

Claude Code 的系统提示词在 CLAUDE.md,Codex 在 AGENTS.md,Gemini 在 GEMINI.md

CC-Switch 的 Prompts 管理模块,可以创建多套提示词预设,用内置的 Markdown 编辑器来编写,还有语法高亮和实时预览。

img

想切换的时候,选一套预设,点「激活」,它就会自动写入到对应应用的提示词文件里。

img

比如在做不同类型的项目时,可能需要不同的系统提示词。以前得手动复制粘贴,现在提前存好几套,随时切换。

3、Skills 管理

Claude Code 的 Skills 机制,简单说就是让你给 Claude 预置一些特定领域的知识或行为规范。

手动安装 Skills 的流程,你需要去 GitHub 仓库找到对应的 Skill 文件,然后手动复制到 ~/.claude/skills/ 目录下。

CC-Switch 把这个流程简化了。

它预配置了几个常用的 Skills 仓库(包括 Anthropic 官方的),打开 Skills 面板就能浏览、搜索。

img

看到想用的,点一下「安装」,它就会自动下载并放到正确的位置。不想用了,点「卸载」就行。

img

最新版本还加了一个自动备份的功能:卸载 Skill 之前,它会先把文件备份一份,万一后悔了还能恢复。

你也可以添加自己的 GitHub 仓库作为 Skills 来源,支持子目录扫描。

img

4、OpenClaw 配置管理

这个要单独提一下。

如果你在用 OpenClaw,应该知道它自带的配置管理界面并不是很好用。

CC-Switch 可以直接编辑和管理 OpenClaw 的常用配置文件,操作上会方便很多。

img

一些值得留意的细节

除了上面这些主要功能,CC-Switch 还有许多小功能,单独拎出来说可能不够写一段,但放在一起,能看出作者在这个工具的细节上也下了不少功夫。

环境变量冲突检测。 当同时给多个工具配了不同的 API 环境变量时,它会自动检测是否存在冲突,并给出提示和解决建议。这个对于配置多个服务商的用户来说很实用,能避免很多莫名其妙的报错。

API 测速。 添加完 Provider 之后,可以直接在界面里测试 API 端点的延迟,快速判断哪个服务商更快。

img

macOS 签名公证。 最新版已经通过了 Apple 的签名和公证,不会再弹「未知开发者」警告了。之前 macOS 用户第一次打开都需要手动去安全设置里放行,现在不用了。

配置自动备份。 每次切换 Provider,它都会自动备份当前配置,保留最近 10 份。万一改坏了,可以随时回滚。

img

云同步支持。 可以把配置目录指向 Dropbox、iCloud、OneDrive 等云盘文件夹,实现多设备间的配置同步。

写在最后

以上就是 CC-Switch 目前的部分主要功能(还有好多其他功能,太多了介绍不完,大家可以自行去体验)。

如果你同时在用多个 CLI 工具,又经常需要切换不同的 API 服务商,那它确实能省不少事。

当然,如果你只用一个工具、配置也很固定,那手动改文件也完全够用,没必要多装一个软件。

工具这东西,合适自己的才是最好的。

感兴趣的朋友可以去试试 👉  https://github.com/farion1231/cc-switch

 

图片

以上,就是本文全部内容,如果觉得这篇文章对你有启发,点赞、比心、分享三连就是对我最大的支持,谢谢~

往期推荐阅读
•  Obsidian 从入门到进阶合集

• AI把我推成“知名”博主后,我发现了一条产业链

• 用 Gemini 解锁 YouTube 新用法,信息获取效率提升 10 倍

• 有了 NotebookLM 后,还需要 Obsidian 吗?

• 我试了 NotebookLM 学习法后,彻底抛弃传统学习方式

• NotebookLM 再次升级,来自谷歌的年终礼物

• 我用 NotebookLM 解锁 PPT 的 5 种玩法,实现了 PPT 自由

• AI 时代,你的上下文才是最值钱的资产

• 2026 年如何用好 AI,我发现这些能力更重要

• Openclaw 这么火,可你真的需要它吗?

• 万物皆可命令行:AI 时代,软件正在长出第二套界面

• 全网都在抄 Karpathy 的知识库,但大多数人只学到了皮毛

没有评论:

发表评论

Hermes Agent开源项目:狂揽49000+Star,越用越强的AI智能体

Hermes Agent是NousResearch开源的一款AI智能体,能自动将完成的任务写成技能并自我更新,实现越用越强。支持Linux、macOS、WSL2和Docker,可一键安装,兼容OpenRouter、Claude等模型,并能与OpenClaw互通或迁移。适合希望部署...