六哥API 接入 Codex Desktop 教程

本教程引导你下载安装 Codex Desktop 与 CC-Switch，将「六哥API」中转站接入 Codex Desktop，在国内网络直连使用 AI 模型。

目录

• 1. 下载安装 Codex Desktop
• 2. 下载安装 CC-Switch
• 3. 注册六哥API并获取 API Key
• 4. 在 CC-Switch 中配置六哥API
• 5. 启动并测试
• 6. 常见问题

1. 下载安装 Codex Desktop

1.1 下载 Codex Desktop

打开浏览器，访问 Codex Desktop 官方下载页面：

复制codehttps://chatgpt.com/zh-Hans-CN/codex/

在页面中选择适合你操作系统的版本进行下载。

支持平台：Windows / macOS / Linux

1.2 安装 Codex Desktop

• Windows：双击下载的 .exe 安装包，按向导完成安装。
• macOS：双击 .dmg 文件，将 Codex Desktop 拖入 Applications 文件夹。
• Linux：根据下载的格式使用对应安装方式（.AppImage / .deb / .rpm）。

安装完成后，先不要启动 Codex Desktop，接下来配置 CC-Switch。

2. 下载安装 CC-Switch

2.1 访问下载页面

打开浏览器，访问：

复制codehttps://github.com/farion1231/cc-switch/releases/tag/v3.15.0

2.2 选择对应版本

根据你的操作系统选择对应文件下载：

2.3 安装与启动

• Windows 便携版：解压 ZIP 文件，双击 CC-Switch.exe 启动。
• macOS：双击 .dmg，将 CC-Switch 拖入 Applications 后打开。
• Linux：给 .AppImage 添加执行权限后运行。

启动成功后，你将看到 CC-Switch 的主界面。界面顶部有一排图标按钮。

3. 注册六哥API并获取 API Key

3.1 注册账号

打开浏览器，访问：

复制codehttps://i.crisxie.top

点击页面上的「注册」按钮，填写信息完成注册。

3.2 获取 API Key

注册并登录后，前往 Token 管理页面：

复制codehttps://i.crisxie.top/console/token

在页面中创建一个新的 API Key，并将其复制保存好，后续配置需要使用。

4. 在 CC-Switch 中配置六哥API

4.1 进入 OpenAI 供应商配置

在 CC-Switch 主界面顶部图标栏中，点击 OpenAI 图标的按钮，进入 OpenAI 兼容供应商管理页面。

4.2 添加新供应商

点击页面右上角的「+」加号按钮，添加一个新的供应商配置。

4.3 填写供应商信息

在弹出的表单中填写以下内容：

说明：请求地址使用 OpenAI 兼容格式（/v1），因此需要在 OpenAI 图标对应的供应商页面中进行配置。

填写完成后，点击「保存」按钮。

4.4 启动六哥API

保存后返回 CC-Switch 主页面，在供应商列表中找到「六哥API」，点击其右侧的「启动」按钮。

启动成功后，六哥API 旁边的状态指示灯会变为绿色，表示代理已就绪。

5. 启动并测试

5.1 启动 Codex Desktop

CC-Switch 启动并显示六哥API 为绿色状态后，打开之前安装好的 Codex Desktop。

CC-Switch 会自动接管本地代理，Codex Desktop 无需额外配置即可通过 CC-Switch 使用六哥API。

5.2 发送测试消息

在 Codex Desktop 中输入一条测试消息，例如：

"你好，请确认我们之间的连接正常工作。"

如果收到正常回复，说明 Codex Desktop → CC-Switch → 六哥API 整条链路已打通。

6. 常见问题

Q1：CC-Switch 中六哥API 状态灯不亮

排查步骤：

1. 确认 API Key 填写正确（无多余空格、未过期）
2. 确认请求地址填写为 i.crisxie.top/v1
3. 确认网络能正常访问 i.crisxie.top
4. 重启 CC-Switch 后再试

Q2：Codex Desktop 连接无响应

排查步骤：

1. 确认 CC-Switch 已启动且六哥API 状态为绿色
2. 确认 Codex Desktop 是在 CC-Switch 启动之后打开的
3. 尝试关闭 Codex Desktop，确认 CC-Switch 运行正常后重新打开

Q3：API Key 从哪里获取

访问 https://i.crisxie.top 注册账号，然后前往 https://i.crisxie.top/console/token 创建 API Key。

Q4：支持哪些模型

六哥API 中转站支持多种主流模型。在 CC-Switch 配置中填写你需要使用的模型名称即可（如 gpt-5.5），只要端点支持都能调用。如需使用其他模型，可在 CC-Switch 中修改模型字段。

附录：整体架构

复制code┌──────────────────┐                     ┌──────────────┐     远程转发       ┌──────────────┐
│                  │                     │              │  ◄──────────────►  │              │
│  Codex Desktop   │  ──── 直连 ────►   │  CC-Switch   │   API 调用        │  六哥API后端  │
│                  │                     │  (本地代理)    │  OpenAI兼容格式   │  i.crisxie.top│
└──────────────────┘                     └──────────────┘                    └──────────────┘

Codex Desktop 直接连接本地 CC-Switch，CC-Switch 将请求以 OpenAI 兼容格式转发到六哥API后端。国内网络直连，全程无需代理。

获取帮助：如遇到文档未覆盖的问题，请联系六哥API管理员。

文档版本：v1.0 | 适用 CC-Switch v3.15.0 | 最后更新：2026-05-17