CC-Switch 下载、安装与使用全指南2026最新 v3.16一、官方下载渠道v3.16 2026稳定版一、下载v3.16.1 国内备用高速下载https://pan.quark.cn/s/d6152047213b 含 v3.16.1 全平台包页面下滑至Releases找到最新v3.16版本展开Assets按系统选择对应安装包| 系统 | 推荐安装包 | 便携免安装包 ||------|------------|--------------|| Windows |.msi安装包支持自动更新 |.zip便携版无注册表写入 || macOS |.dmg镜像 |.zip绿色包 / Homebrew命令安装 || Ubuntu/Debian |.deb|.AppImage通用包 || Fedora/RHEL |.rpm|.AppImage通用包 |macOS Homebrew一键安装命令brew tap farion1231/ccswitch brewinstall--caskcc-switch三、分平台详细安装步骤1. Windows 安装MSI标准版双击下载的CC-Switch-v3.16.msi弹出安装向导点击Next默认路径为C盘点击Change更换至D/E盘避免C盘占用确认后Next同意开源许可协议一路下一步等待进度条完成勾选Launch CC Switch点击Finish自动启动软件Windows便携版无安装流程解压.zip压缩包直接运行CC-Switch.exe即可所有配置存在解压文件夹内可拷贝U盘随身携带。注意Windows Defender可能误报将解压文件夹加入杀毒白名单开源源码可自行审计无恶意代码。2. macOS 安装DMG镜像双击.dmg文件弹出挂载窗口将CC Switch.app拖拽至「应用程序」文件夹首次打开提示无法验证开发者无苹果付费开发者证书正常现象解决权限打开「系统设置」→「隐私与安全性」下滑找到「仍要打开」确认启动后续可直接从启动台打开无需重复授权3. Linux 安装Debian/Ubuntu系.debsudodpkg-iCC-Switch-v3.16-linux-amd64.deb# 缺失依赖执行修复sudoapt-finstallFedora/RHEL.rpmsudodnfinstall./CC-Switch-v3.16-linux-x86_64.rpm全发行版通用 AppImage# 添加执行权限chmodx CC-Switch-*.AppImage# 直接运行./CC-Switch-*.AppImage四、v3.16 完整使用教程步骤1首次启动自动扫描本地AI工具打开软件后程序自动扫描系统内已安装的Claude Code、Gemini CLI等客户端左侧工具栏会加载全部识别到的AI工具未安装的工具可手动勾选「跳过扫描」仅管理已有程序。步骤2添加API服务商核心操作支持接入Claude官方、DeepSeek、MiniMax、智谱GLM、Kimi、第三方中转API等主界面点击「添加供应商」号按钮填写配置参数自定义名称如DeepSeek-工作密钥API地址Base URL对应厂商官方接口地址API Key复制厂商后台生成的密钥切勿泄露泄露会产生盗刷扣费模型映射默认自动匹配特殊兼容模型手动填写名称开启可选功能故障转移当前密钥限流/额度耗尽自动切换备用服务商用量统计开启后记录Token消耗、实时估算费用点击保存服务商列表新增配置项。步骤3给AI工具绑定服务商、一键切换左侧选中需要管理的工具例Claude Code顶部下拉框选择已添加的API供应商软件自动重写该工具本地配置文件无需手动修改json/yaml切换完成后重启对应AI客户端即可生效v3.16新增「一键重启工具」按钮无需手动关闭终端。步骤4进阶核心功能v3.16新增1MCP服务可视化管理右侧侧边栏打开「MCP」面板可视化添加、启停、配置本地MCP服务统一给所有AI编程工具共享技能。2Skills/系统提示词全局管理内置提示词模板库可自定义全局角色指令一键同步至全部绑定工具支持导入导出提示词备份。3Token用量监控顶部「用量」图标进入统计页按日/周/月查看各服务商输入、输出Token消耗自动换算人民币/美元成本支持导出CSV对账。4配置自动备份设置中开启WebDAV/本地文件夹备份定时保存所有API密钥、服务商配置重装系统一键恢复。五、常见问题与排错切换服务商后AI工具不生效解决点击软件内「重启客户端」检查API地址/Key是否复制完整关闭工具终端重新打开。macOS每次打开都提示未知开发者解决终端执行命令永久放行xattr-cr/Applications/CC\Switch.appWindows杀毒软件删除程序解决将安装目录/便携文件夹加入杀毒信任区源码开源无病毒误报为正常现象。密钥自动失效、频繁报错429限流解决开启「故障转移」添加2个及以上备用服务商降低单轮请求并发。Linux AppImage无法保存配置解决赋予文件夹完整读写权限或切换deb/rpm安装版。六、卸载干净教程Windows设置→应用→找到CC-Switch卸载程序删除残留配置目录C:\Users\你的用户名\.ccswitchmacOS应用程序中将CC Switch.app移至废纸篓删除配置缓存~/.ccswitchLinuxdeb/rpmsudo apt remove cc-switchAppImage直接删除文件删除~/.ccswitch配置文件夹七、安全合规重申禁止通过私人网络私自接入境外大模型API、境外中转代理企业使用需完成跨境互联网访问合规备案API Key属于付费凭证不要上传至截图、聊天、网盘一旦泄露立即在厂商后台删除重建仅使用GitHub官方Release安装包第三方修改版存在窃取密钥风险CC-Switch仅做本地配置转发不提供翻墙、网络代理能力如需访问境外API需完成合规网络通道建设。
