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

# CC-Switch 使用指南

> 用图形界面一键配置 Claude Code、Codex、Gemini CLI，无需手动编辑配置文件。

[CC-Switch](https://github.com/farion1231/cc-switch) 是一款开源的跨平台桌面应用，可以在图形界面中统一管理 Claude Code、Codex、Gemini CLI 的配置，并一键切换。

<Warning>
  CC-Switch 只负责管理配置，不会安装 CLI 工具本身。使用前请先安装对应工具：

  * [Claude Code 安装与配置](/claude-code/introduction)
  * [Codex 安装与配置](/codex/introduction)
  * [Gemini CLI 安装与配置](/gemini/introduction)
</Warning>

## 主要功能

<CardGroup cols={2}>
  <Card title="一键切换" icon="toggle-on">
    保存多套配置，点击即可切换
  </Card>

  <Card title="可视化管理" icon="sliders">
    在图形界面中填写请求地址和 Key，无需手动编辑文件
  </Card>

  <Card title="MCP 管理" icon="server">
    统一管理三款工具的 MCP 服务器
  </Card>

  <Card title="测速与故障转移" icon="gauge-high">
    测试请求地址延迟，自动切换到可用配置
  </Card>
</CardGroup>

## 下载安装

<Steps>
  <Step title="打开下载页面">
    访问 [CC-Switch Releases](https://github.com/farion1231/cc-switch/releases)，在最新版本的 **Assets** 中找到安装包。

    <Frame>
      <img src="https://mintcdn.com/dark-bf96e504/WbOz9QgQJZLZgWO6/images/cc-switch-download.png?fit=max&auto=format&n=WbOz9QgQJZLZgWO6&q=85&s=d193e2045b83bc22cc23d8592286e60b" alt="CC-Switch Releases 页面的安装包列表" style={{ width: "100%", maxWidth: "700px" }} width="2594" height="1726" data-path="images/cc-switch-download.png" />
    </Frame>
  </Step>

  <Step title="选择对应系统的安装包">
    * **Windows**：`.msi` 安装包，或免安装的 `Windows-Portable.zip`
    * **macOS**：`macOS.zip`，也可以通过 Homebrew 安装
    * **Linux**：`.deb`、`.rpm` 或 `.AppImage`
  </Step>

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

## 添加吉吉API

<Steps>
  <Step title="选择工具">
    在 CC-Switch 顶部选择要配置的工具：**Claude**、**Codex** 或 **Gemini**。
  </Step>

  <Step title="添加供应商">
    点击右上角的 **+** 按钮，按下方对应工具填写配置后保存。

    <Tabs>
      <Tab title="Claude Code">
        | 字段 | 填写内容 |
        | - | - |
        | 供应商名称 | 自定义，例如 `吉吉API` |
        | 官网链接 | `https://www.jiji.cc` |
        | API Key | 你的 API Key |
        | 请求地址 | `https://www.jiji.cc` |
        | API 格式 | `Anthropic Messages (原生)` |
      </Tab>

      <Tab title="Codex">
        | 字段 | 填写内容 |
        | - | - |
        | 供应商名称 | 自定义，例如 `吉吉API` |
        | 官网链接 | `https://www.jiji.cc` |
        | API Key | 你的 API Key |
        | API 请求地址 | `https://www.jiji.cc/v1` |
        | 模型名称 | `gpt-6.1-sol` |
      </Tab>

      <Tab title="Gemini">
        | 字段 | 填写内容 |
        | - | - |
        | 供应商名称 | 自定义，例如 `吉吉API` |
        | 官网链接 | `https://www.jiji.cc` |
        | API Key | 你的 API Key |
        | 请求地址 | `https://www.jiji.cc` |
        | 模型 | 可选，以 [模型广场](https://www.jiji.cc/extension/models) 为准 |
      </Tab>
    </Tabs>

    <Note>
      只有 Codex 的请求地址需要加 `/v1`，Claude Code 和 Gemini 不加。可用的模型 ID 以 [模型广场](https://www.jiji.cc/extension/models) 为准。
    </Note>
  </Step>

  <Step title="启用配置">
    在供应商列表中找到刚添加的「吉吉API」，点击 **启用**。CC-Switch 会自动写入对应工具的配置文件。
  </Step>
</Steps>

## 验证

**重新打开一个终端窗口**，运行对应工具，能正常回复即配置完成：

```bash theme={null}
claude "你好"
codex "你好"
gemini "你好"
```

<Tip>
  切换配置后，已经打开的 CLI 会话不会自动生效，需要退出后重新启动。
</Tip>

## 遇到问题

<CardGroup cols={3}>
  <Card title="Claude Code 常见问题" icon="circle-question" href="/claude-code/faq" />

  <Card title="Codex 常见问题" icon="circle-question" href="/codex/faq" />

  <Card title="Gemini CLI 常见问题" icon="circle-question" href="/gemini/faq" />
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.