一、项目地址（官方）

• 下载页（Releases）：https://pan.quark.cn/s/d6152047213b

• 手动安装（可选）
  1. 进入 Releases，下载 .msi（安装版）或 .zip（便携版）。
  2. MSI 双击安装；便携版解压直接运行 cc-switch.exe。

三、macOS 一键安装（Homebrew，推荐）

# 添加源 + 安装
brew tap farion1231/ccswitch
brew install --cask cc-switch

# 启动（终端）
cc-switch

• 手动安装（可选）
  1. Releases 下载 .dmg，拖入应用程序。
  2. 首次运行提示“无法验证开发者”：系统设置 → 隐私与安全性 → 仍然打开。

四、Linux 一键安装（Debian/Ubuntu）

# 下载并安装（以 v3.12.3 为例）
wget https://ghproxy.net/https://github.com/farion1231/cc-switch/releases/download/v3.12.3/CC-Switch-v3.12.3-Linux.deb
sudo dpkg -i CC-Switch-v3.12.3-Linux.deb
sudo apt install -f  # 修复依赖（如需要）

• 其他发行版
  • Fedora/RHEL：下载 .rpm → sudo rpm -i xxx.rpm。
  • Arch：paru -S cc-switch-bin 或 yay -S cc-switch-bin。
  • AppImage：赋予执行权限 → 直接运行。
    

五、一键配置（以 Claude Code 为例）

1. 打开 CC-Switch，点击右上角 + 添加供应商。

2. 选择预设（如 OpenRouter、DeepSeek、Kimi 等，共50+）。

3. 填写：

   • API Key：你的密钥（必填）
   • Base URL：预设自动填充，或自定义
   • 模型映射：高级选项中填写对应模型名（如 claude-3-sonnet-20240229）。
     

4. 点击 启用，一键切换，无需重启 Claude Code。

六、核心功能

• ✅ 一键切换 Claude Code / Codex / Gemini CLI 等 API Key 与端点。
• ✅ 50+ 内置提供商预设，支持自定义。
• ✅ 系统托盘快速切换、自动故障转移、本地代理。
• ✅ 所有配置本地 SQLite 存储，安全可控。

七、常见问题

• macOS 提示“损坏”：xattr -cr "/Applications/CC Switch.app"。
• Windows 提示“未知发布者”：允许运行即可。
• 切换不生效：重启终端或 Claude Code 客户端。