本地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 logout
set OPENAI_API_KEY=你的_API_KEY
echo %OPENAI_API_KEY% | codex login --with-api-key
codex login status
codex

成功后看到一行日志：

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 authentication
email and plan type are required

意思很清楚：Codex 依然在用 ChatGPT 账号登录的逻辑，而不是我们想要的 API Key 方式。

二、问题结论

这事儿其实不算大事，就是个登录姿势搞拧了。模型没问题，命令行也正常，

：

• 目标：用 API Key 登录
• 实际：Codex 还在走 ChatGPT 账号认证
• 结果：启动 TUI 时拿不到 email 和 plan type，于是报错

修复方向很明确：

三、修复步骤

1. 退出当前登录状态

codex logout

如果之前进入过设备码登录流程，可以先把当前窗口截停：

Ctrl + C

因为 codex login --device-auth 走的是 ChatGPT 账号流程，跟 API Key 这条路不搭。

2. 设置 API Key

想要在当前窗口临时生效：

set OPENAI_API_KEY=你的_API_KEY

想要一劳永逸：

setx OPENAI_API_KEY "你的_API_KEY"

注意：setx 执行完后要关掉当前 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 logout
set OPENAI_API_KEY=你的_API_KEY
echo %OPENAI_API_KEY% | codex login --with-api-key
codex login status
codex

长期方案：

setx OPENAI_API_KEY "你的_API_KEY"

然后重新开 CMD：

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

五、配置文件检查

如果 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

发送测试消息，正常回复。

八、总结

这次报错的根因就一句话：

。

解决路径很清晰：

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 logout
set OPENAI_API_KEY=你的_API_KEY
echo %OPENAI_API_KEY% | codex login --with-api-key
codex login status
codex

到了这一步，本地 Codex 接口登录就算彻底恢复正常了。