Codex「unexpected status 401 Unauthorized」、登录失败怎么办（2026）
一句话结论
unexpected status 401 Unauthorized 表示 服务器不认你当前的凭证。先看 OpenAI 状态页，排除大面积故障；再运行 codex login status 确认你在用 ChatGPT 登录还是 API key，然后 codex logout、codex login 重新登录。在远程服务器、SSH、容器里浏览器登录走不通的，用 设备码登录 codex login --device-auth。
阅读说明
官方信息查阅日期：2026-10-24。来源：Codex 官方文档 Authentication、openai/codex GitHub issue #48237 的 OpenAI 维护者回复。
你可能看到的报错
unexpected status 401 Unauthorized: Incorrect API key provided: sk-...
url: https://chatgpt.com/backend-api/codex/responses
按顺序排查
1. 先看是不是大面积故障
2026-09-25 曾出现大量用户同时报这条错误。OpenAI 维护者在 openai/codex issue #48237 回复：这是一次大范围故障，问题已定位并缓解，恢复会逐步推送到各集群，不需要重复提交报告；官方故障记录在 OpenAI 状态页。
所以遇到 401，先看 OpenAI 状态页有没有正在处理的故障，有的话等官方恢复即可。怎么看状态页见 ChatGPT 今天崩了吗。
2. 确认当前登录方式
运行：
codex login status
- 用 API key 登录：到 OpenAI 平台检查这把 key 是否有效、是否被撤销，必要时换新 key 重新登录：
printenv OPENAI_API_KEY | codex login --with-api-key。 - 用 ChatGPT 登录：继续下一步。
3. 退出后重新登录
codex logout
codex login
官方说明：CLI 和 IDE 插件共用同一份登录缓存，任何一边退出，另一边下次启动都要重新登录。用 ChatGPT 登录时，Codex 会在令牌过期前自动刷新。
4. 公司网络有 TLS 代理
设置 CODEX_CA_CERTIFICATE 指向公司根证书（PEM），再登录；没设时 Codex 会读 SSL_CERT_FILE。
5. 管理员限制了登录方式
托管配置里如果设了 forced_login_method 或 forced_chatgpt_workspace_id，当前凭证不符合时 Codex 会退出登录并关闭。找管理员确认要求的登录方式和工作区。
在服务器、SSH、容器里登录不了
浏览器登录要把令牌回传到本机 localhost 回调，远程或无界面环境经常走不通。官方推荐顺序：
- 设备码登录（beta）：先在 ChatGPT 安全设置（个人）或工作区权限（管理员）里开启设备码登录，再运行
codex login --device-auth，在浏览器打开链接、登录后输入一次性代码。 - SSH 端口转发：本机运行
ssh -L 1455:localhost:1455 user@remote，在这个 SSH 会话里执行codex login。默认回调端口是 1455。 - 复制登录缓存：在有浏览器的机器上登录后，把
~/.codex/auth.json复制到服务器同一路径。官方提醒：这个文件里有访问令牌，要当密码对待，不要提交到仓库、贴进工单或发到聊天里。
登录失败时，codex login 会在日志目录写一份 codex-login.log，排查或联系支持时用得上。
相关阅读
参考来源
- Codex 官方文档 · Authentication：https://learn.chatgpt.com/docs/auth（查阅日期：2026-10-24）
- openai/codex GitHub issue #48237（OpenAI 维护者回复）：https://github.com/openai/codex/issues/48237（查阅日期：2026-10-24）
- OpenAI Status：https://status.openai.com/（查阅日期：2026-10-24）