本地 Codex 接口登录报错 account/read failed 排查与修复记录

本地 Codex 接口登录报错 account/read failed 的排查与修复记录

摘要

本地启动 Codex 时出现：

Error: account/read failed during TUI bootstrap: account/read failed: email and plan type are required for chatgpt authentication (code -32600)

这次的核心问题是：我想使用接口 / API Key 登录，但 Codex 仍然按 ChatGPT 账号认证流程启动，所以它尝试读取账号的 email 和 plan type，最终启动失败。

最终修复方式：

codex logoutset OPENAI_API_KEY=你的_API_KEYecho %OPENAI_API_KEY% | codex login --with-api-keycodex login statuscodex

成功标志：

Logged in using an API key - sk-xxx

一、问题现象

在 Windows CMD 中执行：

codex

报错：

Error: account/read failed during TUI bootstrap: account/read failed: email and plan type are required for chatgpt authentication (code -32600)

关键信息是：

chatgpt authenticationemail and plan type are required

这说明 Codex 当前仍在尝试走 ChatGPT 账号登录，而不是 API Key 登录。

二、问题结论

本次问题不是模型不可用，也不是命令行本身坏了，而是 登录方式不匹配：

• 我的目标：使用接口 / API Key 登录
• 实际状态：Codex 仍尝试走 ChatGPT 账号认证
• 结果：启动 TUI 时读取不到 email 和 plan type，于是报 account/read failed

修复方向就是：退出当前登录状态，并重新使用 API Key 方式登录。

三、修复步骤

1. 退出当前登录状态

codex logout

如果之前进入过设备码登录流程，可以先在当前 CMD 中按：

Ctrl + C

因为 codex login --device-auth 属于 ChatGPT 账号登录流程，不适合这次的 API Key 接入目标。

2. 设置 API Key

当前 CMD 窗口临时生效：

set OPENAI_API_KEY=你的_API_KEY

长期生效可以用：

setx OPENAI_API_KEY "你的_API_KEY"

注意：setx 执行后需要关闭当前 CMD，重新打开一个新的 CMD 窗口。

3. 使用 API Key 登录

echo %OPENAI_API_KEY% | codex login --with-api-key

4. 验证登录状态

codex login status

正常输出类似：

Logged in using an API key - sk-xxx

看到这行，说明 Codex 已经切换到 API Key 登录方式。

5. 启动 Codex 测试

codex

进入 TUI 后输入：

你好

如果 Codex 能正常回复，说明登录和调用链路已经恢复。

四、完整命令汇总

临时方式：

codex logoutset OPENAI_API_KEY=你的_API_KEYecho %OPENAI_API_KEY% | codex login --with-api-keycodex login statuscodex

长期方式：

setx OPENAI_API_KEY "你的_API_KEY"

然后重新打开 CMD：

echo %OPENAI_API_KEY% | codex login --with-api-keycodex login statuscodex

五、配置文件检查

如果 API Key 登录后仍然异常，可以检查配置文件：

type "%USERPROFILE%.codexconfig.toml"

重点查看是否存在：

forced_login_method = "chatgpt"

如果目标是 API Key 登录，建议删除或注释掉这行，避免 Codex 又回到 ChatGPT 账号认证流程。

也可以搜索配置残留：

findstr /S /I /N "forced_login_method model_provider base_url" "%USERPROFILE%.codex*"

六、常见坑

1. 不要把设备码登录和 API Key 登录混用

如果目标是 API Key 登录，就不要继续执行：

codex login --device-auth

这个命令是 ChatGPT 账号设备码登录，不是接口登录。

七、最终结果

修复后执行：

codex login status

输出：

Logged in using an API key - sk-xxx

随后启动 Codex：

codex

发送测试消息后可以正常回复。

八、总结

这次报错的根因是：本地 Codex 目标是 API Key / 接口登录，但实际仍在走 ChatGPT 账号认证流程。

最终解决路径：

1. codex logout
2. 设置 OPENAI_API_KEY
3. 使用 codex login --with-api-key
4. 通过 codex login status 确认显示 Logged in using an API key
5. 启动 Codex 并发送测试消息

核心命令：

codex logoutset OPENAI_API_KEY=你的_API_KEYecho %OPENAI_API_KEY% | codex login --with-api-keycodex login statuscodex

至此，本地 Codex 接口登录恢复正常。