CC-Switch v3.16.1 完整下载安装配置教程CC-Switch 是开源免费跨平台工具统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI 等AI编程工具一键切换多API供应商密钥v3.16.1发布于2026-06-01。一、下载 v3.16.1官方渠道优先1. 国内高速备用GitHub下载慢时用全平台v3.16.1安装包https://pan.quark.cn/s/d6152047213b安全提醒任何收费、充值的CC-Switch均为山寨软件完全免费开源。WindowsWin10 64位安装版推荐自带自动更新CC-Switch-v3.16.1-Windows.msi便携绿色版免安装、无注册表CC-Switch-v3.16.1-Windows-Portable.zipmacOSmacOS 12Intel/M芯片通用CC-Switch-v3.16.1-macOS_Universal.dmg也可Homebrew一键安装brew tap farion1231/ccswitch brewinstall--caskcc-switchLinuxDebian/Ubuntucc-switch_3.16.1_amd64.debFedora/RHEL.rpm包通用免安装.AppImage二、分平台安装步骤Windows 方案1MSI安装版推荐双击.msi文件弹窗点是允许权限点击Next下一步同意协议默认C盘路径点Change改到D盘不要中文路径勾选创建桌面快捷方式一路Next等待安装完成勾选Launch CC Switch→Finish自动启动Windows 方案2便携绿色版解压Portable.zip到D盘文件夹不要桌面/下载文件夹直接双击目录内CC-Switch.exe运行所有配置保存在解压文件夹可U盘随身携带不写注册表macOS 安装双击.dmg将CC Switch.app拖入「应用程序」文件夹首次打开提示无法验证开发者系统设置 → 隐私与安全性 → 下滑找到「仍要打开」即可启动Linux 安装Debian/Ubuntusudodpkg-icc-switch_3.16.1_amd64.debAppImage通用包chmodx CC-Switch-3.16.1.AppImage ./CC-Switch-3.16.1.AppImage三、核心配置教程新手必看前置准备提前准备好你的API服务商信息如DeepSeek、Kimi、中转API等API密钥sk-xxxxAPI接口Base URL服务商控制台复制步骤1首次启动自动扫描AI工具打开软件后会自动识别本地已装Claude Code、Claude Desktop、Codex等顶部显示工具分类标签。步骤2添加API供应商两种方式点击界面右上角 添加供应商方式A预设供应商推荐自动填充地址下拉Preset选择大厂DeepSeek、智谱、Kimi、Anthropic官方等仅需填入API Key自动填充接口地址。方式B自定义第三方中转API选择「自定义Custom」完整填写名称自定义如「小麦API-Claude」Base URL服务商接口地址末尾不能带/否则请求报错API Key你的密钥模型映射下拉选择可用模型点击「Add」保存供应商。步骤3一键切换启用API配置顶部选中目标工具Claude Code / Claude Desktop在供应商列表点右侧Enable启用状态变为Active代表已自动写入AI工具本地配置文件关闭VS Code/Claude客户端重新打开新API立即生效步骤4关键优化设置解决常见报错左上角打开「设置」→ 通用✅ 勾选跳过Claude Code登录确认弹窗避免强制登录官方账号✅ 开启托盘常驻右下角右键快速切换供应商Claude Desktop用户开启内置路由转发解决第三方API拦截问题四、常用进阶功能用量统计查看各API调用额度、消耗记录会话管理多套提示词/会话存档一键切换工作场景MCP服务管理统一配置Claude扩展工具服务故障自动切换主API失效自动切备用供应商托盘快捷操作无需打开主窗口右下角右键快速换Key五、常见问题排查API调用404Base URL末尾多了斜杠/删掉重新保存Claude Code仍走官方API启用供应商后重启VS CodemacOS打不开系统隐私设置放行未知开发者GitHub下载失败使用国内夸克备用网盘便携版配置丢失不要解压到系统临时目录固定存放D盘工具文件夹