CC-Switch 下载、安装与使用全指南2026最新v3.14.1CC-Switch 是跨平台AI API一键切换管理器统一管理 Claude Code、DeepSeek、Kimi、智谱、MiniMax 等模型不用改环境变量、不用手动改配置文件VS Code/终端一键切换AI服务商。一、官方下载渠道唯一安全|下载| https://pan.quark.cn/s/d6152047213b系统要求WindowsWin10 x64macOS12 MontereyIntel/M芯片通用LinuxUbuntu 22.04/Debian 11各平台安装包WindowsMSI 安装版推荐自动更新、注册表注册CC-Switch-v3.14.1-Windows.msi绿色便携版免安装、不写注册表CC-Switch-v3.14.1-Windows-Portable.zipmacOS.dmg/.zip/ Homebrew 一键安装Linux.deb/.AppImage通用包二、分平台详细安装教程Windows 安装MSI 标准版新手首选双击下载.msi→ 下一步一路默认安装开始菜单/桌面打开 CC-Switch自动后台托盘常驻便携绿色版解压.zip→ 直接运行CC Switch.exe无安装、无残留公司电脑/U盘随身可用macOS 安装Homebrew 一键推荐brew tap farion1231/ccswitch brewinstall--caskcc-switch# 更新brew upgrade--caskcc-switch手动安装下载.dmg→ 拖入「应用程序」首次打开系统设置→安全性与隐私→允许运行Linux 安装Ubuntu/Debiansudodpkg-iCC-Switch-xxx.debsudoapt-getinstall-f# 修复依赖# AppImage通用chmodx CC-Switch-xxx.AppImage ./CC-Switch-xxx.AppImage三、首次配置基础使用5分钟上手1. 添加AI模型服务商核心步骤打开 CC-Switch 主界面点右上角 添加供应商选择国内预设模型DeepSeek、Kimi、智谱GLM、MiniMax、字节方舟等软件自动填充API地址只需要粘贴你的API Key点击「添加」服务商进入列表API Key 获取对应AI平台控制台→API密钥管理→新建密钥、复制保存2. 一键切换模型主界面点对应卡片启用显示「使用中」即生效托盘快捷Windows右下角/macOS顶部菜单栏右键图标→直接点服务商不用开主窗口3. VS Code / 终端生效规则Claude Code热切换立即生效无需重启Codex/Gemini/终端CLI关闭重启终端即可4. VS Code 联动设置VS Code 安装Claude Code插件CC-Switch 开启「跳过Claude首次引导」插件自动读取CC-Switch当前配置无缝切换模型四、进阶实用功能多配置存档同时保存多个API、多套餐随时切换自动版本更新设置→检查更新一键升级无重装MCP服务统一管理AI工具扩展协议一站式配置后台常驻最小化托盘开机自启不占用前台资源五、常见问题排查打不开/闪退关闭杀毒拦截、更新到最新版、Windows以管理员运行API连接失败核对Key正确性、余额充足、端点地址无误macOS提示无法打开放行系统安全权限旧版本升级异常卸载旧版→重装最新MSI包六、安全提醒只从GitHub Releases下载拒绝第三方破解/修改版API Key不要泄露、不要公开分享定期轮换密钥国内优先用合规国内模型无需额外网络工具即可稳定使用