鹤襄陵 益诗误删文件复盘
2026年09月19日 21:46
九月十九日下午，我在服务器上整理文件，敲了一条删除命令...
简介： CC Switch 是一款免费开源的跨平台 AI 编程工具配置管理器，支持 Windows / macOS / Linux。它统一管理 Claude、Codex、Gemini 等工具的 API 供应商，通过可视化界面一键切换，免去手动编辑 JSON/TOML 配置的繁琐操作。
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-*.debFedora/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. 健康检查
添加完供应商后，可以点击旁边的「健康检查」按钮，发送一个测试请求来验证 API Key 和网络连通性。这个功能很实用，能帮你快速排除是 API Key 的问题还是网络的问题。
配置正常的话，CC Switch 会给出「运行正常」的提示：
5. 管理供应商卡片
把鼠标悬停在卡片上，会显示一排操作按钮：启用（使用中）、编辑、复制、检测连通、配置用量查询、删除：
- 编辑可以改供应商配置；
- 复制能快速创建副本；
- 检测连通可以测试模型连通性和响应速度；
- 删除可以移除不需要的供应商（当前正在用的供应商要先切换到别的才能删除）。
按住卡片左侧的拖拽手柄（≡）可以上下拖动调整供应商顺序。
四、新手注意事项
- CC Switch 是管理工具，本身不包含任何 AI 服务。添加供应商时需要填入自己的 API 密钥或配置信息，密钥由各服务商提供。首次使用先添加一个供应商测试连通性，确认能正常调用再批量添加其他供应商。
- 切换供应商后，已打开的 AI 编程工具（如 Claude Code）需要重启或新开会话才能生效。这是正常现象，不是 CC Switch 的问题——配置是启动时读取的，切换后记得重启对应工具。
- 不同 AI 编程工具的配置格式不一样，CC Switch 为每个工具提供了对应的供应商添加入口。添加时先选对工具类型（Claude Code、Codex、Gemini CLI 等），再填对应配置，填错位置会导致切换无效。