【2026】CC Switch安装教程：从下载到一键切换API全流程教程（附安装包）

CC Switch安装包下载：CC Switch安装包（源自GitHub，Windows+macOS+Linux，放心使用）

网上关于 CC Switch 的介绍不少，但很多只讲了"它能切换 AI 编程工具"这一句，具体怎么下载、怎么装、装完怎么添加供应商、怎么一键切换，讲得比较笼统，新手照着操作容易卡住。这篇文章整理了 CC Switch 从安装包下载到完成 API 切换的完整流程，每一步都有详细说明，配合图示，第一次接触 AI 编程工具管理的话跟着做就行。

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 等），再填对应配置，填错位置会导致切换无效。

总结

CC Switch 是一款免费、开源的桌面应用，把 Claude Code、Codex、Gemini CLI 等多个 AI 编程工具的供应商配置集中到一个界面里，一键切换 API，省去了手动改配置文件的麻烦，还附带 MCP、提示词、Skills 管理和用量统计功能。

使用 CC Switch 先添加供应商，再选择工具一键切换，切换后重启对应的 AI 编程工具即可生效。第一次使用建议先添加一个供应商测试连通性，再逐步添加其他供应商，配合配置备份功能，换电脑时也能快速恢复。如果你平时经常调试AI API、手里有几套不同的API配置、或者在多个编程工具之间切换使用，CC Switch值得装一个试试。