一、官方下载地址

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

二、Windows 安装（二选一）

方式1：MSI 安装包（推荐）

1. 打开上述 Releases 页，下载最新版 .msi（如 CC-Switch-v3.13.0-Windows-x64.msi）。
2. 双击 → 下一步 → 同意协议 → 默认路径 → 安装 → 完成并启动。
3. 若弹出 SmartScreen“无法验证发行者”：点更多信息 → 仍要运行。

方式2：便携版（绿色免安装）

1. 下载对应版本的 -Portable.zip。
2. 解压到任意目录，双击 CC-Switch.exe 直接运行。

三、macOS 安装（二选一）

方式1：Homebrew（推荐）

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

方式2：手动安装

1. Releases 页下载 .dmg 或 .zip。
2. DMG：拖 CC-Switch.app 到应用程序；ZIP：解压后拖入应用程序。
3. 首次运行提示“无法验证开发者”：系统设置 → 隐私与安全性 → 仍要打开。

四、Linux 安装（Debian/Ubuntu 为例）

# 下载 deb 包（替换为最新版）
wget https://github.com/farion1231/cc-switch/releases/download/v3.13.0/cc-switch_3.13.0_amd64.deb

# 安装
sudo dpkg -i cc-switch_3.13.0_amd64.deb

# 若依赖报错，执行修复
sudo apt install -f

五、首次使用（快速配置）

1. 打开 CC-Switch，点右上角 + 添加供应商。
2. 选预设（如 DeepSeek、GLM、Kimi）或自定义，填写：
   • Provider Name：自定义别名
   • Base URL：API 地址
   • API Key：你的密钥
3. 保存后，在列表中切换即可自动写入 Claude/Codex 配置。