跳到主要内容

安装 CC Switch

CC Switch 是一个桌面管理工具，可以统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI 等工具的供应商配置、API Key、接口地址、MCP、Skills 和环境变量。对同时使用 Codex 与 Claude Code 的用户来说，它比手动改配置文件更省心。

Windows 安装​

Windows 用户优先从 GitHub Releases 下载：

  1. 打开 CC Switch Releases 页面。
  2. 下载最新版本的 CC-Switch-v{版本号}-Windows.msi。
  3. 双击安装。
  4. 如果不想安装，也可以下载 CC-Switch-v{版本号}-Windows-Portable.zip 便携版。

安装完成后，从开始菜单打开 CC Switch。

macOS 安装​

推荐 Homebrew：

brew install --cask cc-switch

更新：

brew upgrade --cask cc-switch

也可以从 Releases 页面下载 .dmg 安装包。

Linux 安装​

从 Releases 页面下载对应发行版的安装包：

系统文件
Debian / UbuntuCC-Switch-v{版本号}-Linux.deb
Fedora / RHEL / openSUSECC-Switch-v{版本号}-Linux.rpm
通用 LinuxCC-Switch-v{版本号}-Linux.AppImage

Arch Linux 用户可以使用：

paru -S cc-switch-bin

首次启动​

第一次打开 CC Switch 时建议这样做：

  1. 先安装好 Codex CLI 或 Claude Code。
  2. 打开 CC Switch。
  3. 允许它扫描或导入现有工具配置。
  4. 添加 77code AI provider。
  5. 启用 provider 后，重启终端或对应 CLI。

CC Switch 的配置数据默认存放在用户目录下的 .cc-switch 目录中，并会自动备份关键配置。

参考链接​