401 Unauthorized 怎么办？登录失效的处理

用着好好的 Codex，突然开始甩 401 Unauthorized，任务跑到一半全数退回——这是 AI 编程工具用户遇上频率最高的报错之一。401 的含义很明确：服务器认不出你的身份，问题出在凭据这一层，与网络、模型、代码都无关。好在它的处理路径相对固定：先分清报错归属，再按登录道分别重建凭据，绝大多数情况当场恢复。这篇按排查顺序讲：先看报错说了什么，再分别处理 ChatGPT 登录道与 API key 道，最后交代凭据文件的日常纪律；登录根本走不通的情况见Windows 登录一篇。

先确认：401 在说什么

动手前先看全报错。401 Unauthorized 属于认证失败：请求到了服务器，但附带的凭据无效或已过期。它与 429 不同——429 是「认出你了，但额度不够」，401 是「我不认识你」，两个问题的处理方向完全不同，429 的分流见429 限流一篇。还要留意一种包装情况：有时 401 藏在 exceeded retry limit 这样的外层报错里，同一种外壳能包住多种根因，分流办法见重试上限一篇，先找到末尾的真实状态码再动手，方向不会错。

ChatGPT 登录道：logout 加 login 一套连招

走 ChatGPT 订阅道的，凭据存放在本地 auth.json 里，失效的常见原因有三类：令牌自然过期；账号在网页端改了密码或撤销了会话，本地令牌被连坐作废；刷新令牌时请求被拒、报 invalid_grant，多见于长时间未用后的再次登录。处理动作是一套固定连招：codex logout 清掉本地旧凭据，codex login 重新走一遍浏览器授权，新凭据落盘后恢复正常。绝大多数 401 到这一步就解决了；如果重新登录本身也失败，那是登录通道的问题，转交 Windows 登录一篇处理，两条道与凭据的背景见登录两条道一篇。

API key 道：重新生成，重开终端

走 API key 道的，401 多半出在密钥本身：key 在后台被手动删除或撤销；复制时不完整，漏了头尾字符；账户欠费或密钥所属项目被停用。处理路径是到平台后台重新生成一把新 key，替换旧值，确认账户状态正常。有个细节值得留意：key 常通过环境变量注入，改完变量后要重开终端会话，旧会话里还是旧值，配置不生效时容易被误判成「重新生成了也没用」，白折腾一轮。如果环境变量与订阅登录同时挂着，还要先理清请求实际走了哪条道，报错与账单才对得上号。

修好之后：凭据的日常纪律

401 处理完，顺手把凭据的日常习惯立起来。auth.json 与 API key 都当密码看：不进代码仓库、不贴截图、不外借；多人共用一台机器时各自用系统账户，避免凭据互相覆盖——凭据被另一个登录顶掉，也是 401 的隐性来源。再养成一个留痕的习惯：哪天重新登录过、谁换过 key，随手记一笔，下次排查能省一半猜测。让 DeepSeek 把两条登录道的处理步骤整理成一张排查卡片，再用豆包解释 invalid_grant 这类术语的确切含义，下次报错照单处理，恢复速度会快很多。

401 处理速查

• 401 是认证失败，与 429 的额度问题分流处理
• exceeded retry limit 是外壳，先找末尾真实状态码
• ChatGPT 道：codex logout 清旧凭据，login 重新授权
• API key 道：后台重新生成，替换后重开终端会话
• auth.json 当密码看，不进仓库、不外借、留痕

401 处理快问快答

• 401 和 429 先后出现，先修哪个？：先修 401。身份不被认，谈额度没有意义；凭据恢复后若仍提示额度问题，再按额度那条线排查。
• 重新登录会丢配置吗？：不会。logout 与 login 只动凭据文件，项目配置与设置都留在原处，重新登录后原样可用。
• 短时间内反复掉登录正常吗？：偶尔一次多属令牌过期；反复掉线要往环境找原因——安全软件清理凭据文件、多设备互相顶会话都有可能，值得逐项排查。