CC-Switch 全平台下载+安装完整教程（Windows/macOS/Linux｜AI配置一键切换工具）

---

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

---

作用：统一管理Claude Code、Codex、Gemini CLI、OpenCode等AI编程工具API，一键切换服务商密钥与接口地址

一、各系统安装包区分（Releases→Assets内下载）

系统	安装包类型	适用场景
Windows	.msi正式安装包（推荐）、.zip便携绿色版	Win10 1909+/Win11
macOS	.dmg通用镜像（Intel/M芯片通用）、.zip免安装包	macOS12+全机型
Linux	.deb(Deb/Ubuntu)、.rpm(Fedora)、.AppImage(全发行通用)	内核5.4以上

二、Windows安装（2种方案）

方案1：MSI标准安装（推荐，支持自动更新）

1. Releases下载后缀.msi安装包
2. 双击运行，弹出Windows安全拦截→更多信息→仍要运行
3. 一路下一步，安装路径不要含中文，默认C盘即可
4. 安装完成，开始菜单/桌面启动CC-Switch

方案2：ZIP便携免安装（U盘随身）

1. 下载Portable.zip压缩包
2. 全英文路径解压，直接双击CC-Switch.exe运行；卸载直接删除文件夹

命令行Scoop安装（开发者）

scoop bucket add cc-switch https://github.com/Linuxdazhao/scoop-cc-switch
scoop install cc-switch

三、macOS安装（3种方式，M1/M2/M3/Intel全兼容）

方式1：Homebrew一键安装（首选）

打开终端执行：

brew tap farion1231/ccswitch
brew install --cask cc-switch
#软件更新
brew upgrade --cask cc-switch

方式2：DMG手动安装

1. 下载.dmg文件，双击挂载
2. 把CC-Switch.app拖拽至「应用程序（Applications）」
3. 首次打不开：系统设置→隐私与安全性→下方仍然打开

方式3：ZIP绿色版

下载zip解压，右键App→打开，绕过安全校验即可。

四、Linux全发行安装

1.Ubuntu/Debian（deb包）

sudo dpkg -i cc-switch_amd64.deb
#缺失依赖修复
sudo apt -f install

2.Fedora/RHEL（rpm包）

sudo dnf install ./cc-switch-xxx.x86_64.rpm

3.全Linux通用AppImage（任意系统）

chmod +x CC-Switch.AppImage
./CC-Switch.AppImage

4.Arch/Manjaro(AUR)

paru -S cc-switch-bin

五、首次软件初始化配置（必做）

1. 打开软件，自动扫描本机已装Claude/Codex/Gemini等工具配置
2. 左侧服务商列表：DeepSeek/硅基/通义/Kimi等，填入对应API Key
3. 右上角「一键启用」，自动修改工具本地settings.json/.env配置
4. 内置50+模型预设，无需手动填写接口BaseURL，一键切换模型源

六、常见报错解决

1. Windows阻止运行：SmartScreen→更多信息→仍运行
2. Mac无法打开：设置-安全性放行应用
3. Linux AppImage打不开：安装依赖sudo apt install libfuse-dev
4. 切换配置不生效：软件内开启本地代理127.0.0.1:15721