首次配置 Codex 完整实操教程（小白从零到可用）

#📌 7 步配置流程总览

1. 创建 Key：在 SuperFast 控制台创建并复制专属 API 密钥
2. 下载 CC Switch：安装客户端配置切换中枢，并开启统一会话历史
3. 下载 Codex 桌面端：安装官方原版或大陆高速直连包
4. 导入 SuperFast 配置：填入 Base URL、API Key 与 Responses 格式
5. 启用并完全重启 Codex：在 CC Switch 中启用并彻底关闭重启客户端
6. 发送 hi 测试连通性：新建对话发消息，验证模型正常流式回复
7. 查看控制台使用记录：在「工作空间 → 使用记录」确认请求到账，完成配置闭环

#第 1 步：创建并复制 SuperFast API Key

首先，你需要一把用于访问大模型服务的“钥匙”（API Key）：

1. 打开浏览器，登录 SuperFast 控制台：https://api.20020723.xyz/
2. 在左侧菜单栏中，点击 「工作空间」→「API 密钥」。
3. 点击页面右上角的 「创建密钥」（或「添加令牌」）。
4. 在弹出的窗口中设置参数：

• 名称：随意填写，例如 codex-desktop（方便自己识别）。
• 分组：选择您需要使用的模型对应的分组（可随时在 官方模型广场 查看各分组所包含的模型与费率折扣）。
• 额度：保持默认或留空（不设单独上限，直接使用账户可用余额）。

1. 点击 「确认创建」。在密钥列表中找到刚创建的条目，点击 复制 完整的 sk-... 密钥字符串。

#第 2 步：下载并打开 CC Switch（配置切换中枢）

CC Switch 是一款免费开源的 AI 客户端中枢管理工具，专门用来帮助 Codex、Claude Code 等本地工具一键切换供应商和注入 API Key，省去了手动编辑复杂系统配置文件的麻烦。

#1. 下载 CC Switch 最新版

• 官方 GitHub Releases 下载：CC-Switch 发布页
• 备用高速直链（推荐国内网络直接点击）：
• Windows 安装包：CC-Switch-Windows.msi
• macOS 安装包：CC-Switch-macOS.dmg
• 下载完成后双击安装，然后打开 CC Switch。

#2. 打开「统一 Codex 会话历史」开关（⚠️ 最容易漏的一步）

此开关建议开启，能确保切到 SuperFast 之后，以前和以后的全部对话历史都能完整保留在本地：

1. 在 CC Switch 中，点击左下角的 「设置」（齿轮图标）→ 进入 「通用」。
2. 找到 「Codex 应用增强」 区域。
3. 打开 「统一 Codex 会话历史」 开关。
4. 弹窗中勾选 「同时迁入现有官方会话历史」，然后点击 「我已了解，继续开启」。

#第 3 步：下载并安装 Codex（多渠道直连指南）

平时使用 Windows 或 macOS 的，推荐直接装桌面端；Linux 用户可使用 Codex CLI 命令行；习惯在常用编辑器中写代码的用户，也可直接安装 VS Code / Cursor / Trae 官方扩展。

如果你之前安装过旧版本，直接重新安装一次覆盖更新即可。

#选择适合你的安装方式

#渠道一：Codex / ChatGPT 桌面端（Windows / macOS 用户首选）

• 官方下载渠道：打开 ChatGPT 官方下载页，页面会自动匹配识别你的电脑操作系统，点击下载安装即可。Codex 就内置在装好的 ChatGPT 桌面端中，打开后切换至 Codex 即可开始使用。
• 提示：官方下载页需要在能正常访问 OpenAI 的网络环境下打开。如果在中国大陆网络下打不开，请直接使用下方的「大陆免翻直连下载」方案。

#渠道二：大陆免翻直连极速下载（官方页打不开时用，自动匹配最新版）

以下直链来自开源社区镜像项目 codex-app-mirror，原样搬运官方原版安装包，与官方版本逐字节完全一致（支持通过 官方校验清单 比对 SHA256 哈希值）：

• 🪟 Windows 用户：
• 直接下载 Windows 版 (x64)：下载得到 .Msix 格式文件，直接双击运行即可安装；Surface 等 ARM 设备请使用 Windows ARM64 版。
• 微软商店直装：Windows 用户也能直接在微软商店中搜索 ChatGPT（发布者 OpenAI） 一键安装。
• 备用高速网盘镜像：如果网络不稳定，可使用站长准备的 夸克网盘备用链接（提取口令：~99603ZIKdE~:/）。
• 若双击无法安装，可在文件所在目录右键打开 PowerShell 执行：

Add-AppxPackage -Path ".\OpenAI.Codex_x64.Msix"

• 🍎 macOS 用户：
• 直接下载 Mac 版（Apple 芯片）：2020 年底以后的 Mac 基本均为 Apple 芯片（M1 / M2 / M3 / M4 系列）。
• 直接下载 Mac 版（Intel 芯片）：早期 Intel 处理器 Mac 请选此项（不确定可在屏幕左上角点击  苹果菜单 →「关于本机」查看）。
• 如需下载历史版本，可访问 GitHub Releases 页面。

#渠道三：Codex CLI 命令行工具（主要推荐 Linux / 极客终端用户）

• 官方快速安装脚本（需能访问 OpenAI 网络）：
• macOS / Linux 终端：

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version

• Windows PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex --version

• 国内免代理极速安装（推荐大陆网络）：

先安装 Node.js 运行环境，再通过国内阿里 npmmirror 镜像源一键全局安装，安装包与官方源逐字节一致：

npm install -g @openai/codex --registry=https://registry.npmmirror.com
codex --version

#渠道四：VS Code / Cursor / Trae 编辑器扩展（可选常用入口）

• 习惯在日常 IDE 编程环境中使用 Codex 的同学，可直接在编辑器扩展市场中搜索并安装 OpenAI Codex 扩展。
• 该扩展在大陆网络通常可直接访问与更新，且会自动读取同一份本机 Codex 配置。

#打开 Codex 确认登录状态

安装完成后打开 Codex，根据你自身情况挑选一种登录方式：

• 方式 A：有 ChatGPT / OpenAI 账号

按照界面提示直接登录原账号。完全不影响后续走 SuperFast 通道，也不需要该账号拥有任何官方付费额度，免费账号完全通用！

• 方式 B：没有账号

选择使用 API Key 登录，直接粘贴第 1 步在 SuperFast 创建的专属 Key（注意不要加多余引号或 Bearer 前缀）。

#第 4 步：在 CC Switch 中导入 SuperFast 配置

现在把刚刚准备好的 SuperFast API 配置与 Key 导入到 CC Switch：

1. 打开 CC Switch，在顶部导航栏选择 「Codex」。
2. 点击右上角橙色的 +（添加） 按钮。
3. 在弹出的菜单中选择 「自定义配置」。
4. 严格按照下表填写各项参数：

1. 确认无误后，点击右下角 「保存」。

#第 5 步：在 CC Switch 启用 SuperFast 并完全退出重启 Codex

1. 在 CC Switch 顶部选 Codex，在供应商列表里找到刚保存的 SuperFast 卡片，点击卡片上的 「启用」 按钮（卡片右侧会显示绿色激活状态）。
2. 重点中的重点：怎样才算完全退出 Codex？

仅仅点击窗口右上角的关闭按钮「X」或左上角红点，并不会真正退出 Codex，程序依然在系统后台运行，配置不会生效！必须进行彻底退出：

• macOS 用户：在 Codex 窗口按键盘快捷键 ⌘ + Q，或在屏幕左上角状态栏点击菜单选择「退出」（Quit）。
• Windows 用户：必须点击桌面右下角任务栏的 ^（展开隐藏图标），找到 Codex 图标，鼠标右键点击并选择「退出」。

1. 彻底退出后，重新在桌面或应用程序列表里打开 Codex。

#第 6 步：重启 Codex 并发送 hi 测试连通

1. 重新打开 Codex 后，如果界面依然显示原有的账号邮箱，甚至顶部提示“无可用额度 / 超出使用限制”——完全不用理会，也不需要退出登录原账号！这只是前端界面的静态显示，实际网络请求已经被 CC Switch 重定向到了 SuperFast 高速通道。
2. 新建一个对话（New Chat）。
3. 在底部输入框中输入：

 hi

1. 按回车键发送，观察回复：

• 如果 Codex 立即开始流式输出打字回复：恭喜你，本地客户端到 SuperFast 专线已成功打通！
• 如果提示“重新连接”：多半是本地网络或代理波动，检查是否开了 TUN 模式，重试一次即可。

#第 7 步：在 SuperFast 控制台查看「使用记录」，完成闭环验证

为了 100% 确认请求确实走了 SuperFast 平台，我们进行最后一步闭环核验：

1. 打开浏览器，进入 SuperFast 控制台：https://api.20020723.xyz/
2. 在左侧菜单栏的 「工作空间」 栏目下，点击 「使用记录」（就在「API 密钥」正下方）。
3. 刷新使用记录列表：

• 如果你能看到刚才发送 hi 的最新一条请求记录（显示调用时间、模型名称、消耗 Token 与状态 200）：
• 🎉 配置 100% 成功！ 此时你的 Codex 已经与 SuperFast 服务完美融为一体，无论是复杂的多文件代码重构、全栈开发还是全自主 Debug，都能尽情体验极致流畅的高并发 AI 编程！

#🛠️ 新手常见问题与故障排查清单（FAQ）

#Q1: 发送消息时提示 404 Not Found 怎么办？

• 原因：在 CC Switch 的「API 请求地址」一栏中错误地加上了 /v1。
• 解决办法：回到 CC Switch，编辑 SuperFast 配置，将地址修正为 https://api.20020723.xyz（确保末尾没有多余的斜杠或 /v1），保存后重新彻底退出并重启 Codex。

#Q2: 发送消息提示 401 Unauthorized 怎么办？

• 原因：API Key 复制错误或带有前后空格。
• 解决办法：前往控制台「工作空间 → API 密钥」重新复制 sk-... 密钥，粘贴到 CC Switch 时确认前后无空格无引号。

#Q3: 为什么发了消息，控制台的「使用记录」里没有新记录？

• 原因 1：CC Switch 里没有真正点击「启用」SuperFast。
• 原因 2：Codex 没有彻底退出重启，依然在运行旧的连接实例。请务必使用 ⌘+Q（Mac）或右下角任务栏托盘右键退出（Windows）完全退出后再重新打开。

#Q4: 切换到 SuperFast 后，之前在 Codex 里的历史对话不见了？

• 解决办法：不用担心，对话没有丢失。打开 CC Switch，进「设置」→「通用」→「Codex 应用增强」，确保勾选了 「统一 Codex 会话历史」 与 「同时迁入现有官方会话历史」，然后完全退出并重启 Codex，以前的对话就会全部恢复显示。