Windows系统 CC-Switch v3.16.1 保姆级完整配置教程（小白专用）
前置须知（必看，避开90%报错）
- 系统要求：Win10 1903及以上 / Win11，32位系统不兼容，仅支持64位；
- 路径红线：软件存放文件夹不能有中文、空格、特殊符号；
- 安全提示：仅GitHub官方Releases下载，拒绝第三方修改绿色版，防止API密钥被盗；
- 软件作用：统一管理各类大模型API，给Claude Code、本地AI代码工具切换密钥、中转接口。
一、下载 CC-Switch v3.16.1 Windows安装包
1. 下载地址
国内备用（高速）： https://pan.quark.cn/s/d6152047213b
提供两个Windows版本，按需选择：
- MSI安装版（新手推荐）：
CC-Switch-v3.16.1-x64.msi，自动写入环境、支持开机自启； - Portable便携版（免安装）：
CC-Switch-v3.16.1-x64-Portable.zip，解压即用，无注册表残留。
2. 浏览器拦截处理（Windows安全警告）
下载后浏览器提示「此文件可能有害」：
点击保留/仍然下载，开源软件无数字签名，属于正常安全弹窗，无病毒。
二、方案1：MSI安装版详细安装步骤
- 双击下载好的
CC-Switch-v3.16.1-x64.msi，弹出安装向导，点击【Next】 - 同意协议：勾选
I accept the terms in the License Agreement→ Next - 修改安装目录（关键！不建议装C盘）
- 点击【Change】，自定义路径示例：
D:\Tools\CCSwitch - ❌ 禁止路径：
D:\工具\CC切换、C:\Program Files\CC Switch 工具（中文/空格）
- 点击【Change】，自定义路径示例：
- 一路点击Next，等待进度条跑完安装
- 安装完成界面，勾选
Launch CC Switch，点击Finish自动启动软件
Windows Defender SmartScreen拦截解决
双击安装包弹出「Windows已阻止此应用」：
- 弹窗底部点【更多信息】
- 右下角出现【仍要运行】，点击即可正常安装。
三、方案2：便携版（免安装）操作步骤
- 把
CC-Switch-v3.16.1-x64-Portable.zip剪切到D盘新建英文文件夹，例D:\CCSwitchPortable - 右键压缩包 → 全部解压，不要直接在压缩包内双击运行
- 进入解压文件夹，找到
CC-Switch.exe - 右键exe文件 → 发送到桌面快捷方式，方便后续打开
四、首次启动初始化设置
- 双击桌面快捷方式打开软件
- 首次弹窗询问【开机自动启动】：开发用户建议勾选，日常使用可选取消
- 软件自动扫描本地已安装AI编程工具（Claude Code等），等待10秒扫描完成
- 主界面空白，下一步添加大模型API服务商
五、核心配置：添加API密钥（实操步骤）
5.1 内置预设服务商（小白首选，自动填充接口地址）
- 软件右上角点击【+ 添加供应商】
- 顶部切换到「预设供应商」分类
- 下拉列表选择你使用的平台：DeepSeek、智谱清言、阿里百炼、MiniMax等
- 仅需要填写两项：
- 自定义名称：随便备注，如「DeepSeek编程专用」
- API Key：去对应大模型官网复制密钥，不要带前后空格
- 点击Add保存，BaseURL会自动填充，无需手动修改
5.2 自定义中转/小众API配置
- 添加窗口切换「自定义配置」
- 三项必填（避坑：BaseURL末尾不能带斜杠 /）
- 名称：自定义备注
- Base URL：接口地址（正确示例：
https://api.deepseek.com/v1，错误：https://api.deepseek.com/v1/） - API Key：服务商后台密钥
- 可自定义模型、单价、超时时间，完成保存
5.3 启用API并生效
- 左侧服务商列表，找到刚添加的接口，右侧点击【启用】
- 状态显示Active代表成功
- 如果你搭配Claude Code等终端工具：关闭所有终端窗口，重新打开即可加载新配置
六、Windows专属实用功能设置
6.1 多API自动故障切换
- 右上角打开【设置】→【路由配置】
- 开启「自动故障转移」，设置重试次数、请求超时
- 添加多个服务商后，主接口调用失败会自动切换备用密钥，不会中断代码对话
6.2 配置备份（重装不丢失密钥）
- 设置界面找到【备份与恢复】
- 点击导出备份，保存
.ccs-backup文件到非系统盘 - 重装软件后直接导入，一键恢复全部API、自定义参数
6.3 Token用量统计
左侧切换【用量面板】，自动统计请求次数、输入输出token、预估花费，支持按日期筛选。
七、Windows高频报错&一键解决
问题1：打开软件闪退/无响应
- 右键CC-Switch.exe → 以管理员身份运行；
- 检查软件路径是否含中文/空格，更换纯英文路径；
- 卸载旧版本CC-Switch，清理残留文件夹后重装v3.16.1。
问题2：API调用请求失败
- BaseURL末尾多了斜杠，删除末尾
/重新保存配置； - API Key复制时带空格，重新粘贴清理多余字符；
- 对应平台账号余额耗尽，登录服务商后台充值。
问题3：切换API后工具不生效
完全关闭VS Code、终端、Claude Code客户端，全部重启；依旧无效就重启CC-Switch。
问题4：解压/安装权限不足
右键软件安装包/解压文件夹 → 属性 → 安全，给当前用户开启完全控制权限。
八、完整卸载教程（无残留）
- MSI安装版：打开 设置 → 应用 → 安装的应用，搜索CC-Switch，点击卸载；卸载后删除自定义安装文件夹；
- 便携版：直接删除整个解压文件夹即可，无残留文件；
- 清理残留：Win+R输入
%appdata%，删除CCSwitch相关文件夹。
