CC-Switch（CCSwitch）全平台下载安装完整教程
一、下载（v3.16.1）
🚀 国内备用（高速下载）
https://pan.quark.cn/s/d6152047213b （含 v3.16.1 全平台包）
二、Windows 安装两种方案
方案1：标准MSI安装包（推荐，自动注册环境）
- 在Assets下载
CC-Switch-xxx-Windows.msi - 双击MSI安装包，一路点击「下一步」，可自定义安装路径
- 安装完成后，开始菜单搜索CC-Switch启动
方案2：绿色便携版（免安装，无注册表）
- 下载
CC-Switch-xxx-Windows-Portable.zip - 解压到任意英文路径（不要放中文文件夹）
- 直接双击
CC Switch.exe运行
Windows常见报错解决
- 弹窗「Windows已保护你的电脑」：点击更多信息→仍要运行
- 打不开/配置不生效：关闭杀毒软件，路径全程无中文、空格
三、macOS 两种安装方式
方式1：Homebrew 命令行一键安装（推荐）
打开终端，依次执行：
# 添加软件源brew tap farion1231/ccswitch# 安装图形客户端brewinstall--caskcc-switch安装后启动台直接打开CC-Switch。
方式2：手动DMG安装包
- Release页下载
.dmg文件 - 双击打开，将CC-Switch图标拖入「应用程序」文件夹
- 首次打开提示无法验证开发者：
系统设置 → 隐私与安全性 → 下滑找到「仍要打开」即可放行
M1/M2/M3芯片适配
DMG安装包原生支持arm64，无需Rosetta转译。
四、Linux（Ubuntu/Debian）安装
deb包安装（Debian/Ubuntu）
# 下载对应deb包后终端执行sudodpkg-icc-switch_*.deb# 自动补全缺失依赖sudoapt-getinstall-f通用AppImage（所有Linux发行版）
- 下载
.AppImage文件 - 终端赋予执行权限：
chmod+x cc-switch-xxx.AppImage# 直接运行./cc-switch-xxx.AppImage五、首次打开基础配置步骤
- 启动软件，顶部切换你需要管理的工具（Claude Code / Gemini CLI等）
- 左侧「Providers」点击**+新增服务商**
- 填入API Key、自定义中转地址（国内服务商填对应Base URL）
- 选中当前启用的服务商，软件自动同步写入对应工具的本地配置文件
- 打开终端启动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文件
七、避坑关键提醒
- 不要使用Claude官方API搭配本工具代理，极易封号；仅建议搭配国内第三方中转服务商
- 软件配置存本地数据库，路径含中文会导致配置丢失
- 更新版本前建议在软件内导出配置备份，防止密钥丢失
- 仅从GitHub官方Release下载，第三方网盘安装包存在篡改盗Key风险
