CC Switch 是一款免费、开源的桌面应用，作用是统一管理 AI 编程工具的 API 供应商，Windows、macOS、Linux 全平台支持。
用 Claude Code、Codex、Gemini CLI、OpenCode 这类 AI 编程工具时，经常要在不同供应商（官方、中转、自建等）之间切换，手动改配置文件很麻烦。CC Switch 把这些工具的供应商配置集中到一个图形界面里，切换时点一下就行，不用再复制粘贴配置内容。
获取CC Switch
CC Switch安装包：CC Switch安装包（源自GitHub，Windows+macOS+Linux）
CC Switch 官方提供了各平台的安装包：
| 安装包名称 | 对应平台（适用场景） | 格式说明 | 文件大小 |
| CC-Switch-v3.19.2-Windows.msi | Windows x64（主流 Windows 电脑，推荐） | MSI 安装包，双击安装 | 12.5 MB |
| CC-Switch-v3.19.2-Windows-Portable.zip | Windows x64（免安装便携使用） | 压缩包，解压即用 | 12.5 MB |
| CC-Switch-v3.19.2-Windows-arm64.msi | Windows Arm 64（骁龙等 ARM 芯片电脑） | MSI 安装包，双击安装 | 11.8 MB |
| CC-Switch-v3.19.2-Windows-arm64-Portable.zip | Windows Arm 64（免安装便携使用） | 压缩包，解压即用 | 11.9 MB |
| CC-Switch-v3.19.2-macOS.dmg | macOS（Apple Silicon 和 Intel 芯片均可，推荐） | DMG 安装包，双击拖入应用程序 | 25.9 MB |
| CC-Switch-v3.19.2-Linux-x86_64.AppImage | Linux x64（主流 Linux 发行版，推荐） | AppImage 单文件，赋予执行权限即可运行 | 87.6 MB |
| CC-Switch-v3.19.2-Linux-x86_64.deb | Linux x64（Debian/Ubuntu 系发行版） | Debian 包，用 dpkg/apt 安装 | 12.5 MB |
| CC-Switch-v3.19.2-Linux-x86_64.rpm | Linux x64（RedHat/CentOS/Fedora 系发行版） | RPM 包，用 rpm/yum 安装 | 12.5 MB |
| CC-Switch-v3.19.2-Linux-arm64.AppImage | Linux Arm 64（ARM 架构设备） | AppImage 单文件，赋予执行权限即可运行 | 85.3 MB |
| CC-Switch-v3.19.2-Linux-arm64.deb | Linux Arm 64（Debian/Ubuntu 系发行版） | Debian 包，用 dpkg/apt 安装 | 12 MB |
| CC-Switch-v3.19.2-Linux-arm64.rpm | Linux Arm 64（RedHat/CentOS/Fedora 系发行版） | RPM 包，用 rpm/yum 安装 | 12 MB |
安装CC Switch
1) Windows平台安装
有了 .msi 文件后双击启动，点击 Next：
选择安装路径。默认装在 C 盘，想省系统盘空间可以改到 D 盘：
点击 Install，开始安装：
等待安装完成，完成后桌面会出现 CC Switch 快捷方式，双击就能打开它：
如果不想写注册表，下载Portable便携版，解压后直接运行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 的核心功能是管理和切换供应商，下面依次给大家讲清楚。
1）认识主界面
打开 CC Switch 后，顶部是导航栏，可以选择当前管理的 AI 编程工具（Claude、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw、Hermes），切换后下方列表就显示对应应用的供应商配置：
导航栏最右侧是添加按钮（+）。界面主体是供应商卡片列表，每个供应商以一张卡片展示：
2）添加供应商
点击主界面右上角的 + 按钮，在弹出窗口的"预设供应商"框里选择你的供应商（常用预设包括智谱 GLM、MiniMax、DeepSeek、Kimi 等），预设会自动填好端点地址，你只需要填写 API Key，点击"添加"即可。
如果你的供应商不在预设里，选择"自定义"手动配置接口地址和模型信息。
3）切换供应商
添加完成后供应商出现在列表中，切换有两种方式：
一是主界面切换，把鼠标悬停在目标供应商卡片上，点击卡片上的"启用"按钮（▶）：
二是托盘快速切换，右键系统托盘里的 CC Switch 图标，在"Claude"、"Codex"等子菜单里直接点供应商名称，当前启用的会带勾选标记，不用打开主界面就能切。
4）健康检查
添加完Provider后，可以点击旁边的「健康检查」按钮，发送一个测试请求来验证API Key和网络连通性。这个功能很实用，能帮你快速排除是API Key的问题还是网络的问题。
配置正常的话，CC Switch 会给出“运行正常”的提示：
5）管理供应商卡片
把鼠标悬停在卡片上，会显示一排操作按钮：启用（使用中）、编辑、复制、检测连通、配置用量查询、删除：
- 编辑可以改供应商配置；
- 复制能快速创建副本；
- 测速可以测试模型连通性和响应速度；
- 删除可以移除不需要的供应商（当前正在用的供应商要先切换到别的才能删除）。
按住卡片左侧的拖拽手柄（≡）可以上下拖动调整供应商顺序。
CC Switch新手注意事项
1）CC Switch 是管理工具，本身不包含任何 AI 服务。添加供应商时需要填入自己的 API 密钥或配置信息，密钥由各服务商提供。首次使用先添加一个供应商测试连通性，确认能正常调用再批量添加其他供应商。
2）切换供应商后，已打开的 AI 编程工具（如 Claude Code）需要重启或新开会话才能生效。这是正常现象，不是 CC Switch 的问题，配置是启动时读取的，切换后记得重启对应工具。
3）不同 AI 编程工具的配置格式不一样，CC Switch 为每个工具提供了对应的供应商添加入口。添加时先选对工具类型（Claude Code、Codex、Gemini CLI 等），再填对应配置，填错位置会导致切换无效。
