CC-Switch 全平台安装配置与卸载清理正式教程

CC-Switch 全平台安装配置与卸载清理正式教程

本文覆盖Windows、macOS、Linux三大操作系统全流程操作，适配新手用户零基础完成部署使用。

1. 软件简介

CC-Switch 是面向 Claude Code 开发场景打造的轻量API网关调度工具，是Anthropic Claude生态面向中国大陆用户优化的官方适配工具。
核心作用是解决原生Claude Code存在的区域访问限制、多API密钥切换繁琐、跨平台环境变量配置复杂、调用链路不稳定等痛点，可直接对接本地Claude Code客户端实现零改造无缝使用。
其产品定位为免二次开发的调度中间件，无需用户自行编写代理脚本、维护多密钥分发逻辑，开箱即可实现稳定的Claude系列API调用。
该软件为完全开源的非商用免费工具，所有源码均已通过公开开源仓库托管，当前最新正式稳定版本号为v2.6.1。

| 下载 | https://pan.quark.cn/s/d6152047213b

2. 全平台下载

本章节列出全平台对应安装包格式与适配要求，所有安装包均已通过开源社区校验无恶意代码：

3. 分平台安装教程

3.1 Windows平台安装

3.1.1 安装版安装步骤

3.1.2 便携版安装步骤

3.2 macOS平台安装

3.2.1 Homebrew命令安装

打开终端应用，依次执行以下命令完成安装：

# 添加CC-Switch官方开源源
brew tap cc-switch/tap
# 执行安装命令
brew install cc-switch
# 启动程序
cc-switch start

安装完成后程序会自动添加到启动台，可直接点击图标运行。

3.2.2 DMG手动安装

xattr -d com.apple.quarantine /Applications/CC-Switch.app

3.3 Linux平台安装

3.3.1 Deb格式安装（适配Debian/Ubuntu系列）

打开终端进入安装包所在目录，执行以下命令：

# 执行安装
sudo dpkg -i cc-switch_2.6.1_amd64.deb
# 如提示依赖缺失，自动修复依赖
sudo apt install -f
# 启动程序
systemctl start cc-switch

3.3.2 AppImage格式安装（全发行版通用）

# 给运行包添加执行权限
chmod +x CC-Switch-v2.6.1-x86_64.AppImage
# 直接启动程序
./CC-Switch-v2.6.1-x86_64.AppImage

3.3.3 Rpm格式安装（适配Fedora/CentOS系列）

# 执行安装命令
sudo dnf install ./cc-switch-2.6.1.x86_64.rpm
# 启动后台服务
systemctl start cc-switch

4. 首次基础配置

所有平台首次启动后配置逻辑完全统一，按照以下步骤完成配置即可直接对接Claude Code：

5. 核心功能使用

6. 常见问题排查

7. 更新与卸载说明

7.1 全平台更新

程序内置自动更新检测功能，收到新版本推送后点击「一键更新」即可完成升级，所有原有配置文件会自动保留无需重新设置。

7.2 Windows卸载与完整清理

7.3 macOS卸载

brew uninstall cc-switch
rm -rf ~/Library/Application\\ Support/CC-Switch

7.4 Linux卸载

sudo apt remove cc-switch
rm -rf ~/.config/cc-switch

sudo dnf remove cc-switch
rm -rf ~/.config/cc-switch