Windows系统 CC-Switch v3.16.1 保姆级完整配置教程小白专用前置须知必看避开90%报错系统要求Win10 1903及以上 / Win1132位系统不兼容仅支持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安全警告下载后浏览器提示「此文件可能有害」点击保留/仍然下载开源软件无数字签名属于正常安全弹窗无病毒。二、方案1MSI安装版详细安装步骤双击下载好的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 工具中文/空格一路点击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。问题2API调用请求失败BaseURL末尾多了斜杠删除末尾/重新保存配置API Key复制时带空格重新粘贴清理多余字符对应平台账号余额耗尽登录服务商后台充值。问题3切换API后工具不生效完全关闭VS Code、终端、Claude Code客户端全部重启依旧无效就重启CC-Switch。问题4解压/安装权限不足右键软件安装包/解压文件夹 → 属性 → 安全给当前用户开启完全控制权限。八、完整卸载教程无残留MSI安装版打开 设置 → 应用 → 安装的应用搜索CC-Switch点击卸载卸载后删除自定义安装文件夹便携版直接删除整个解压文件夹即可无残留文件清理残留WinR输入%appdata%删除CCSwitch相关文件夹。