codex报错须按类型分层排查：401查认证（重登）、403查权限（组织席位/sso）、429查用量、浏览器通终端卡住查回调（改用device-auth）、command not found查安装与path。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
遇到Codex报错时，不能一上来就删配置重装，必须按错误类型分层定位——401是认证失败，403是权限不足，429是用量超限，浏览器成功但终端卡住是回调链路断开，命令找不到则是环境或PATH问题，每个错误对应完全不同的排查路径。
先锁定错误类型再动手
第一步：复制完整报错文本，不要只截“401”或“command not found”这种片段；第二步：看错误发生时的上下文——是在执行codex login时？还是codex generate后运行代码时报错？或是VSCode插件里无响应？第三步：对照这张表快速归类：
| 错误表现 | 所属类型 | 立即该查什么 |
|---|---|---|
| 401 Unauthorized | 认证层 |
codex login status输出是否为logged in
|
| 403 Forbidden | 授权层 | 当前工作区是否有席位、SSO是否强制启用、管理员是否禁用了你的模型访问 |
| 429 / usage limit | 用量层 | OpenAI账户页面的Usage Dashboard是否已达日限额 |
| 浏览器跳转成功，终端仍显示“Waiting for authorization…” | 回调层 | 是否在WSL/SSH/容器中运行？本地端口8080能否被CLI进程监听到 |
输入codex --version提示command not found
|
安装层 |
npm list -g @openai/codex是否返回包信息，npm root -g路径是否已加入PATH
|
401 和 403 必须分开处理
方法一：401 Unauthorized（凭证未被接受）
执行codex logout→codex login完成一次受控重登；【不要跳过logout】直接codex login可能复用已失效的token，导致401持续出现。
方法二：403 Forbidden（身份已识别但无权限）
检查~/.codex/auth.json里的organization_id是否与你在OpenAI平台看到的组织ID一致；打开OpenAI后台 → Settings → Organization → Seats，确认你账户状态为Active且未被移出席位；如果启用了SSO，需联系管理员确认你的邮箱域是否在允许列表内。
浏览器成功但终端卡在等待
第一步：确认当前环境——如果是WSL、Docker容器、远程SSH或GitHub Codespaces，本地回调URL无法自动回传给CLI进程。
第二步：改用设备码登录，执行：codex login --device-auth；终端会输出一个一次性设备代码和验证网址；在任意浏览器中打开该网址，输入代码并授权；【设备代码有效期仅15分钟，且不可重复使用】。
第三步：授权完成后，CLI会自动完成登录；若仍未退出等待状态，手动中断（Ctrl+C），再运行codex login status验证。
命令根本不存在？从安装层开始挖
① 执行npm install -g @openai/codex确保安装完成；
② 运行npm list -g @openai/codex，如果输出empty，说明全局安装失败；
③ 查npm root -g路径，Windows用户检查该路径是否已加入系统环境变量PATH，Mac/Linux用户确认shell配置文件（如~/.zshrc）里是否导出了该路径；
④ 【最关键的一步】关闭所有终端窗口，重新打开一个新的终端再试——旧终端不会自动继承新添加的环境变量。
