✅ CC‑Switch v3.16.1(2026‑06‑01 最新官方版)
一句话:开源免费、跨平台(Windows/macOS/Linux),统一管理 Claude Code、Codex、Gemini CLI 等 AI 编程工具的 API Key 与模型切换。
一、下载(v3.16.1)
🚀 国内备用(高速下载)
https://pan.quark.cn/s/d6152047213b (含 v3.16.1 全平台包)
二、安装(分系统)
Windows
安装版(.msi)
- 双击 → 同意协议 →自定义路径(建议非C盘、无中文空格)→ 下一步 → 完成。
- 双击 → 同意协议 →自定义路径(建议非C盘、无中文空格)→ 下一步 → 完成。
便携版(.zip)
- 解压到全英文路径 → 双击
CC-Switch.exe直接运行,配置保存在data目录。
- 解压到全英文路径 → 双击
macOS
- DMG 安装
- 双击
.dmg→ 将CC Switch.app拖入「应用程序」。 - 首次启动提示“无法验证开发者”:系统设置 → 隐私与安全性 → 仍要打开。
- 双击
- Homebrew(推荐)
brew tap farion1231/ccswitch brewinstall--caskcc-switch
Linux
- Debian/Ubuntu
sudodpkg-icc-switch_3.16.1_amd64.deb - Fedora/RHEL
sudodnfinstallCC-Switch-v3.16.1.x86_64.rpm - AppImage(通用)
chmod+x CC-Switch-v3.16.1.AppImage ./CC-Switch-v3.16.1.AppImage
三、首次配置(核心)
1. 启动与界面
- 打开后自动扫描已安装的 AI 工具(Claude Code、Codex 等)。
- 左侧:工具列表;右侧:配置区;右上角:+(添加供应商)。
2. 添加 API 供应商(以 DeepSeek 为例)
点击右上角+→ 选择供应商(如 DeepSeek)或自定义。
填写:
- 名称:自定义(如“DeepSeek”)
- API 地址:
https://api.deepseek.com/v1 - API Key:你的密钥
- 模型映射:默认或自定义。
保存 → 在工具下拉菜单中选择该供应商即可一键切换。
3. 工具切换(以 Claude Code 为例)
- 左侧选择Claude Code CLI。
- 顶部供应商下拉 → 选择已添加的供应商(如 DeepSeek)。
- 切换后自动生效,终端输入
claude即可使用新模型。
四、v3.16.1 关键更新
- Codex 应用增强:官方 auth.json 与第三方 config.toml 分离,互不干扰。
- 新增 22+ 国产模型:DeepSeek、百度千帆、GLM、MiniMax 等一键接入。
- 性能优化:启动更快、切换更稳,修复旧版崩溃问题。
五、常见问题
- Windows 便携版打不开:解压路径无中文、无空格,以管理员身份运行。
- macOS 提示未知开发者:系统设置 → 隐私与安全性 → 仍要打开。
- Claude Code/Codex 未扫描到:手动安装工具后重启 CC‑Switch,或在设置中手动指定路径。
六、升级建议
- 旧版用户:先卸载旧版→ 安装 v3.16.1 → 重新添加供应商(配置可迁移)。
- 新版特性:优先体验Codex 应用增强与国产模型一键接入。