跳转至

通用步骤

在使用 CC-Switch 配置各工具之前，需要先完成安装和环境准备。

安装 CC-Switch

  1. 前往 GitHub Releases 下载最新版本的 MSI 安装包
  2. 双击运行安装程序，按提示完成安装

使用 Homebrew 安装：

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

下载 .deb 安装包并安装：

sudo dpkg -i cc-switch_*.deb

前往 GitHub Releases 下载对应架构的版本。

环境检查

安装前提

使用 CC-Switch 之前，请确保已完成 环境检查，Node.js 和相关 CLI 工具已安装。

安装好 CC-Switch 后打开，它会自动检测本地已安装的 CLI 工具状态。

通用配置流程

CC-Switch 配置各工具的通用流程如下：

  1. 打开 CC-Switch 应用
  2. 在左侧选择要配置的工具（Claude / Codex / Gemini 等）
  3. 选择或添加供应商（Provider）
  4. 填入 API 地址和密钥
  5. 点击保存，CC-Switch 会自动写入对应的配置文件
  6. 在终端运行对应工具验证是否成功

小技巧

CC-Switch 配置完成后，可以在多个供应商之间一键切换，非常方便日常使用。