最近几年,AI 编程工具彻底改变了我们的开发方式。Claude Code 推理能力强、Codex 代码生成快、Gemini CLI 速度拉满,还有 OpenCode 和 OpenClaw 各有特色。可每次想换个模型或切个中转节点,就得手动挖配置文件夹,改 API Key、Base URL,维护 MCP 服务器、Skills 插件和系统 Prompt……改错一次就全乱,效率直接打折。
我自己也踩过不少坑,直到用上 cc-switch,才真正解放出来。这款基于 Tauri + Rust 的开源桌面工具,已经在 GitHub 收获 40K+ Star,成为很多 AI 开发者必装的配置管理神器。
今天就把完整使用心得分享给大家,纯干货,照着做 5 分钟就能上手。
cc-switch 到底解决了哪些痛点?
它不是简单改个 API 地址的小工具,而是一个全家桶式的 AI CLI 管理中心。核心亮点包括:
- 一键切换 Provider:支持 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五大主流工具,内置 50+ 中转节点预设,也支持完全自定义(Kimi、Moonshot、GLM 等)。
- MCP 服务器统一管理:支持 stdio/http/sse 三种传输方式,一键同步到所有客户端,再也不用分别改每个工具的配置。
- Skills 一键安装/卸载:自动扫描 GitHub 热门仓库,像 npm 一样批量安装、管理版本,还支持 symlink 和文件复制。
- 系统 Prompt 多模板管理:Markdown 实时编辑+预览,能为不同模型/场景准备专属提示词,一键应用。
- API 速度测试与可视化:直观看到每个节点延迟和稳定性。
- 配置安全备份:自动保留最近 10 个版本,支持导入导出,改坏了也能秒回滚。
- 桌面原生体验:Windows / macOS / Linux 全平台支持,系统托盘快速切换、开机自启、自动更新、无广告。
和市面上的油猴脚本或浏览器插件相比,cc-switch 是真正为 CLI 工具量身打造的桌面原生应用,开源(MIT 协议)、完全免费、作者维护非常活跃。
快速上手:5 分钟玩转 cc-switch
步骤 1:下载安装
根据你的系统选择最新 Release(推荐 v3.12.3 或更新版本):
- Windows:下载
.msi安装包或 portable ZIP 解压即用。 - macOS(最推荐):
brew tap farion1231/ccswitch brew install --cask cc-switch - Linux:支持
.deb、.rpm、.AppImage,Arch 用户可paru -S cc-switch-bin。
安装完启动后,界面简洁直观,会自动检测已安装的 CLI 工具并尝试导入现有配置。
步骤 2:添加第一个 Provider
点击主界面右上角 Add Provider:
- 选择内置预设,或手动输入 API Key + Base URL。
- 填完后点击 Enable,工具会自动写入对应 CLI 的配置文件(
~/.claude、~/.codex等)。
添加与配置 Provider(供应商)
核心操作就这一步,搞定后后面全自动。
- 打开主界面,点击右上角 Add Provider(添加供应商)。
- 选择类型:直接挑内置预设(Claude 官方、Gemini、DeepSeek、阿里百炼等 50+ 个),或者点 Custom 自定义。
- 填参数:
-
名称:随便起个好记的,比如 “自建 sg.uiuiapi”。
-
API Key / Token:填你的密钥。
-
Base URL:比如自建聚合平台就填
https://sg.uiuiapi.com。 -
其他可选:默认模型、API 格式(Anthropic 或 OpenAI 兼容)。
-
小技巧:支持拖拽排序,还能批量导入。自定义 Provider 还能设置“共享配置片段”,避免插件数据被覆盖。我之前用第三方中转时,就是这么设的,一次配好全工具通用。
加完以后,列表里就能看到它了。
很多新版 CLI 已支持热切换,改完不用重启终端。
步骤 3:玩转高级功能
- MCP 页签:添加自定义服务器,一键同步到所有工具。
- Skills 页签:从 GitHub 一键安装热门技能,支持批量和版本管理。
- Prompts 页签:创建多套系统提示词模板,Markdown 实时预览。
- 系统托盘:右键点击图标,随时快速切换模型,效率直接起飞。
切换后,我通常是先切 Gemini Flash 快速预览原型,再切 Claude Opus 深度推理,最后用 GLM 跑性价比高的任务,整个流程丝滑。
和同类工具比,cc-switch 到底强在哪里?
市面上大部分工具只支持网页版 Chat,或者只管单个 CLI。而 cc-switch 是唯一同时覆盖五大 AI 编程 CLI 的统一管理工具,还额外带了云同步、用量统计、会话历史管理等实用功能。完全本地运行,数据安全有保障。
谁最适合用 cc-switch?
- 重度使用 Claude Code / Codex / Gemini CLI 的开发者
- 经常测试不同中转节点和模型性价比的人
- 需要管理大量自定义 Skills 和 Prompt 模板的 AI 编程玩家
- 讨厌每次切换都要手动改 JSON 的强迫症患者
- 跨平台办公(Win + Mac + Linux)的程序员
一句话总结:如果你每天都在用 AI 写代码,而且不止用一个模型、一个渠道,装上 cc-switch 基本不会后悔。
项目地址:https://github.com/farion1231/cc-switch(记得点个 Star 支持一下)
有任何配置问题,欢迎在评论区贴日志,我们一起讨论。cc-switch 还在快速迭代,建议常去 GitHub 看最新 Release。试试看,你的 AI 开发效率会直接上一个台阶!
