CC Switch 是一款免费开源的桌面应用，专门用来统一管理 AI 编程工具的 API 供应商。
用 Claude Code、Codex、Gemini CLI 这类 AI 编程工具时，经常要在不同供应商（官方、中转、自建等）之间切换，手动改配置文件既麻烦又容易出错。CC Switch 把这些工具的供应商配置集中到一个图形界面里，切换时点一下就行，不用再复制粘贴配置内容，还能顺手管理 MCP、提示词、Skills 和用量统计。
网上关于 CC Switch 的介绍不少，但很多只讲了"它能切换 AI 编程工具"这一句，具体怎么安装、装完怎么添加供应商、怎么一键切换，讲得比较笼统，新手照着操作容易卡住。
这篇文章整理了 CC Switch 从安装到完成供应商切换的完整流程，每一步都有详细说明并配图，第一次接触 AI 编程工具管理的话跟着做就行。
下载CC Switch
CC Switch安装包：CC Switch（Windows+macOS+Linux）
CC Switch 官方提供了各平台的安装包，按自己的系统选择：
| 安装包名称 | 对应平台（适用场景） | 格式说明 |
| CC-Switch-Windows.msi | Windows x64（主流 Windows 电脑，推荐） | MSI 安装包，双击安装 |
| CC-Switch-Windows-Portable.zip | Windows x64（免安装便携使用） | 压缩包，解压即用 |
| CC-Switch-Windows-arm64.msi | Windows Arm 64（骁龙等 ARM 芯片电脑） | MSI 安装包，双击安装 |
| CC-Switch-Windows-arm64-Portable.zip | Windows Arm 64（免安装便携使用） | 压缩包，解压即用 |
| CC-Switch-macOS.dmg | macOS（Apple Silicon 和 Intel 芯片均可，推荐） | DMG 安装包，双击拖入应用程序 |
| CC-Switch-Linux-x86_64.AppImage | Linux x64（主流 Linux 发行版，推荐） | AppImage 单文件，赋予执行权限即可运行 |
| CC-Switch-Linux-x86_64.deb | Linux x64（Debian/Ubuntu 系发行版） | Debian 包，用 dpkg/apt 安装 |
| CC-Switch-Linux-x86_64.rpm | Linux x64（RedHat/CentOS/Fedora 系发行版） | RPM 包，用 rpm/yum 安装 |
| CC-Switch-Linux-arm64.AppImage | Linux Arm 64（ARM 架构设备） | AppImage 单文件，赋予执行权限即可运行 |
| CC-Switch-Linux-arm64.deb | Linux Arm 64（Debian/Ubuntu 系发行版） | Debian 包，用 dpkg/apt 安装 |
| CC-Switch-Linux-arm64.rpm | Linux Arm 64（RedHat/CentOS/Fedora 系发行版） | RPM 包，用 rpm/yum 安装 |
安装CC Switch
1) Windows平台
双击 .msi 文件，进入安装向导，点击 Next：
选择安装路径。默认装在 C 盘，想省系统盘空间可以改到 D 盘：
点击 Install，开始安装：
等待安装完成，完成后桌面会出现 CC Switch 快捷方式，双击就能打开它：
如果不想写注册表，可以选择 Portable 便携版，解压 Portable.zip 后直接运行exe文件：
需要注意的是，Windows版本已禁用"一键安装"功能，如果需要安装Claude Code等工具，请手动安装后再通过CC Switch来管理。
2) macOS平台
双击 .dmg 文件打开，把 CC Switch 图标拖入"应用程序"文件夹，应用就能打开了。
3) Linux平台
Ubuntu/Debian/Mint 用户下载 .deb 文件，执行：
sudo apt install ./CC Switch-*.deb
Fedora/RHEL 用户下载 .rpm 文件，执行：
sudo dnf install ./CC Switch-*.rpm
其他发行版可以直接下载 .AppImage 文件，加执行权限后运行即可：
chmod +x CC-Switch-*.AppImage ./CC-Switch-*.AppImage
CC Switch基础使用
CC Switch 的核心功能是管理和切换供应商，打开 CC Switch 后，顶部是导航栏，可以选择当前管理的 AI 编程工具（Claude、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw、Hermes），切换后下方列表就显示对应应用的供应商配置：
导航栏最右侧是添加按钮（+），界面主体是供应商卡片列表，每个供应商以一张卡片展示：
1）添加供应商
点击主界面右上角的 + 按钮，在弹出窗口的"预设供应商"框里选择你的供应商（常用预设包括智谱 GLM、MiniMax、DeepSeek、Kimi 等），预设会自动填好端点地址，只需要填写 API Key，点击"添加"即可。
如果你的供应商不在预设里，选择"自定义"手动配置接口地址和模型信息。
2）健康检查
添加完供应商后，可以点击旁边的「健康检查」按钮，发送一个测试请求来验证API Key和网络连通性。这个功能很实用，能帮你快速排除是API Key的问题还是网络的问题。
配置正常的话，CC Switch 会给出“运行正常”的提示：
3）一键切换供应商
添加完成后供应商出现在列表中，切换有两种方式：
一是主界面切换，把鼠标悬停在目标供应商卡片上，点击卡片上的"启用"按钮（▶）：
二是托盘快速切换，右键系统托盘里的 CC Switch 图标，在"Claude"、"Codex"等子菜单里直接点供应商名称，当前启用的会带勾选标记，不用打开主界面就能切。
4）管理供应商卡片
把鼠标悬停在卡片上，会显示一排操作按钮：启用（使用中）、编辑、复制、检测连通、配置用量查询、删除：
- 编辑可以改供应商配置；
- 复制能快速创建副本；
- 测速可以测试模型连通性和响应速度；
- 删除可以移除不需要的供应商（当前正在用的供应商要先切换到别的才能删除）。
按住卡片左侧的拖拽手柄（≡）可以上下拖动调整供应商顺序。
5）MCP、提示词与 Skills 管理
这些扩展配置平时散落在各工具的配置目录里，CC Switch 把它们集中到面板里统一管理，新版支持搜索，MCP 和 Skills 可以按应用一键批量开启或关闭，不用再手动翻文件：
CC Switch新手注意事项
1）CC Switch 是管理工具，本身不包含任何 AI 服务。添加供应商时需要填入自己的 API 密钥或配置信息，密钥由各服务商提供。第一次使用建议先添加一个供应商，用健康检查确认能正常连通，再逐步添加其他供应商，出了问题容易定位。
2）切换供应商后，已打开的 AI 编程工具（如 Claude Code）需要重启或新开会话才能生效。这是正常现象，不是 CC Switch 的问题，配置是启动时读取的，切换后记得重启对应工具。
3）添加供应商时要先选对工具。每个 AI 编程工具的配置格式不一样，CC Switch 是分工具管理的——给 Claude Code 配置的供应商要加在 Claude 工具页签下，加到其他工具下面不会生效。添加前先看清顶栏当前选中的是哪个工具。
