​
1. 按系统安装 Codex CLI

打开「终端」，在 zsh / Bash 中运行官方安装命令：
安装后重新打开终端，运行 codex --version 确认成功。官方安装说明也提供 npm 和 Homebrew 方式。

​
2. 填写地址与模型

按系统打开下面的用户配置文件。若任一配置文件不存在，请在上方对应路径新建并保持文件名不变；自定义目录见 FAQ。
默认完整路径（可粘贴到编辑器的「打开」窗口；macOS 也可用 Finder → 前往 → 前往文件夹）：
修改前先备份已有用户配置。 更改凭据前，完全退出运行中的 Codex CLI、App 和 IDE，它们可能共用同一套文件。 三个系统共用下面一份 TOML 配置。 将 YOUR_MODEL_ID 换成当前 Key 可用、支持 Responses 的模型 ID。已有字段请直接修改，不要整段追加；前三行放在首个 [表名] 之前，保存为原名 config.toml。
从旧配置迁移： 删除 [model_providers.abcrelay] 中的 env_key，不要只追加 requires_openai_auth；残留的 env_key 可能让 Codex 继续读取旧环境变量中的 Key。 地址要带 /v1： model_providers.abcrelay.base_url 填 https://www.abcrelay.com/v1。Codex 追加 /responses，最终请求为 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：
关闭终端再新开一个终端，运行：
状态应显示使用 API Key 登录。发送「只回复 OK」，再到 ABCRelay 控制台核对同一 Key、模型的调用记录。文件保存后，重开终端无需重新设置 Key；仅有登录状态不代表模型请求已经成功。

​
常见问题与详细说明

它们追加的接口路径不同：Codex 追加 /responses，Claude Code 追加 /v1/messages，所以基础地址不能互相照抄。此规则取决于客户端的配置字段和模式，与系统或模型品牌无关。其他客户端见API 地址对照表。
先完成接入前准备。Key 必须启用、额度可用，模型必须对该 Key 开放并支持 Responses。编程功能还需要流式与工具调用能力，不能只凭模型名称判断兼容性。YOUR_MODEL_ID 和 YOUR_ABCRELAY_API_KEY 都是占位符。基础请求成功后，可在测试项目中发送「读取 README 并用三句话说明项目用途，不要修改文件」，继续检查文件工具能力。真实请求会消耗额度。
使用第 2 步的完整路径。自定义 CODEX_HOME 后，macOS / Linux shell 中的路径为 $CODEX_HOME/config.toml，PowerShell 为 $env:CODEX_HOME\config.toml。修改前备份已有配置。model、model_provider、cli_auth_credentials_store 位于 TOML 顶层；已有同名字段或 [model_providers.abcrelay] 表时修改原内容，不重复定义。provider 和鉴权设置应写入用户级配置，相对于项目根目录的 ./.codex/config.toml 不能覆盖这些字段。base_url 写到 /v1，不追加 /responses；requires_openai_auth = true 让这个 provider 读取登录凭据，cli_auth_credentials_store = "file" 固定读取用户目录中的凭据文件。
核对两个用户文件：macOS / Linux 为 ~/.codex/config.toml 与 ~/.codex/auth.json；Windows 资源管理器为 %USERPROFILE%\.codex\config.toml 与 %USERPROFILE%\.codex\auth.json。JSON 必须用双引号，文件不能带隐藏的 .txt 后缀；OPENAI_API_KEY 是固定 JSON 字段名，值填 ABCRelay Key。确认 cli_auth_credentials_store = "file" 位于 TOML 顶层，requires_openai_auth = true 位于 [model_providers.abcrelay] 内。从旧教程迁移时删除该 provider 的 env_key。保存后不要再运行 codex logout，它会清除已保存的鉴权。本页默认使用固定用户目录。若自己设置过 CODEX_HOME，将两个文件放到同一个自定义目录，并确保每次启动都使用它。WSL 使用 Linux 用户目录，与 Windows 分开。
本页已统一为 config.toml + auth.json 持久化文件方案。一次性终端变量不会自动保留到下一个终端，桌面程序也不一定继承它。设置 requires_openai_auth = true 的同时必须删除旧 env_key。本次 CLI 实测中，两项混留仍可能发送环境变量里的 Key，而不是凭据文件中的 Key。凭据文件和备份都含 Key，只保存在个人用户目录，不要放入项目或提交 Git。切换鉴权前完全退出 Codex；备份原 ChatGPT 登录后，仅保留上面的 API Key JSON，不混入旧 tokens。需要恢复原登录时，先退出 Codex，再恢复备份文件。
在 Codex 中运行 /status 查看当前会话，使用 /debug-config 检查配置来源；核对启动参数、所选 profile 和用户配置是否覆盖了预期选择。修改配置后重启并新建会话。不要用另一个 provider 的成功请求作为 ABCRelay 接入依据，应核对 ABCRelay 控制台的实际调用记录。
401 / 403：检查 Key 状态、有效期、分组权限、IP 限制和返回的具体错误。404：检查 /v1 是否缺失或重复，以及模型是否提供 Responses。聊天成功但工具失败时，检查所选模型与渠道的流式、工具兼容性，不要自动改成 Chat Completions。更多处理见接入排错。
分别查看 ChatGPT 桌面 App / Codex 和 Codex IDE 扩展。这些教程也使用固定的用户凭据文件。自定义 provider 与内置 provider 的地址字段不同，切换时按对应教程完整配置。
macOS、Windows 原生和 Linux 都有官方 CLI 安装方式。Windows 推荐 Windows 11；较新的完整更新版 Windows 10 属于尽力支持范围。如果已有 Node.js/npm，也可以在相应系统终端运行 npm install -g @openai/codex。WSL 是可选方案；使用 WSL2 时，安装、~/.codex/config.toml 和 Key 都放在同一个 Linux 发行版中，并执行上方 Linux 标签中的命令，不读取 Windows 的用户目录。WSL1 已不支持。详见官方 WSL 指南。
核对日期：2026-09-10。已使用 Linux x86_64 上的官方完整 Codex CLI 0.154.0、仅保存在 auth.json 的真实 ABCRelay Key，以及 https://www.abcrelay.com/v1，通过独立新进程验证 gpt-5.6-sol 回复与 shell 文件读取工具，全程未设置 Key 环境变量。CLI 0.153.4 / 0.154.0 还通过本地请求捕获验证了鉴权配置。macOS、Windows、IDE 与桌面流程依据官方资料核对，未逐端完成端到端实测。