CC-Switch 完整下载+安装教程（开源AI多模型配置管理器）

一、下载（v3.16.1）

🚀 国内备用（高速下载）

https://pan.quark.cn/s/d6152047213b （含 v3.16.1 全平台包）

二、Windows 两种安装方式（Win10/11）

方式1：标准安装版（.msi，推荐）

1. 打开上面GitHub下载页，下滑到 Assets
2. 下载文件：CC-Switch-vxxx-Windows.msi
3. 双击msi安装包 → 同意协议 → 自定义安装路径（不要中文路径）→ 下一步完成
4. 开始菜单打开 CC-Switch

方式2：便携绿色版（免安装，无注册表）

1. 下载：CC-Switch-vxxx-Windows-Portable.zip
2. 解压到纯英文无空格文件夹（用户名带中文必用这个版本，否则白屏）
3. 直接双击 CC-Switch.exe 启动，拷贝文件夹即可换电脑使用

三、macOS 安装（Mac12+，Intel/M芯片通用）

方法A：图形化DMG安装

1. Releases下载 CC-Switch-vxxx-macOS.dmg
2. 双击打开，把 CC Switch.app 拖入「应用程序」文件夹
3. 首次打开提示无法验证开发者：
   系统设置 → 隐私与安全性 → 下滑点「仍然打开」即可启动

方法B：Homebrew 命令一键安装（开发者推荐）

打开终端依次执行：

brew tap farion1231/ccswitch
brew install --cask cc-switch

更新软件：brew upgrade --cask cc-switch

四、Linux（Ubuntu/Debian/Fedora）

1. Debian/Ubuntu：下载 .deb 包

sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f

2. 通用免安装AppImage：

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

五、安装后常见报错解决

1. 软件白屏/打不开
   • Windows：换便携版，解压到全英文路径；安装微软VC++运行库
   • Mac：允许未知开发者权限，重启电脑
2. 读取不到Claude Code配置
   先安装好 Claude Code，再重启CC-Switch自动扫描
3. API Key保存丢失
   关闭杀毒/防火墙拦截本地数据库，不要放在桌面中文文件夹

六、首次启动基础操作

1. 打开软件自动识别本地Claude Code、Codex等AI工具
2. 点左侧「添加供应商」填入API地址+密钥
3. 一键切换不同大模型服务商（DeepSeek、千问、Claude官方等）