本地Codex接口登录报错account/read failed问题排查与修复指南
在本地启动Codex的过程中,系统显示了登录验证失败的错误提示,具体报错信息为account/read failed。该问题需要排查与修复才能正常使用。

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
摘要
本文详细解析了本地Codex启动时遭遇account/read failed错误的根本原因,并提供了从退出登录到使用API Key重新认证的完整修复步骤,最终确保TUI界面能够正常启动与通信。
一、问题现象
在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而报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,再重新打开一个新窗口。
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 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
发送测试消息后能够正常回复。
八、总结
本次报错的根源在于:本地Codex预期采用API Key/接口登录,实际却走了ChatGPT账号认证流程。
最终解决路径:
codex logout- 设置
OPENAI_API_KEY - 使用
codex login --with-api-key - 通过
codex login status确认显示Logged in using an API key - 启动Codex并发送测试消息
核心命令:
codex logout set OPENAI_API_KEY=你的_API_KEY echo %OPENAI_API_KEY% | codex login --with-api-key codex login status codex
经过以上操作,Codex成功切换至API Key认证模式,接口登录功能恢复正常运行,本地环境中的登录与调用问题得到解决。