​
1. 按系统安装桌面 App

从官方桌面 App 下载入口选择 macOS 安装包，按安装窗口完成安装，在「应用程序」中打开 ChatGPT。
先完全退出 App，再进行下一步。本页配置三个系统的 桌面本地 Codex；网页、手机和 Linux 功能边界见 FAQ。

​
2. 设置 ABCRelay 地址

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

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

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

​
常见问题与详细说明

它们追加的接口路径不同：Codex 追加 /responses，Claude Code 追加 /v1/messages，所以基础地址不能互相照抄。此规则取决于客户端的配置字段和模式，与系统或模型品牌无关。其他客户端见API 地址对照表。
本次核对时，官方原 Codex App 文档入口已跳转到标题为「ChatGPT desktop app」的页面。桌面中可选择 ChatGPT 或 Codex；本页针对读取本地 Codex 配置的工作方式。名称相同并不代表所有入口都使用这份配置。不要把修改桌面 Codex 的请求地址，理解为替换了 App 中所有 ChatGPT 服务。
本页步骤仅适用于桌面本地 Codex。官方说明 ChatGPT 网页的 Work 运行在受管理环境中，不读取本机 Codex 配置；Codex 云端要求 ChatGPT 账户登录。已核对的官方资料没有建立手机 App 使用自定义 API 地址的操作路径，因此这里不提供手机接入承诺。需要图形界面使用 ABCRelay 时，可选择本页桌面入口，或 Cherry Studio、Chatbox。
完全退出 App 后，再修改第 3 步中已备份的凭据文件；仅保留上面的 API Key JSON，不混留旧 ChatGPT tokens 或冲突的 auth_mode。重新打开 App 后，新建本地 Codex 聊天。若当前版本仍需交互登录，在未登录界面选择 Sign in another way，填入 ABCRelay Key 并点 Continue。cli_auth_credentials_store = "file" 会将凭据持久化；之后不要再退出登录，除非希望清除这些凭据。App、CLI 和 IDE 可共享配置与登录状态，团队设备还可能限制登录方式，见官方鉴权说明。
从桌面图标启动的 App 不一定继承终端变量。本页将 Key 保存在 macOS / Linux 的 ~/.codex/auth.json，或 Windows 资源管理器路径 %USERPROFILE%\.codex\auth.json；cli_auth_credentials_store = "file" 明确选择该持久文件。凭据和带时间戳的备份都应保密，不要提交 Git。如果之前按 CLI 教程选择了 abcrelay 自定义 provider，本页需将顶层 model_provider 改为 openai。只改 openai_base_url 不会影响另一个已选中的 provider。
使用第 2 步的完整路径：macOS / Linux 为 ~/.codex/config.toml，Windows 资源管理器为 %USERPROFILE%\.codex\config.toml，无需寻找同名图形界面字段。自定义 CODEX_HOME 时，macOS / Linux shell 使用 $CODEX_HOME/config.toml，PowerShell 使用 $env:CODEX_HOME\config.toml。model、model_provider、openai_base_url 和 cli_auth_credentials_store 都是顶层字段。请备份并合并原配置，不要覆盖其他设置；也不要创建 [model_providers.openai]，内置 provider ID 不能重定义。修改后完全退出 App 并重新打开，使用新聊天验证。不要把地址放进相对于项目根目录的 ./.codex/config.toml，项目配置不能覆盖该字段。
本页只配置本地 Codex 的模型请求。需要 ChatGPT 工作空间、OAuth 或云端服务的功能有独立条件，ABCRelay Key 不等同于 ChatGPT 订阅。模型必须支持 Responses，实际编程功能还依赖流式和工具兼容性。先完成接入前准备，再用测试项目验证需要的功能。ABCRelay 请求按本站账户与渠道规则计费，不使用 ChatGPT 套餐额度。
核对是否进入本地 Codex、新建了聊天、使用 Key 登录，并选择了第 2 步的内置 openai provider。确认地址恰好为 https://www.abcrelay.com/v1，不要追加 /responses。401 / 403 继续检查 Key 状态与权限；404 检查路径和模型协议。能够登录或展示模型列表不代表推理请求已成功，必须核对实际调用记录。详见接入排错。
Linux 当前是官方预览版，支持范围及安装包见第 1 步。Computer Use 暂未在 Linux 预览版提供，因此不能把 macOS / Windows 的全部桌面功能视为 Linux 已支持。Wayland 原生支持仍属实验性，默认在可用时通过 XWayland 运行。窗口、焦点或快捷键异常时，先参考官方 Linux 限制说明，不要直接改动 API 配置来排查桌面问题。
上方 Windows 步骤针对默认的原生代理，配置文件在 Windows 用户目录。要让代理运行在 WSL2，需要在 App 设置中切换代理模式并重启；仅将集成终端切成 WSL 不会改变代理运行位置。切换后应核对实际运行环境的配置与凭据，不能假定 Windows 和 WSL 的用户目录相同。WSL1 已不支持，详见官方 Windows App 指南。
快速步骤使用固定的默认用户目录。若自行设置过 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。基于官方支持的 API Key 登录、共享配置和代理地址选项整理；未用真实 ABCRelay Key 完成桌面端到端测试。