CC Switch 配置文档

# 1.2 安装指南

## 前置要求

### 安装 Node.js

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

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

### 安装包方式

1. 访问 [Releases 页面](https://github.com/farion1231/cc-switch/releases)
2. 下载 `CC-Switch-v{版本号}-Windows.msi`
3. 双击运行安装程序
4. 按提示完成安装

### 绿色版（免安装）

1. 下载 `CC-Switch-v{版本号}-Windows-Portable.zip`
2. 解压到任意目录
3. 运行 `CC-Switch.exe`

## macOS

### 方式一：Homebrew（推荐）

```bash
# 添加 tap
brew tap farion1231/ccswitch

# 安装
brew install --cask cc-switch
```

更新到最新版本：

```bash
brew upgrade --cask cc-switch
```

### 方式二：手动下载

1. 下载 `CC-Switch-v{版本号}-macOS.zip`
2. 解压得到 `CC Switch.app`
3. 拖动到「应用程序」文件夹

### 首次打开提示

由于开发者没有 Apple 开发者账号，首次打开可能出现「未知开发者」警告：

**推荐解决方法**：
打开终端执行以下命令：
```bash
sudo xattr -dr com.apple.quarantine /Applications/CC\ Switch.app/
```

**备选解决方法（通过系统设置）**：
1. 关闭警告弹窗
2. 打开「系统设置」→「隐私与安全性」
3. 找到 CC Switch 相关提示，点击「仍要打开」
4. 再次打开应用即可正常使用

## Linux

### ArchLinux

使用 AUR 助手安装：

```bash
# 使用 paru
paru -S cc-switch-bin

# 或使用 yay
yay -S cc-switch-bin
```

### Debian / Ubuntu

1. 下载 `CC-Switch-v{版本号}-Linux.deb`
2. 安装：

```bash
sudo dpkg -i CC-Switch-v{版本号}-Linux.deb

# 如果有依赖问题
sudo apt-get install -f
```

### AppImage（通用）

1. 下载 `CC-Switch-v{版本号}-Linux.AppImage`
2. 添加执行权限：

```bash
chmod +x CC-Switch-v{版本号}-Linux.AppImage
```

3. 运行：

```bash
./CC-Switch-v{版本号}-Linux.AppImage
```

## 验证安装

安装完成后，启动 CC Switch：

1. 应用窗口正常显示
2. 系统托盘出现 CC Switch 图标
3. 能够切换 Claude / Codex / Gemini 三个应用

## 打开添加面板

点击主界面右上角的 **+** 按钮，打开添加供应商面板。

面板分为两个 Tab：
- **应用专属供应商**：仅用于当前选中的应用（Claude/Codex/Gemini/OpenCode/OpenClaw）
- **统一供应商**：跨应用共享的配置

## 使用自定义添加

预设是预先配置好的供应商模板，只需填写 API Key 即可使用。

### 操作步骤

1. 在「预设供应商」选择自定义配置
2. 名称填Chintao AI Hub，API请求地址（codex）为：https://www.chintao.cn/v1 
3. 填写你的 **API Key**
4. （可选）填写备注
5. 点击「添加」

### 备注

添加备注信息，如：

- 账号用途（个人/工作）
- 套餐信息
- 到期时间

备注会显示在供应商卡片上，也支持搜索。

### 端点测速

添加供应商后，可以对 API 端点进行速度测试：

1. 点击供应商卡片的「测速」按钮
2. 在测速面板中添加多个端点 URL
3. 点击「测速」执行测试
4. 选择延迟最低的端点

**测速结果**：
- 🟢 绿色：延迟 < 500ms（优秀）
- 🟡 黄色：延迟 500-1000ms（一般）
- 🔴 红色：延迟 > 1000ms（较慢）

## 卸载

### Windows

- 通过「设置 → 应用」卸载
- 或运行安装目录下的卸载程序

### macOS

- 将 `CC Switch.app` 移到废纸篓
- 可选：删除配置目录 `~/.cc-switch/`

### Linux

```bash
# Debian/Ubuntu
sudo apt remove cc-switch

# ArchLinux
paru -R cc-switch-bin
```