​
1. 按系统安装编辑器与 Codex 扩展

先从 VS Code 下载页选择本机版本。以下以 VS Code 为例；官方 IDE 指南也列出了 Cursor 和 Windsurf 的扩展安装入口。
安装 macOS 版 VS Code，从「应用程序」打开。按 Cmd+Shift+X 打开扩展市场。
三个系统都搜索并安装 OpenAI 发布的 Codex（扩展 ID：openai.chatgpt），然后点击 Codex 图标。找不到时，在命令面板运行 Codex: Open Codex Sidebar；macOS 按 Cmd+Shift+P，Windows / Linux 按 Ctrl+Shift+P 打开命令面板。

​
2. 填写 ABCRelay 地址与模型

优先在 Codex 侧栏点击齿轮 → Codex Settings → Open config.toml，确认打开的是用户级配置。若任一配置文件不存在，请在上方对应路径新建并保持文件名不变： 下面是固定默认用户目录；自定义目录见 FAQ。
默认完整路径（可粘贴到编辑器的「打开」窗口；macOS 也可用 Finder → 前往 → 前往文件夹）：
修改前先备份已有用户配置。 更改凭据前，完全退出运行中的 Codex CLI、App 和 IDE，它们可能共用同一套文件。 三个系统共用下面四行配置。 放在文件顶层、首个 [表名] 之前；已有字段直接修改，保存为原名 config.toml。将 YOUR_MODEL_ID 换成当前 Key 可用、支持 Responses 的模型 ID。
地址要带 /v1： 本页内置 openai provider 的 openai_base_url 填 https://www.abcrelay.com/v1，最终请求为 https://www.abcrelay.com/v1/responses。不要填根地址，也不要再追加 /responses；三个系统相同。

​
3. 将 Key 保存到 auth.json，再验证

打开下面的凭据文件。确认要切换为 ABCRelay API Key 鉴权后，将文件内容改为下面这份 JSON；不要混留旧 ChatGPT 的 tokens 或其他 auth_mode。 切换凭据也可能影响其他 Codex 客户端。
完整路径：
将 YOUR_ABCRELAY_API_KEY 换成你的 ABCRelay Key，保存为纯文本 auth.json，不要变成 auth.json.txt：
重新打开编辑器，打开本地项目并新建 Codex 聊天，发送「只回复 OK」，到 ABCRelay 控制台核对同一 Key、模型的调用记录。Key 已保存在固定文件中，不依赖编辑器从哪个终端启动；若扩展仍要求登录，见下方 FAQ。

​
常见问题与详细说明

它们追加的接口路径不同：Codex 追加 /responses，Claude Code 追加 /v1/messages，所以基础地址不能互相照抄。此规则取决于客户端的配置字段和模式，与系统或模型品牌无关。其他客户端见API 地址对照表。
这是编辑器里的 OpenAI Codex 扩展，配置影响 Codex 自己的请求。Cursor 自带聊天、Agent、Tab 等功能有自己的配置和服务边界，详见 Cursor 接入。Windsurf 中安装的 Codex 扩展也是独立入口；本页不代表已经替换其内置 Cascade 等服务。官方还列出 Xcode 和 JetBrains 的集成方式，它们的界面不同，本页不套用到这些内置集成。
先确认扩展读取的用户目录与上面两个文件一致，且 cli_auth_credentials_store = "file" 位于 TOML 顶层。备份原凭据后，完全退出编辑器，再修改 ~/.codex/auth.json（Windows：%USERPROFILE%\.codex\auth.json）；保留 API Key JSON，不混留旧 ChatGPT tokens 或其他 auth_mode，然后重开编辑器。若当前版本仍需交互登录，在未登录界面选 Use API Key，输入 ABCRelay Key，点 OK。选择文件存储后，这也会保存为持久凭据；之后退出登录会清除凭据，并可能影响 CLI。管理员可能限制鉴权方式，见官方鉴权指南。
设置面板可能打开当前配置层，必须确认正在修改用户级文件。provider 与 openai_base_url 不能靠相对于项目根目录的 ./.codex/config.toml 覆盖。设置过 CODEX_HOME 时使用该目录。保持四项在 TOML 顶层，不重复字段，也不要定义 [model_providers.openai]。这里通过内置 openai provider 的地址选项连接 ABCRelay。若之前选择了 abcrelay 自定义 provider，请改为本页的 openai，并保存第 3 步的持久凭据文件；单改 openai_base_url 不会改变另一个 provider。保存后重载并开启新聊天。
先确认 Codex 扩展实际运行在哪个环境，再在该环境中设置用户配置和凭据。本机、WSL、远程服务器、容器的用户目录可能不同；只改本机文件不一定影响远程扩展。Windows 的扩展设置 chatgpt.runCodexInWindowsSubsystemForLinux 可选择 WSL 运行方式。它属于编辑器设置，不是 config.toml 字段。详见官方扩展设置。
本页接入本地 Codex 请求。ABCRelay Key 需要有可用额度和模型权限，不能替代 ChatGPT 订阅。仅支持 Chat Completions 的模型不能作为这里的 Responses 模型使用。官方要求 Codex 云端使用 ChatGPT 登录，因此本地接通不能证明云端任务也经由 ABCRelay。编程、流式和工具能力仍需按实际模型验证，更多准备见接入前准备。
检查 Key 状态、分组与模型权限，以及地址是否为 https://www.abcrelay.com/v1。不要追加 /responses。使用 ABCRelay 调用记录确认请求来源和模型。聊天正常但工具失败时，继续检查模型和渠道的工具兼容性。配置通过并不意味着所有编辑器功能都兼容。详见接入排错。
Windows 可以原生运行 Codex，推荐 Windows 11；完整更新的近期 Windows 10 属于尽力支持范围。需要 Linux 工具链或项目本就在 WSL 中时，再使用 WSL2。在 VS Code 的 WSL 远程窗口内安装或启用 Codex，并确认扩展实际运行位置；WSL 用户配置位于 Linux 的 ~/.codex/config.toml，不是 Windows 用户目录。WSL1 已不支持。详见官方 WSL 指南。
快速步骤使用固定的默认用户目录。若自行设置过 CODEX_HOME，把两个文件都放到该目录：macOS / Linux shell 为 $CODEX_HOME/config.toml 与 $CODEX_HOME/auth.json，PowerShell 为 $env:CODEX_HOME\config.toml 与 $env:CODEX_HOME\auth.json。App 或扩展必须使用同一个目录；只在终端设置的目录不一定会传给图形客户端。凭据备份与原文件同目录，例如 ~/.codex/auth.json.backup-20260910-120000，或 %USERPROFILE%\.codex\auth.json.backup-20260910-120000；备份同样含凭据，不要分享或提交。要恢复先前账号，先退出所有 Codex 客户端，再将选定备份恢复为同目录的 auth.json。
核对日期：2026-09-10。已按官方资料核对扩展设置、鉴权和地址配置；未使用真实 ABCRelay Key 做 IDE 端到端测试。