一、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)
- 名称:自定义(如“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 本地加密存储,仅转发给你指定的供应商。


