排错与 FAQ
登录问题
桌面应用与 CLI 的登录问题:Codex 登录失败、浏览器回调不回来、设备码不可用、提示无权使用、被自动登出等问题的排查方法。
先确认当前状态
打开个人菜单,可以看到当前登录的账号(或 API Key 状态)。未登录时,在登录界面点 Continue to sign in,然后在浏览器里完成登录。
想换账号:在个人菜单里选 Log out,再重新登录。
常见情况
CLI:浏览器登录成功了,但终端一直在等
Codex 通过本机 localhost:1455 接收登录回调。下面这些情况会导致回调传不回来:
- 你在远程服务器或 SSH 会话里运行 Codex;
- 本机的安全软件或网络设置挡住了 localhost 回调。
解决:改用设备码登录,或者用 SSH 端口转发,见CLI 远程与设备码登录。
CLI:选不了设备码登录 / 设备码登录失败
设备码登录是 Beta 功能,需要先开启:
- 个人账号:在 ChatGPT 的安全设置里开启设备码登录;
- 工作区账号:需要工作区管理员在权限设置里开启。
还不行的话,可以退回到"在有浏览器的电脑上登录,再复制 auth.json"的方法。
登录后提示无权使用 Codex
- 检查套餐:CLI、IDE 扩展和云端至少需要 Plus。Free 和 Go 只能在 ChatGPT 桌面应用里使用,请改用桌面应用;
- 检查工作区:账号在多个工作区时,确认登录的是开通了 Codex 的那个;
- 企业工作区可能限制了成员能用的功能,需要管理员开通。
用不了 Codex Cloud
- 必须是 ChatGPT 登录,API Key 不支持云端;
- 邮箱 + 密码登录的账号,必须先开启 MFA。
登录后被自动登出
如果 Codex 登录后马上退出,可能是本机或组织配置里设置了强制登录方式或工作区(forced_login_method、forced_chatgpt_workspace_id),而你登录的账号不符合要求。检查 ~/.codex/config.toml 和组织下发的配置。
想从 API Key 切回 ChatGPT 登录
桌面应用:在个人菜单里 Log out,再选择用 ChatGPT 账号登录。CLI:
codex logout
codex login公司网络提示证书错误
公司用了 TLS 代理或私有根证书时,登录前设置:
export CODEX_CA_CERTIFICATE=/path/to/corporate-root-ca.pem
codex login查看登录日志
直接运行 codex login 时,Codex 会在日志目录里写一份 codex-login.log。浏览器登录或设备码登录失败时可以查看,联系售后时也可以提供(发送前检查有没有敏感信息)。
什么时候需要联系售后
下面这些情况,多半和账号本身有关,请联系售后:
- 网页 chatgpt.com 也登录不了;
- 登录后看到的套餐和约定不一致;
- 提示账号被停用、需要验证或存在异常;
- 收不到验证码,或者 MFA 设备丢失、备份码也找不到。