CC-Switch 下载-安装-配置全流程【2026.4.30】

一、官方下载地址

下载页（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 brewinstall--caskcc-switch

方式2：手动安装

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

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

# 下载 deb 包（替换为最新版）wgethttps://github.com/farion1231/cc-switch/releases/download/v3.13.0/cc-switch_3.13.0_amd64.deb# 安装sudodpkg-icc-switch_3.13.0_amd64.deb# 若依赖报错，执行修复sudoaptinstall-f

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

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