🧐 什么是 CC Switch？
CC Switch 是一款开源的跨平台桌面应用，堪称 AI 编程时代的"瑞士军刀"。它的核心作用是统一管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 这五大 AI 编程工具的 API 配置。
告别手动繁琐地编辑各种 settings.json、.toml或 .env配置文件，通过 CC Switch，你可以实现一键切换 API 供应商
这是一份为您整理的 CC Switch 全能使用教程。
🧐 什么是 CC Switch？
CC Switch 是一款开源的跨平台桌面应用，堪称 AI 编程时代的"瑞士军刀"。它的核心作用是统一管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 这五大 AI 编程工具的 API 配置。
告别手动繁琐地编辑各种 settings.json、.toml或 .env配置文件，通过 CC Switch，你可以实现一键切换 API 供应商、统一管理 MCP 服务器和 Prompts，极大地提升开发效率。
📥 一、 安装指南
CC Switch 支持 Windows、macOS 和 Linux 系统。
-
Windows 用户：
-
前往项目的 GitHub Releases 页面。
-
下载最新的
.msi安装包（推荐）或.zip便携版。 -
双击安装包按照向导完成安装，或解压 zip 文件后运行
CC-Switch.exe。
-
-
macOS 用户：
-
Homebrew（推荐）：
brew tap farion1231/ccswitch brew install --cask cc-switch -
手动安装 ：下载
.zip文件解压后拖入"应用程序"文件夹。若遇到"未知开发者"拦截，请前往 系统设置 -> 隐私与安全性 点击"仍要打开"。
-
-
Linux 用户：
- 可根据发行版下载对应的
.deb、.rpm或使用通用的一键安装命令（如 Arch Linux：paru -S cc-switch-bin）。
- 可根据发行版下载对应的
🛠️ 二、 基础使用：如何添加并切换供应商
这是 CC Switch 最核心的功能，让你在不同 API 服务商之间无缝切换。
步骤 1：选择目标工具
打开 CC Switch，在主界面顶部的分组栏中，选择你想要配置的工具（例如 Claude）。
步骤 2：添加供应商 (Provider)
-
点击主界面右上角的 **
+** （添加）按钮。 -
在弹出的窗口中，你可以从 预设列表（内置 50+ 家供应商，如 DeepSeek、SiliconFlow、OpenAI 等）中选择，或者选择"自定义配置"。
-
填写配置信息：
-
Provider Name：自定义一个名字（如：My-DeepSeek）。
-
Base URL ：填写供应商的 API 接口地址（注意：末尾不要带斜杠
/，否则会导致路径拼接错误）。 -
API Key：填入你的密钥。
-
-
点击 **Add（添加）** 保存。
步骤 3：启用配置
在供应商列表中找到刚刚添加的配置，点击其右侧的 Enable（启用） 按钮。当状态变为 **Active（使用中）** 时，即表示配置已自动写入对应 AI 工具的配置文件中。
步骤 4：验证是否生效
重启你的终端（或 IDE 中的终端），运行对应的 AI 工具命令（如 claude），随便输入一句测试语。如果能收到正常回复，说明切换成功。
💡 快速切换小技巧 ：CC Switch 启动后会在系统托盘（右下角）常驻图标。以后你想切换模型时，只需右键点击托盘图标，直接选择目标供应商即可，无需打开主窗口。
🚀 三、 进阶功能探索
当你掌握了基础的供应商切换后，可以尝试以下功能来进一步提升工作流：
1. 全局管理 MCP (Model Context Protocol)
如果你同时使用 Claude Code、Codex 等多个工具，MCP 配置只需在 CC Switch 里设置一次：
-
点击右上角的 MCP 标签页。
-
点击"添加"，选择协议类型（stdio / HTTP / SSE），填写服务器信息。
-
保存后，所有关联的 CLI 工具都会自动共享该 MCP 配置，无需分别设置。
2. 一键安装 Skills (技能扩展)
Skills 是可复用的功能模块（如代码审查、前端设计等）：
-
点击右上角的 Skills 标签页。
-
工具会自动扫描 GitHub 上的公开 Skills 仓库。
-
找到需要的 Skill（如
code-review），勾选后即可一键安装到对应的 AI 工具中。
3. Prompts (提示词) 管理
-
点击 Prompts 标签页。
-
使用内置的 Markdown 编辑器创建多套系统提示词预设。
-
激活后，它会自动同步到对应工具的配置文件中（如 Claude 的
CLAUDE.md），非常适合团队统一代码风格和交付标准。
4. 云同步
如果你有多台设备，可以在 设置 -> 自定义配置目录 中，将路径指向 Dropbox、OneDrive、iCloud 或 WebDAV 等云盘的同步文件夹。重启应用后，你的所有配置（供应商、MCP、Skills）就会自动在设备间同步了。
⚠️ 四、 常见问题与避坑指南
-
切换后模型不生效？
-
Claude Code 支持热切换，一般即时生效。
-
Codex 和 Gemini CLI 则需要完全退出并重启终端才能生效。
-
-
Base URL 格式错误
- 填写 API 地址时，千万不要在末尾多加斜杠
/。错误示例：https://api.example.com/；正确示例：https://api.example.com。多加斜杠会导致 API 路径拼接出现双斜杠而请求失败。
- 填写 API 地址时，千万不要在末尾多加斜杠
-
环境变量冲突
- 如果你之前在系统环境变量中手动配置过 AI 工具的 Key 或 Base URL，可能会与 CC Switch 产生冲突。建议在 Shell 配置文件（如
.bashrc或.zshrc）中注释掉相关变量，或在终端中手动unset掉。
- 如果你之前在系统环境变量中手动配置过 AI 工具的 Key 或 Base URL，可能会与 CC Switch 产生冲突。建议在 Shell 配置文件（如
-
Windows 中文用户名路径问题
- 如果 Windows 用户名包含中文，可能会因为路径编码问题导致 CC Switch 启动报错。建议使用便携版（.zip）并将其解压到纯英文路径下运行。
、统一管理 MCP 服务器和 Prompts，极大地提升开发效率。