CODEX / 登录排查

Codex 登录不上怎么办?CLI、桌面端与 IDE 授权排查

Codex 登录不上、CLI 授权失败或浏览器登录后仍未连接?先确认账号和入口,再按版本、浏览器、网络与错误提示逐步排查。

Codex登录不上Codex CLI登录Codex授权失败Codex sign in
先做这三步

确认浏览器登录的是拥有 Codex 权益的同一个 ChatGPT 账号;更新 Codex 客户端;在对应客户端重新发起登录。CLI 用户可以在项目目录运行 codex --login,然后按提示选择 Sign in with ChatGPT。登录成功后,回到客户端确认会话已连接。

官方参考:Codex CLI 官方指南 · Using Codex with your ChatGPT plan · ChatGPT 登录排查

先判断:你在哪个 Codex 入口登录?

Codex 不是只有一个登录按钮。ChatGPT 桌面端、Codex CLI、IDE 扩展和 Codex Web 都可能使用 ChatGPT 账号登录,但每个客户端的授权回调、版本和工作区设置不同。先记录出错入口,再处理对应问题;不要在 CLI 出错时只反复刷新网页。

  • CLI:在终端运行 codex,首次启动按提示登录;需要重新授权时运行 codex --login。
  • 桌面端:在 Codex 模式中使用 ChatGPT 账号登录,若出现电话验证或工作区限制,按客户端提示处理。
  • IDE:确认扩展已更新,并检查它使用的账号是否和 ChatGPT 网页端一致。
  • Web/Cloud:先确认账号和工作区,再检查 Codex Cloud 是否对当前计划和账号开放。

官方当前说明 Codex 已包含在 ChatGPT 计划中,但使用量、Codex Cloud 可用性和工作区开关会因计划与账号而变化;不要把“能登录 ChatGPT”直接等同于“每个 Codex 入口都已开通”。可先查看 Codex 使用总览 和 ChatGPT Plus 说明。

Codex CLI 登录不上:按顺序排查

1. 先更新 CLI,再重新发起登录

旧版本可能无法匹配当前登录流程。使用 npm 安装的用户可以更新包,然后重新运行登录命令:

npm i -g @openai/codex
codex --login
codex

如果你使用独立安装器或 Homebrew,请按 官方 CLI 指南 的对应方式更新。更新后仍失败,记下 CLI 版本和完整错误文本,不要只截取最后一行。

2. 确认浏览器账号和登录方式

浏览器授权成功但 CLI 仍显示未登录时,先确认授权页使用的是同一个 ChatGPT 账号。若账号最初通过 Google、Microsoft、Apple 或邮箱密码注册,应继续使用原来的登录方式;OpenAI 的登录排查说明指出,换登录方式可能进入另一个账号或触发 Wrong authentication method。

3. 清理会话冲突,但不要清理重要凭证

关闭重复的授权标签页,用无痕窗口重新发起一次登录,并暂时停用会修改页面或拦截脚本的扩展。不要把本地认证文件、密码、一次性验证码或 API Key 上传给第三方。若使用远程终端、WSL 或公司网络,优先按 CLI 当前提示完成授权,并确认浏览器和终端处在允许访问的网络环境。

按错误现象定位原因

现象优先检查下一步
浏览器登录成功,终端仍未登录账号是否一致、CLI 是否过旧、授权是否回到原终端更新 CLI,重新运行 codex --login,不要只刷新网页
Wrong authentication method首次注册时使用的 Google、Microsoft、Apple 或邮箱方式改用原登录方式,并用无痕窗口重试
Suspicious login behaviorVPN、代理、频繁重试、异常网络关闭 VPN,换网络,清理 Cookie,等待一段时间后再试
Something went wrong / Oops服务状态、扩展、Cookie、JavaScript、客户端版本检查 OpenAI Status,再用干净浏览器重试
能登录但看不到 Codex Cloud计划、地区、rollout 和工作区设置先确认账号权限;Cloud 不可用时可先使用 CLI 或 IDE

如果是 ChatGPT 登录问题,先恢复账号访问

Codex 使用 ChatGPT 账号时,账号本身登录失败会连带影响 CLI、IDE 和桌面端。验证码收不到时检查垃圾邮件并使用最新验证码;Cloudflare 验证循环时,关闭 VPN/代理、允许 Cookie 和 JavaScript、换无痕窗口或网络。出现“异常登录行为”时不要连续尝试,官方建议先清理缓存和 Cookie、关闭 VPN,并等待后再重新登录。需要更完整的账号排查,可阅读 ChatGPT 登录不上怎么办。

登录成功但权限不对:区分账号、订阅和 API

登录状态、ChatGPT 订阅、Codex 用量和 API 余额是不同概念。Plus 或 Pro 账号登录成功后,仍应以当前账号实际显示的 Codex 入口、Usage 和模型为准;API Key 也不是 ChatGPT Plus 的替代品。若你的目标是程序调用,而不是在终端使用 Codex,应先看 ChatGPT Plus 和 API 的区别。如果能登录但出现额度提示,再看 Codex 限流与 Reset 排查。

什么时候应该联系官方支持?

完成更新、账号核对、干净浏览器和状态检查后仍失败,再联系官方支持。准备以下信息会更容易定位:入口(CLI、桌面端、IDE 或 Web)、客户端版本、操作系统、发生时间和时区、完整错误文本、是否更换网络,以及是否能在 ChatGPT 网页端正常登录。不要提交密码、验证码、Session、完整 API Key 或支付卡号。

常见问题

Codex CLI 登录要运行什么命令?

先更新或安装最新版 Codex CLI,再在项目目录运行 codex --login,按终端提示选择 Sign in with ChatGPT 或其他可用方式。

ChatGPT Plus 能登录 Codex 吗?

官方说明 Codex 已包含在 ChatGPT 计划中,具体使用量和入口会按计划、客户端与账号状态变化;登录后以账号实际显示为准。

浏览器已经登录,为什么 Codex 仍然显示未登录?

通常先确认浏览器登录的是同一个 ChatGPT 账号,再回到发起登录的 Codex 客户端完成授权;同时检查客户端版本、网络、浏览器扩展和服务状态。

Codex 登录需要手动粘贴 API Key 吗?

使用 Sign in with ChatGPT 时通常不需要手动复制 API Key;API Key 是另一种开发者认证路径,不能与 ChatGPT 订阅或 CLI 登录状态混为一谈。

登录失败时可以把密码或验证码发给客服吗?

不可以。不要向任何人提供密码、一次性验证码、Session 或完整 API Key;联系支持时只提供错误文本、时间、版本、系统和登录入口等非敏感信息。

还没确定适合哪个 Codex 入口?

先看 Codex 总览,再按 CLI、IDE、Cloud、额度和模型页面继续。购买或账号服务请以实际商品页和订单说明为准。