2026 最新 CC-Switch v3.16 完整版教程｜下载安装一键切换 API 全流程

CC-Switch 下载、安装与使用全指南（2026最新 v3.16+）

一、官方下载渠道（v3.16+ 2026稳定版）

一、下载（v3.16.1）

🚀 国内备用（高速下载）

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

  1. 页面下滑至Releases，找到最新v3.16+版本展开Assets
  2. 按系统选择对应安装包：
    | 系统 | 推荐安装包 | 便携免安装包 |
    |------|------------|--------------|
    | 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标准版）

  1. 双击下载的CC-Switch-v3.16.msi，弹出安装向导，点击Next
  2. 默认路径为C盘，点击Change更换至D/E盘（避免C盘占用），确认后Next
  3. 同意开源许可协议，一路下一步，等待进度条完成
  4. 勾选Launch CC Switch，点击Finish自动启动软件
Windows便携版（无安装流程）

解压.zip压缩包，直接运行CC-Switch.exe即可，所有配置存在解压文件夹内，可拷贝U盘随身携带。

注意：Windows Defender可能误报，将解压文件夹加入杀毒白名单，开源源码可自行审计无恶意代码。

2. macOS 安装（DMG镜像）

  1. 双击.dmg文件，弹出挂载窗口，将CC Switch.app拖拽至「应用程序」文件夹
  2. 首次打开提示无法验证开发者（无苹果付费开发者证书，正常现象）
  3. 解决权限：打开「系统设置」→「隐私与安全性」，下滑找到「仍要打开」，确认启动
  4. 后续可直接从启动台打开，无需重复授权

3. Linux 安装

Debian/Ubuntu系（.deb）
sudodpkg-iCC-Switch-v3.16-linux-amd64.deb# 缺失依赖执行修复sudoapt-finstall
Fedora/RHEL（.rpm）
sudodnfinstall./CC-Switch-v3.16-linux-x86_64.rpm
全发行版通用 AppImage
# 添加执行权限chmod+x CC-Switch-*.AppImage# 直接运行./CC-Switch-*.AppImage

四、v3.16+ 完整使用教程

步骤1：首次启动自动扫描本地AI工具

打开软件后，程序自动扫描系统内已安装的Claude Code、Gemini CLI等客户端，左侧工具栏会加载全部识别到的AI工具；
未安装的工具可手动勾选「跳过扫描」，仅管理已有程序。

步骤2：添加API服务商（核心操作）

支持接入：Claude官方、DeepSeek、MiniMax、智谱GLM、Kimi、第三方中转API等

  1. 主界面点击「添加供应商」（+号按钮）
  2. 填写配置参数：
    • 自定义名称：如DeepSeek-工作密钥
    • API地址（Base URL）：对应厂商官方接口地址
    • API Key：复制厂商后台生成的密钥（切勿泄露，泄露会产生盗刷扣费）
    • 模型映射：默认自动匹配，特殊兼容模型手动填写名称
  3. 开启可选功能：
    • 故障转移：当前密钥限流/额度耗尽，自动切换备用服务商
    • 用量统计：开启后记录Token消耗、实时估算费用
  4. 点击保存，服务商列表新增配置项。

步骤3：给AI工具绑定服务商、一键切换

  1. 左侧选中需要管理的工具（例：Claude Code）
  2. 顶部下拉框选择已添加的API供应商，软件自动重写该工具本地配置文件，无需手动修改json/yaml
  3. 切换完成后，重启对应AI客户端即可生效；v3.16新增「一键重启工具」按钮，无需手动关闭终端。

步骤4：进阶核心功能（v3.16新增）

1）MCP服务可视化管理

右侧侧边栏打开「MCP」面板，可视化添加、启停、配置本地MCP服务，统一给所有AI编程工具共享技能。

2）Skills/系统提示词全局管理

内置提示词模板库，可自定义全局角色指令，一键同步至全部绑定工具；支持导入导出提示词备份。

3）Token用量监控

顶部「用量」图标进入统计页，按日/周/月查看各服务商输入、输出Token消耗，自动换算人民币/美元成本，支持导出CSV对账。

4）配置自动备份

设置中开启WebDAV/本地文件夹备份，定时保存所有API密钥、服务商配置，重装系统一键恢复。

五、常见问题与排错

  1. 切换服务商后AI工具不生效
    解决：点击软件内「重启客户端」；检查API地址/Key是否复制完整；关闭工具终端重新打开。
  2. macOS每次打开都提示未知开发者
    解决：终端执行命令永久放行：
    xattr-cr/Applications/CC\Switch.app
  3. Windows杀毒软件删除程序
    解决：将安装目录/便携文件夹加入杀毒信任区，源码开源无病毒，误报为正常现象。
  4. 密钥自动失效、频繁报错429限流
    解决：开启「故障转移」，添加2个及以上备用服务商；降低单轮请求并发。
  5. Linux AppImage无法保存配置
    解决：赋予文件夹完整读写权限，或切换deb/rpm安装版。

六、卸载干净教程

Windows

  1. 设置→应用→找到CC-Switch，卸载程序
  2. 删除残留配置目录：C:\Users\你的用户名\.ccswitch

macOS

  1. 应用程序中将CC Switch.app移至废纸篓
  2. 删除配置缓存：~/.ccswitch

Linux

  • deb/rpm：sudo apt remove cc-switch
  • AppImage：直接删除文件，删除~/.ccswitch配置文件夹

七、安全&合规重申

  1. 禁止通过私人网络私自接入境外大模型API、境外中转代理，企业使用需完成跨境互联网访问合规备案；
  2. API Key属于付费凭证，不要上传至截图、聊天、网盘，一旦泄露立即在厂商后台删除重建；
  3. 仅使用GitHub官方Release安装包，第三方修改版存在窃取密钥风险；
  4. CC-Switch仅做本地配置转发，不提供翻墙、网络代理能力，如需访问境外API需完成合规网络通道建设。