✅ 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

1. 安装版（.msi）

   • 双击 → 同意协议 → 自定义路径（建议非C盘、无中文空格） → 下一步 → 完成。
     
     
     

2. 便携版（.zip）

   • 解压到全英文路径 → 双击 CC-Switch.exe 直接运行，配置保存在 data 目录。

macOS

1. DMG 安装
   • 双击 .dmg → 将 CC Switch.app 拖入「应用程序」。
   • 首次启动提示“无法验证开发者”：系统设置 → 隐私与安全性 → 仍要打开。
2. Homebrew（推荐）

   brew tap farion1231/ccswitch
   brew install --cask cc-switch
   

Linux

• Debian/Ubuntu

  sudo dpkg -i cc-switch_3.16.1_amd64.deb
  

• Fedora/RHEL

  sudo dnf install CC-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 为例）

1. 点击右上角 + → 选择供应商（如 DeepSeek）或自定义。
   

2. 填写：

   • 名称：自定义（如“DeepSeek”）
   • API 地址：https://api.deepseek.com/v1
   • API Key：你的密钥
   • 模型映射：默认或自定义。

3. 保存 → 在工具下拉菜单中选择该供应商即可一键切换。

3. 工具切换（以 Claude Code 为例）

1. 左侧选择 Claude Code CLI。
2. 顶部供应商下拉 → 选择已添加的供应商（如 DeepSeek）。
3. 切换后自动生效，终端输入 claude 即可使用新模型。

---

四、v3.16.1 关键更新

• Codex 应用增强：官方 auth.json 与第三方 config.toml 分离，互不干扰。
• 新增 22+ 国产模型：DeepSeek、百度千帆、GLM、MiniMax 等一键接入。
• 性能优化：启动更快、切换更稳，修复旧版崩溃问题。

---

五、常见问题

1. Windows 便携版打不开：解压路径无中文、无空格，以管理员身份运行。
2. macOS 提示未知开发者：系统设置 → 隐私与安全性 → 仍要打开。
3. Claude Code/Codex 未扫描到：手动安装工具后重启 CC‑Switch，或在设置中手动指定路径。

---

六、升级建议

• 旧版用户：先卸载旧版 → 安装 v3.16.1 → 重新添加供应商（配置可迁移）。
• 新版特性：优先体验 Codex 应用增强与国产模型一键接入。