一、下载（v3.16.1，2026-06-01）

国内高速备用

---

夸克网盘：https://pan.quark.cn/s/d6152047213b（含全平台v3.16.1包）

---

• 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
• Linux（Ubuntu22.04+/Debian11+/Fedora34+）
  • Debian/Ubuntu：cc-switch_3.16.1_amd64.deb
  • Fedora/RHEL：CC-Switch-v3.16.1-Linux-x86_64.rpm
  • AppImage：CC-Switch-v3.16.1-Linux-x86_64.AppImage

二、安装步骤

Windows

• 安装版（MSI，推荐）

  1. 双击 .msi → 同意协议 → 自定义安装路径（建议非C盘）

  2. 完成后从开始菜单启动

• 便携版（ZIP）
  解压到固定目录，直接运行 CC-Switch.exe，无需安装。

macOS

• Homebrew（推荐）

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

• 手动DMG
  双击 .dmg → 将 CC Switch.app 拖入「应用程序」；首次启动提示“未知开发者”时，前往系统设置→隐私与安全性→仍要打开。

Linux

• Debian/Ubuntu

sudo dpkg -i cc-switch_3.16.1_amd64.deb
sudo apt -f install -y  # 依赖修复（如需要）

• Fedora/RHEL

sudo rpm -i CC-Switch-v3.16.1-Linux-x86_64.rpm

• AppImage（通用）

chmod +x CC-Switch-v3.16.1-Linux-x86_64.AppImage
./CC-Switch-v3.16.1-Linux-x86_64.AppImage

---

三、首次配置（核心）

1. 安装AI CLI工具（必备）

CC-Switch仅管理配置，需手动安装目标工具：

• Claude Code

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

• Codex

npm install -g @openai/codex --registry=https://registry.npmmirror.com

• Gemini CLI

npm install -g @google/gemini-cli --registry=https://registry.npmmirror.com

2. 添加API供应商（以Claude Code为例）

1. 启动CC-Switch → 右上角**+** → 选择供应商（如Anthropic、DeepSeek、GLM、Kimi等50+预设）。
2. 填写：
   • Provider Name：自定义别名（如“Anthropic-官方”）
   • Base URL：API地址（如Anthropic：https://api.anthropic.com）
   • API Key：你的密钥
3. 点击Add保存，自动同步到Claude Code配置文件。

3. 一键切换与验证

• 顶部工具栏选择目标工具（Claude Code/Codex等）
• 下拉选择已配置供应商 → 一键切换
• 终端执行 claude code，确认生效。

---

四、常见问题

• Windows SmartScreen阻止：点更多信息→仍要运行。
• macOS“无法验证开发者”：系统设置→隐私与安全性→仍要打开。
• 配置不生效：重启CC-Switch，或手动删除 ~/.claude-code 后重新添加供应商。

---

五、核心功能

• 多供应商密钥一键切换（支持50+模型）
• 系统托盘快速访问、配置导入导出、MCP统一管理
• 跨平台配置同步、用量统计、会话历史管理。