CC Switch == 安装指南

目录

[安装 Node.js](#安装 Node.js)

Windows

macOS

Linux

[安装 CLI 工具](#安装 CLI 工具)

[Claude Code](#Claude Code)

Codex

[Gemini CLI](#Gemini CLI)

Windows

安装程序

便携版（无需安装）

macOS

[选项 1：自制（推荐）](#选项 1：自制（推荐）)

[选项 2：手动下载](#选项 2：手动下载)

已签名并经公证

Linux

ArchLinux

[Debian / Ubuntu](#Debian / Ubuntu)

AppImage（通用）

验证安装

自动更新

卸载

Windows

macOS

Linux

---

安装 Node.js

CC Switch 管理的 CLI 工具（Claude Code、Codex、Gemini CLI）需要 Node.js 环境。

推荐版本：Node.js 18 LTS 或更高版本

Windows

1. 访问Node.js 官方网站

2. 下载 LTS 版本安装程序

3. 运行安装程序并按照提示操作。

4. 验证安装：

   node --version
   npm --version

macOS

# Install with Homebrew
brew install node

# Or use nvm (recommended)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts

Linux

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Or use nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install --lts

安装 CLI 工具

Claude Code

选项 1：Homebrew（推荐用于 macOS）

brew install claude-code

选项 2：npm

npm install -g @anthropic-ai/claude-code

Codex

选项 1：Homebrew（推荐用于 macOS）

brew install codex

选项 2：npm

npm install -g @openai/codex

Gemini CLI

选项 1：Homebrew（推荐用于 macOS）

brew install gemini-cli

选项 2：npm

npm install -g @google/gemini-cli

Windows

安装程序

1. 访问发布页面
2. 下载CC-Switch-v{version}-Windows.msi
3. 双击运行安装程序
4. 按照提示完成安装

便携版（无需安装）

1. 下载CC-Switch-v{version}-Windows-Portable.zip
2. 解压到任意目录
3. 跑步CC-Switch.exe

macOS

选项 1：自制（推荐）

# Add tap
brew tap farion1231/ccswitch

# Install
brew install --cask cc-switch

更新至最新版本：

brew upgrade --cask cc-switch

选项 2：手动下载

1. 下载CC-Switch-v{version}-macOS.zip
2. 提取得到CC Switch.app
3. 将其拖到"应用程序"文件夹

已签名并经公证

macOS 版 CC Switch 已由 Apple 签名并公证。您可以直接安装并打开它，无需任何额外步骤。

Linux

ArchLinux

使用 AUR 助手进行安装：

# Using paru
paru -S cc-switch-bin

# Or using yay
yay -S cc-switch-bin

Debian / Ubuntu

1. 下载CC-Switch-v{version}-Linux.deb

2. 安装：

   sudo dpkg -i CC-Switch-v{version}-Linux.deb

   If there are dependency issues

   sudo apt-get install -f

AppImage（通用）

1. 下载CC-Switch-v{version}-Linux.AppImage

2. 添加执行权限：

3. Run

   chmod +x CC-Switch-v{version}-Linux.AppImage
   ./CC-Switch-v{version}-Linux.AppImage

验证安装

安装完成后，启动 CC Switch：

1. 应用程序窗口显示正常。
2. 系统托盘中会出现一个 CC 开关图标。
3. 您可以在 Claude / Codex / Gemini 应用之间切换。

自动更新

CC Switch 包含内置自动更新功能：

• 启动时自动检查更新
• 当有新版本可用时，在用户界面中显示更新提示。
• 点击下载并安装

您也可以在"设置 > 关于"中手动检查更新。

卸载

Windows

• 通过"设置 > 应用"卸载
• 或者在安装目录中运行卸载程序。

macOS

• 移至CC Switch.app垃圾桶
• （可选）删除配置目录~/.cc-switch/

Linux

​
# Debian/Ubuntu
sudo apt remove cc-switch

# ArchLinux
paru -R cc-switch-bin
​