Skip to content

Codex 手动接入 ​

一键脚本不适用时,手动把 MyAutoAPI 管理后台生成的配置写入本机 .codex 文件夹。重新打开 Codex 后,即可通过 MyAutoAPI 使用模型。

先按 快速开始 创建 API Key,再回来继续。

找到配置文件 ​

Codex 的配置文件放在用户目录下的 .codex 文件夹中:

系统配置目录
WindowsC:\Users\你的用户名\.codex,也可以在文件管理器地址栏输入 %USERPROFILE%\.codex
macOS / Linux / WSL~/.codex

这个目录里需要处理两个文件:

文件写入内容
config.toml后台生成的模型、接口地址和接入配置
auth.json后台生成的 MyAutoAPI API Key 配置

Windows:打开 .codex 文件夹 ​

  1. 打开 此电脑,进入 本地磁盘 (C:),再打开 用户 文件夹。
在 Windows 的 C 盘打开用户文件夹
  1. 打开你的 Windows 用户名文件夹。不要打开 公用 或 Administrator;图中的 ss 只是示例用户名。
在用户文件夹中打开自己的 Windows 用户名
  1. 打开 .codex 文件夹。
在 Windows 用户目录中打开 .codex 文件夹
  1. 找到 auth.json 和 config.toml。不要删除这个文件夹里的其它文件或文件夹。
在 .codex 文件夹中找到 auth.json 和 config.toml

文件不存在时,在 .codex 文件夹中新建同名文件。Windows 新建后确认文件名没有变成 config.toml.txt 或 auth.json.txt。

写入后台配置 ​

回到 MyAutoAPI 后台的 API 密钥 页面,在密钥列表中找到要使用的 Key,点击右侧的 使用密钥。

在 API 密钥列表中点击使用密钥

在弹窗中选择 Codex CLI,再按本机系统选择 macOS / Linux 或 Windows。后台显示的是两段配置内容,不是两个下载文件。

  1. 打开本机的 config.toml,删除里面原有的全部文字。把后台显示的 config.toml 内容粘贴进去并保存。
  2. 打开本机的 auth.json,删除里面原有的全部文字。把后台显示的 auth.json 内容粘贴进去并保存。

两个文件不能贴反,也不要把两段内容合并到同一个文件。

复制 config.toml 和 auth.json 内容并分别保存

重开 Codex 测试 ​

Codex CLI 用户关闭原来的终端,重新打开终端后执行:

bash
codex

ChatGPT 桌面应用用户先在右下角托盘找到 ChatGPT 图标,点击 Exit 彻底退出,再重新打开应用并切换到 Codex。仍未读取新配置时,在任务管理器中结束所有 ChatGPT 相关进程,或者重启电脑后再打开。

从 Windows 右下角托盘退出 ChatGPT 桌面应用

重新打开后,新建一个对话或任务,不要继续使用修改配置前的旧对话。发送:

text
测试

能正常收到回复,就说明 Codex 已经通过 MyAutoAPI 接入。需要核对实际请求时,进入 MyAutoAPI 后台的 使用记录 页面查看。

常见问题 ​

现象检查动作
401 Unauthorized重新复制后台的 auth.json 内容,确认 API Key 没有缺少字符
401 Unauthorized,API Key 确认完整打开 config.toml,对照 Key 写在哪个文件 检查 requires_openai_auth 和 Key 的位置
403 Forbidden回到 API 密钥 页面,确认当前 Key 所属分组支持配置中的模型
Windows 修改后不生效确认文件名不是 config.toml.txt 或 auth.json.txt,再彻底退出并重新打开 Codex
后台没有使用记录确认两个文件位于当前 Codex 实际读取的 .codex 目录,并重新新建对话测试

仍然无法使用时,返回 快速开始 改用一键脚本。

进阶:Key 写在哪个文件 ​

手动修改配置时,config.toml 里 [model_providers.OpenAI] 下的 requires_openai_auth 决定 Codex 发请求时带哪个 Key:

requires_openai_authCodex 带哪个 Key
trueauth.json 里的 API Key
falseconfig.toml 里 experimental_bearer_token 写的 API Key,不读取 auth.json

2026 年 8 月下旬起的 Codex 版本,requires_openai_auth = false 时不再读取 auth.json。旧配置把 Key 放在 auth.json、同时写 requires_openai_auth = false,请求不带 Key,返回 401 Unauthorized。

现在可用的写法有两种,二选一:

写法一写法二
使用场景一键脚本写入的默认配置需要 Codex 内置生图工具
API Key 位置auth.json 的 OPENAI_API_KEYconfig.toml 的 experimental_bearer_token
requires_openai_authtruefalse
生图请求头 http_headers不写写
Codex 内置生图工具不提供提供
auth.json写入 API Key,替换原来的 ChatGPT 登录信息不使用

写法二在 [model_providers.OpenAI] 下写这三行:

toml
requires_openai_auth = false
experimental_bearer_token = "这里完整填写你的中转站 API Key"
http_headers = { "x-openai-actor-authorization" = "local-image-extension" }

http_headers 这一行是 Codex 内置生图工具的开关,只在 requires_openai_auth = false 时生效;它不负责验证 API Key。内置生图的完整步骤看 Codex 内置生图。

写法二的 API Key 保存在 config.toml 里。把 config.toml 发给别人或截图前,先删掉 experimental_bearer_token 这一行。