CC-SwitchCCSwitch全平台下载安装完整教程一、下载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 两种安装方式方式1Homebrew 命令行一键安装推荐打开终端依次执行# 添加软件源brew tap farion1231/ccswitch# 安装图形客户端brewinstall--caskcc-switch安装后启动台直接打开CC-Switch。方式2手动DMG安装包Release页下载.dmg文件双击打开将CC-Switch图标拖入「应用程序」文件夹首次打开提示无法验证开发者系统设置 → 隐私与安全性 → 下滑找到「仍要打开」即可放行M1/M2/M3芯片适配DMG安装包原生支持arm64无需Rosetta转译。四、LinuxUbuntu/Debian安装deb包安装Debian/Ubuntu# 下载对应deb包后终端执行sudodpkg-icc-switch_*.deb# 自动补全缺失依赖sudoapt-getinstall-f通用AppImage所有Linux发行版下载.AppImage文件终端赋予执行权限chmodx cc-switch-xxx.AppImage# 直接运行./cc-switch-xxx.AppImage五、首次打开基础配置步骤启动软件顶部切换你需要管理的工具Claude Code / Gemini CLI等左侧「Providers」点击**新增服务商**填入API Key、自定义中转地址国内服务商填对应Base URL选中当前启用的服务商软件自动同步写入对应工具的本地配置文件打开终端启动Claude Code等工具自动读取CC-Switch托管的配置六、卸载教程WindowsMSI安装设置→应用→找到CC-Switch卸载便携版直接删除解压文件夹即可macOS# Homebrew安装卸载brew uninstall--caskcc-switch# DMG手动安装将应用程序内CC-Switch拖到废纸篓Linuxdeb包sudo apt remove cc-switchAppImage直接删除AppImage文件七、避坑关键提醒不要使用Claude官方API搭配本工具代理极易封号仅建议搭配国内第三方中转服务商软件配置存本地数据库路径含中文会导致配置丢失更新版本前建议在软件内导出配置备份防止密钥丢失仅从GitHub官方Release下载第三方网盘安装包存在篡改盗Key风险
