Codex 登录失败怎么办：认证、网络与账号状态排查

Codex 登录失败常被误判为密码错误，但终端认证还涉及浏览器授权回跳、账号选择、客户端状态、系统时间和网络策略。先确认失败发生在打开登录页之前、完成授权之后，还是进入项目后，能大幅缩短排查时间。

## 第一步：确认账号一致

浏览器可能同时登录多个 ChatGPT 账号。授权时要确认选择的账号与订阅账号一致，工作区用户还要确认进入了正确工作区。不要因为浏览器首页显示已登录，就默认 CLI 获得了同一账号的权限。

如果刚切换过账号，先退出 Codex 客户端，再从官方登录入口重新完成授权。不要把登录链接转发给别人，也不要让第三方远程接管浏览器完成认证。

## 第二步：定位失败阶段

- 无法打开授权页：检查默认浏览器、代理、DNS 和防火墙。 - 授权页成功但客户端一直等待：检查回跳是否被浏览器或安全软件拦截。 - 客户端显示已登录但任务无权限：检查工作区、套餐和项目权限。 - 过一段时间频繁掉线：检查系统时间、客户端版本和网络切换。

记录完整错误文案和时间。只说“登录不上”无法区分账号认证、传输连接还是权限问题。

## 第三步：做最小化测试

1. 关闭重复打开的 Codex、IDE 和旧终端进程。 2. 新开终端并检查 Codex 版本。 3. 暂时停用会改写流量的非必要代理规则。 4. 重新登录后，在空白测试目录执行只读任务。 5. 再回到目标仓库测试，比较两次结果。

如果测试目录正常，问题更可能来自仓库配置或权限；如果所有目录都失败，再处理认证和网络。

## 不要做的事情

- 不要把密码、验证码、Cookie、Session Token 或 API Key 发给代办人员。 - 不要随意删除整个用户配置目录，先确认具体缓存文件和可恢复方式。 - 不要反复重置密码，除非官方明确提示密码或账号安全问题。 - 不要关闭全部系统安全策略来换取一次连接成功。

## 提交官方支持前准备

准备账号邮箱的脱敏形式、客户端版本、操作系统、失败时间、完整错误信息、网络类型和已完成的排查步骤。涉及付款或订阅时，只提供订单号等必要信息，银行卡号仅保留末四位。这样既能保护账号，也能减少重复沟通。