CC-Switch v3.16.1 完整下载、安装、配置教程2026最新一、软件基础说明CC-Switch 是MIT开源免费跨平台工具用于统一管理 Claude Code、Codex、Gemini CLI、OpenCode 等AI编程工具的API密钥、多模型服务商切换、本地路由、用量统计、MCP服务统一管理所有API密钥本地AES加密存储不上传云端无收费捆绑。v3.16.1 发布时间2026-06-01适配 Win10/macOS12/Ubuntu22.04。二、官方安全下载渠道仅以下渠道可信1. 国内高速备用GitHub访问慢时---------全平台安装包https://pan.quark.cn/s/d6152047213b---------2. v3.16.1 各平台安装包清单系统两种安装方案文件名称Windows安装版推荐自动更新CC-Switch-v3.16.1-Windows.msiWindows便携绿色版免安装CC-Switch-v3.16.1-Windows-Portable.zipmacOSDMG镜像通用Intel/M芯片CC-Switch-v3.16.1-macOS_Universal.dmgmacOSHomebrew一键安装终端命令安装Linux Debian/Ubuntudeb安装包cc-switch_3.16.1_amd64.debLinux 全发行版AppImage便携包CC-Switch-v3.16.1-linux-x86_64.AppImage三、分系统详细安装步骤一Windows系统方案1MSI标准安装版推荐下载.msi文件双击启动安装向导弹出Windows SmartScreen拦截点击更多信息 → 仍要运行同意协议点击Next自定义安装路径点击Change改为D盘/非系统盘推荐持续Next等待写入文件最后勾选Launch CC Switch点击Finish完成开始菜单打开软件托盘常驻图标。方案2便携绿色版免写入注册表下载Portable.zip压缩包解压到纯英文无空格文件夹如D:\Tools\CCSwitch直接双击CC-Switch.exe启动无需安装删除文件夹即卸载。二macOS系统方案1Homebrew一键安装最稳定打开终端依次执行两行命令brew tap farion1231/ccswitch brew install --cask cc-switch安装完成后启动台直接打开CC Switch。方案2DMG手动安装下载.dmg镜像双击打开将CC Switch.app拖拽到「应用程序」文件夹首次打开提示「无法验证开发者」拦截方式A系统设置 → 隐私与安全性 → 下滑找到「仍要打开」方式B终端执行命令放行xattr -cr /Applications/CC Switch.app重新启动软件即可正常使用。三Linux系统Debian/Ubuntudeb包sudo dpkg -i cc-switch_3.16.1_amd64.deb # 依赖缺失执行修复 sudo apt -f installAppImage通用包所有发行版# 添加执行权限 chmod x CC-Switch-v3.16.1-linux-x86_64.AppImage # 直接运行 ./CC-Switch-v3.16.1-linux-x86_64.AppImage四、首次启动核心配置教程必看前置准备提前准备好任意兼容OpenAI格式的API密钥DeepSeek、Kimi、字节方舟、Anthropic官方、MiniMax等均可。步骤1识别本地AI工具软件打开后自动扫描电脑已安装工具Claude Code、Codex、Gemini CLI等左侧工具栏会显示识别到的工具图标。步骤2添加API服务商以DeepSeek国内直连为例右上角点击 添加提供商服务商预设列表选择对应厂商DeepSeek、OpenAI、Anthropic、自定义中转填写配置参数名称自定义备注如DeepSeek-CoderAPI Key官网申请的sk开头密钥Base URL厂商官方地址DeepSeek默认https://api.deepseek.com中转API填写服务商提供地址API格式默认OpenAI Chat Completions绝大多数模型通用模型下拉选择代码专用模型deepseek-coder-v2、claude-3.5-sonnet等点击「添加并保存」服务商列表生成条目。步骤3绑定AI工具一键切换模型左侧选中需要配置的工具如Claude Code顶部下拉框选择刚才添加的服务商软件自动接管本地配置文件开启「本地路由」开关核心功能自动拦截工具API请求转发到你配置的服务商无需手动修改环境变量/配置JSON。步骤4高级功能配置多服务商故障转移添加多个服务商后拖动排序优先级主服务商超时/报错时自动切换备用密钥。Token用量成本统计侧边栏「用量面板」实时统计消耗Token、请求次数、预估费用支持自定义模型单价。统一MCP/Skills/提示词管理右侧图标栏Skills、MCP服务、系统提示词、会话历史所有AI工具共用一套提示词与插件无需重复配置。托盘快捷切换最小化后软件驻留系统托盘右键可快速切换服务商、开启/关闭路由、导出配置备份。五、常见问题解决Windows打开提示安全拦截弹窗点「更多信息-仍要运行」便携版右键exe→属性→勾选「解除锁定」。macOS无法打开未知开发者终端执行放行命令xattr -cr /Applications/CC Switch.app。Claude Code不生效、模型未切换确认「本地路由」已开启重启Claude Code终端/IDE插件检查Base URL与API Key正确性。GitHub下载缓慢使用国内夸克网盘备用链接下载全平台包。卸载备份配置设置面板导出.ccswitch-backup备份文件卸载后重装可一键导入恢复所有密钥与服务商。六、安全提醒仅使用本文官方渠道下载第三方修改安装包存在密钥泄露风险不使用不知名小众中转API优先大厂官方APIDeepSeek、字节方舟、MiniMax等CC-Switch密钥仅本地加密存储不会上传网络可放心填入API Key第三方中转API存在跑路、限流风险充值小额测试为主。