> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rayinai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CC-Switch 使用

> CC-Switch 配置工具使用指南

## 什么是 CC-Switch

CC-Switch 是一款跨平台桌面应用，统一管理 Claude Code、Codex 和 Gemini CLI 三大 AI 编程工具

<Warning>
  **使用前提**：CC-Switch 仅管理 CLI 工具的配置，不负责安装 CLI 本身。使用前请确保已安装对应的 CLI 工具：

  * [Claude Code 安装教程](/claude-code/introduction)
  * [Codex 安装教程](/codex/introduction)
  * [Gemini 安装教程](/gemini/introduction)
</Warning>

## 核心功能

<CardGroup cols={2}>
  <Card title="一键切换配置" icon="toggle-on">
    快速切换不同 API 供应商配置
  </Card>

  <Card title="可视化管理" icon="chart-simple">
    图形界面管理所有配置，无需手动编辑文件
  </Card>

  <Card title="MCP 服务器" icon="server">
    集成 MCP 服务器管理功能
  </Card>

  <Card title="系统托盘" icon="window-minimize">
    常驻系统托盘，快捷操作
  </Card>

  <Card title="本地代理" icon="network-wired">
    支持本地代理配置
  </Card>

  <Card title="故障转移" icon="rotate">
    自动检测并切换到可用配置
  </Card>
</CardGroup>

## 软件下载

<Steps>
  <Step title="访问下载页面">
    访问 [CC-Switch Release](https://github.com/farion1231/cc-switch/releases) 下载最新版本

    <img src="https://mintcdn.com/zller/B4dE7O3I3qDrpqQ7/images/cc-switch-download.png?fit=max&auto=format&n=B4dE7O3I3qDrpqQ7&q=85&s=8d106f7ec6195d37947a5a4013d995b8" alt="下载页面" style={{maxWidth: '800px'}} width="2594" height="1726" data-path="images/cc-switch-download.png" />
  </Step>

  <Step title="选择对应系统版本">
    * **Windows**：下载 `.msi` 安装包
    * **macOS**：下载 `.dmg` 安装包或使用 Homebrew 安装
    * **Linux**：下载 `.deb`、`.AppImage` 或使用 AUR 安装
  </Step>

  <Step title="安装并启动">
    按照系统提示完成安装，启动 CC-Switch 应用
  </Step>
</Steps>

## 配置步骤

### 步骤一：选择 CLI 工具

打开 CC-Switch，选择要配置的供应商，点击 + 按钮

<img src="https://mintcdn.com/zller/mTdaLLPrh4ivaEUL/images/cc-switch-home.png?fit=max&auto=format&n=mTdaLLPrh4ivaEUL&q=85&s=c4c1af06dc940512456eb965829e59f0" alt="添加供应商" style={{ maxWidth: "600px" }} width="1800" height="1200" data-path="images/cc-switch-home.png" />

### 步骤二：添加配置

<Tabs>
  <Tab title="Claude Code">
    <img src="https://mintcdn.com/zller/B4dE7O3I3qDrpqQ7/images/cc-switch-claude.png?fit=max&auto=format&n=B4dE7O3I3qDrpqQ7&q=85&s=6971b5cfab763a2eab7a2a83b1028a48" alt="Claude Code 配置" style={{ maxWidth: "600px" }} width="1828" height="1036" data-path="images/cc-switch-claude.png" />

    填写以下配置信息：

    * **供应商名称**：自定义名称，例如 `RayinCode`
    * **备注**：可选，用于标识用途，例如 `公司专用账号`
    * **官网链接**：`https://code.rayinai.com`
    * **API Key**：从控制台生成的密钥（[如何生成](/quickstart/api-key)）
    * **请求地址**：`https://code.rayinai.com`
    * **API 格式**：默认选择 `Anthropic Messages (原生)`
  </Tab>

  <Tab title="Codex">
    <img src="https://mintcdn.com/zller/B4dE7O3I3qDrpqQ7/images/cc-switch-codex.png?fit=max&auto=format&n=B4dE7O3I3qDrpqQ7&q=85&s=5be114e2f1f2e9f3780116c3b87331d7" alt="Codex 配置" style={{ maxWidth: "600px" }} width="1820" height="1054" data-path="images/cc-switch-codex.png" />

    填写以下配置信息：

    * **供应商名称**：自定义名称，例如 `RayinCode`
    * **备注**：可选，用于标识用途，例如 `公司专用账号`
    * **官网链接**：`https://code.rayinai.com`
    * **API Key**：从控制台生成的密钥（[如何生成](/quickstart/api-key)）
    * **API 请求地址**：`https://code.rayinai.com/v1`
    * **模型名称**：`gpt-5.3-codex`
  </Tab>

  <Tab title="Gemini">
    <img src="https://mintcdn.com/zller/B4dE7O3I3qDrpqQ7/images/cc-switch-gemini.png?fit=max&auto=format&n=B4dE7O3I3qDrpqQ7&q=85&s=a42b45bdd8f43d75aea58ede70551221" alt="Gemini 配置" style={{ maxWidth: "600px" }} width="1818" height="874" data-path="images/cc-switch-gemini.png" />

    填写以下配置信息：

    * **供应商名称**：自定义名称，例如 `RayinCode`
    * **备注**：可选，用于标识用途，例如 `公司专用账号`
    * **官网链接**：`https://code.rayinai.com`
    * **API Key**：从控制台生成的密钥（[如何生成](/quickstart/api-key)）
    * **请求地址**：`https://code.rayinai.com`
    * **模型**：`gemini-3-pro-preview`
  </Tab>
</Tabs>

### 步骤三：验证配置

打开终端，运行以下命令测试：

```bash theme={null}
# Claude Code
claude "hello"

# Codex
codex "hello"

# Gemini
gemini "hello"
```