别再瞎找安装包！CCSwitch 正规下载 + 避坑完整版

CC-Switch（CCSwitch）全平台下载安装完整教程

一、下载（v3.16.1）

🚀 国内备用（高速下载）

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

二、Windows 安装两种方案

方案1：标准MSI安装包（推荐，自动注册环境）

1. 在Assets下载CC-Switch-xxx-Windows.msi
2. 双击MSI安装包，一路点击「下一步」，可自定义安装路径
3. 安装完成后，开始菜单搜索CC-Switch启动

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

1. 下载CC-Switch-xxx-Windows-Portable.zip
2. 解压到任意英文路径（不要放中文文件夹）
3. 直接双击CC Switch.exe运行

Windows常见报错解决

• 弹窗「Windows已保护你的电脑」：点击更多信息→仍要运行
• 打不开/配置不生效：关闭杀毒软件，路径全程无中文、空格

三、macOS 两种安装方式

方式1：Homebrew 命令行一键安装（推荐）

打开终端，依次执行：

# 添加软件源brew tap farion1231/ccswitch# 安装图形客户端brewinstall--caskcc-switch

安装后启动台直接打开CC-Switch。

方式2：手动DMG安装包

1. Release页下载.dmg文件
2. 双击打开，将CC-Switch图标拖入「应用程序」文件夹
3. 首次打开提示无法验证开发者：
   系统设置 → 隐私与安全性 → 下滑找到「仍要打开」即可放行

M1/M2/M3芯片适配

DMG安装包原生支持arm64，无需Rosetta转译。

四、Linux（Ubuntu/Debian）安装

deb包安装（Debian/Ubuntu）

# 下载对应deb包后终端执行sudodpkg-icc-switch_*.deb# 自动补全缺失依赖sudoapt-getinstall-f

通用AppImage（所有Linux发行版）

1. 下载.AppImage文件
2. 终端赋予执行权限：

chmod+x cc-switch-xxx.AppImage# 直接运行./cc-switch-xxx.AppImage

五、首次打开基础配置步骤

1. 启动软件，顶部切换你需要管理的工具（Claude Code / Gemini CLI等）
2. 左侧「Providers」点击**+新增服务商**
3. 填入API Key、自定义中转地址（国内服务商填对应Base URL）
4. 选中当前启用的服务商，软件自动同步写入对应工具的本地配置文件
5. 打开终端启动Claude Code等工具，自动读取CC-Switch托管的配置

六、卸载教程

Windows

• MSI安装：设置→应用→找到CC-Switch卸载
• 便携版：直接删除解压文件夹即可

macOS

# Homebrew安装卸载brew uninstall--caskcc-switch# DMG手动安装：将应用程序内CC-Switch拖到废纸篓

Linux

deb包：sudo apt remove cc-switch
AppImage：直接删除AppImage文件

七、避坑关键提醒

1. 不要使用Claude官方API搭配本工具代理，极易封号；仅建议搭配国内第三方中转服务商
2. 软件配置存本地数据库，路径含中文会导致配置丢失
3. 更新版本前建议在软件内导出配置备份，防止密钥丢失
4. 仅从GitHub官方Release下载，第三方网盘安装包存在篡改盗Key风险