更新 Codex → 在原项目目录运行 codex --login → 浏览器使用拥有 Codex 权益的同一 ChatGPT 账号 → 完成授权后回到原终端或 IDE → 再检查版本、网络和工作区限制。授权码、Session、密码和完整 API Key 不要发给任何人。
官方参考：Codex CLI 官方指南 · Using Codex with your ChatGPT plan · ChatGPT 登录排查
先区分：登录失败，还是授权失败？
登录回答“你是谁”；授权回答“这个客户端能不能代表你使用 Codex”。浏览器没有完成账号验证时是登录问题；浏览器已经允许访问，但 CLI、IDE 或桌面端没有拿到授权结果时，才更接近授权问题。两类问题的处理路径不同，反复刷新同一个网页通常不能修复客户端授权。
| 你看到的现象 | 更可能是哪一层 | 先做什么 |
|---|---|---|
| 账号页面打不开、验证码收不到 | ChatGPT 登录或验证 | 按 ChatGPT 登录排查 检查邮箱、Cookie、网络和登录方式 |
| 浏览器允许后，CLI 仍未连接 | 授权结果没有回到原终端 | 关闭重复授权页，回到启动登录的终端，重新运行 codex --login |
| IDE 显示 token invalid / unauthorized | 扩展版本或本地会话状态 | 更新扩展，退出后重新授权，确认 IDE 使用的账号一致 |
| API 请求 401/403 | API Key、组织或项目权限 | 检查 API Key 是否属于正确项目；不要把 API Key 当作 ChatGPT 登录凭证 |
| 能登录但看不到 Cloud | 计划、rollout 或工作区设置 | 确认当前账号和 Cloud 可用性，再看 Codex Cloud 说明 |
Codex CLI 授权失败：按这个顺序重做
1. 更新客户端并从原目录发起登录
官方 CLI 快速入门要求在项目目录运行 codex，首次启动时选择 Sign in with ChatGPT 或其他可用登录方式。需要重新授权时，优先使用：
npm i -g @openai/codex
codex --login
codex如果你是通过独立安装器或 Homebrew 安装，请使用官方指南对应的更新方式。不要在多个旧终端同时发起授权，否则很难判断哪个会话应该接收回调。
2. 浏览器只保留一个授权会话
关闭旧的 Codex 授权标签页，重新打开登录页，并确认登录账号是你要使用 Codex 的那个账号。Google、Microsoft、Apple 和邮箱密码是不同登录入口；如果最初用其中一种方式注册，换另一种方式可能进入另一个账号或触发 Wrong authentication method。授权完成后，不要停留在浏览器页面，要回到原终端或 IDE 看它是否收到结果。
3. 排除网络和扩展阻断
VPN、代理、广告拦截器、隐私扩展、Cookie 设置和企业网络策略都可能让登录页能打开，却让授权回调失败。可暂时关闭 VPN/代理和会修改页面的扩展，允许 chatgpt.com、openai.com 与 auth.openai.com 的 Cookie 和 JavaScript，用无痕窗口或另一网络重新执行一次。若仍失败，先看 OpenAI Status 是否有服务异常。
如果提示 token invalid、unauthorized 或 401/403
这类错误不要直接归因于 ChatGPT Plus 失效。先确认你使用的是哪条认证路径：
- Sign in with ChatGPT：主要检查账号、客户端版本、授权回调和工作区设置；通常不需要手动粘贴 API Key。
- API Key：检查环境变量是否仍指向旧 Key、Key 是否被撤销、组织和项目是否正确，以及项目是否有目标模型权限。API 余额和 ChatGPT 订阅是独立的。
- 企业或受管工作区：个人账号能登录，不代表工作区允许 Codex Local、Cloud 或 IDE；需要管理员确认对应开关和角色。
如果你的目标是程序调用，而不是在终端使用 Codex，请先阅读 ChatGPT Plus 和 API 的区别；如果目标是本地代码开发，再看 Codex CLI 使用教程。
授权成功但仍然不能使用 Codex
授权只证明客户端拿到了身份结果，不代表所有功能都已开通。官方说明 Codex 已包含在 ChatGPT 计划中，但使用量、Codex Cloud 可用性和工作区设置会变化。登录后仍应检查当前账号的 Usage、模型列表、Cloud 入口和错误提示；额度问题请看 Codex 限流与 Reset，模型不可见请看 Codex 支持哪些模型。
联系支持前准备什么？
如果更新客户端、重新授权、切换干净浏览器和检查状态后仍失败，准备入口（CLI、IDE、桌面端或 Web）、客户端版本、系统、发生时间和时区、完整错误文本、浏览器登录方式、网络变化以及是否能正常登录 ChatGPT。不要提交密码、一次性验证码、授权码、Session、完整 API Key 或银行卡信息。
常见问题
Codex 授权失败和登录失败有什么区别？
登录失败是账号没有完成身份验证；授权失败通常是浏览器登录完成后，客户端没有拿到或没有接受授权结果，也可能是客户端版本、网络或工作区权限问题。
Codex CLI 授权失败应该先运行什么？
先更新 Codex CLI，然后在项目目录运行 codex --login，按终端提示重新选择 Sign in with ChatGPT 或其他可用登录方式。
浏览器显示允许访问，CLI 仍然授权失败怎么办？
确认浏览器和 CLI 使用的是同一个账号，回到发起授权的原终端，关闭重复授权页后用无痕窗口重试，并检查 VPN、代理、扩展和服务状态。
授权 Codex 一定要提供 API Key 吗？
使用 Sign in with ChatGPT 通常不需要手动粘贴 API Key。API Key 是独立的开发者认证方式，余额、组织和项目权限也独立于 ChatGPT 订阅。
可以把授权码或 Session 发给别人帮忙修复吗？
不可以。授权码、一次性验证码、Session、密码和完整 API Key 都属于敏感凭证，不应发送给第三方。
还没分清 Codex 登录和 API 调用？
先按本页完成授权排查，再根据使用场景进入 Codex CLI、Cloud、额度或 Plus/API 对比页面。