一、CC‑Switch v3.16.1 免费下载（开源免费）

---

下载（v3.16.1）

🚀 国内备用（高速下载）

https://pan.quark.cn/s/d6152047213b （含 v3.16.1 全平台包）

---

🔗 官方 GitHub（优先）

在 Assets 里对应系统下载：

• Windows（Win10+ x64）
  • 安装版（自动更新）：CC-Switch-v3.16.1-Windows.msi
  • 便携版（免安装）：CC-Switch-v3.16.1-Windows-Portable.zip
• macOS（12+，Intel/Apple Silicon）
  • 镜像：CC-Switch-v3.16.1-macOS_Universal.dmg
  • Homebrew（推荐）：

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

• Linux（Ubuntu 22.04+/Debian 11+/Fedora 34+）
  • Debian/Ubuntu：cc-switch_3.16.1_amd64.deb
  • Fedora：cc-switch-3.16.1.x86_64.rpm
  • 通用：CC-Switch-v3.16.1-Linux.AppImage

二、安装步骤

Windows

• MSI：双击 → 同意协议 → 下一步 → 完成，开始菜单启动。
• 便携版：解压 → 直接运行 CC-Switch.exe。

macOS

• DMG：双击 → 将 CC Switch.app 拖入「应用程序」。
• 首次运行提示“未知开发者”：系统设置 → 隐私与安全性 → 点击「仍要打开」。

Linux

• Deb：sudo dpkg -i cc-switch_3.16.1_amd64.deb。
• AppImage：chmod +x xxx.AppImage → 双击运行。

三、使用方法（核心流程）

1. 首次启动

自动扫描已安装的 AI 工具（Claude Code/Codex/Gemini CLI 等），系统托盘出现图标。

2. 选择要管理的应用

顶部栏点击图标切换（Claude Code / Codex / Gemini CLI 等），可在设置隐藏不用的应用。

3. 添加 API 供应商（Provider）

1. 点右上角 +，选内置预设（Anthropic/DeepSeek/阿里百炼等）或手动填写。
2. 必填项：
   • 名称：自定义（如“DeepSeek”）
   • API Key：你的密钥
   • Base URL：可选（自定义代理）
   • 模型：默认模型名
   • API 格式：Anthropic 或 OpenAI 兼容

4. 一键切换供应商

列表选中 → 点 启用，自动写入对应 CLI 配置；终端直接运行 claude/codex 即生效。

5. 健康检查（验证连通性）

点「健康检查」，发送测试请求，快速定位 Key/网络问题。

6. 常用功能

• 用量统计：查看各供应商调用次数与额度。
• 会话管理：保存/切换会话，恢复历史对话。
• 路由转发（Codex 专用）：设置 → 路由 → 开启本地路由（127.0.0.1:15721），接管 Codex 第三方模型调用。

四、常见问题

• Windows 提示“无法验证发行者”：点「更多信息」→「仍要运行」。
• macOS 打不开：隐私与安全性 → 仍要打开。
• 切换后不生效：重启终端/AI 工具，检查路由是否开启（Codex）。

五、安全提醒

• 仅从 GitHub 官方/夸克备用链 下载，避免第三方修改版。
• API Key 本地加密存储，仅转发给你指定的供应商。