Codex报错应先执行codex --debug info检查config_path、auth_status、network_mode三项是否全为valid，任一标red或missing即说明问题在底层环境而非代码逻辑，须按安装/命令→配置→鉴权/网络→沙盒权限五层顺序排查，避免无效重试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex报错后想彻底避开同类问题，不能只靠重试或重装，必须定位到具体出错层级并固化验证动作。很多用户改完配置就以为结束，结果下次更新又复现，是因为没把修复动作和校验步骤绑定成闭环。
先锁定错误属于哪一层
打开终端，执行 codex --debug info，观察输出中 【config_path】、【auth_status】、【network_mode】 三项是否全部显示为 valid。只要其中一项标 red 或 missing，就说明问题不在模型或代码逻辑，而在底层环境——此时跳过所有代码修改类操作，直接进入对应层排查。
这一步漏掉，后面所有修正都是在错误前提下做无用功。
安装与命令层：验证 codex 是否真正可调用
① 在任意目录下运行：which codex（macOS/Linux）或 where codex（Windows CMD）；
② 若无输出或提示“not found”，说明全局命令未注册成功；
③ 不要直接重装，先检查 npm 全局路径：npm config get prefix，确认该路径是否已加入系统 PATH；
④ 若已加入但 still not found，请关闭所有终端窗口，重新打开一个干净终端再试——旧终端不会自动继承新 PATH 变量。
配置层：快速识别损坏的 config.toml
方法一：用终端一键检测语法有效性
进入 ~/.codex/（macOS/Linux）或 C:\Users\YOUR_USER_NAME\.codex\（Windows），运行：tomlcheck config.toml。若报错行号明确指向某一行，大概率是引号用了中文全角、键名拼错、或嵌套层级错位。
通过 codex-reset-radar.pages.dev 监控 Codex 使用重置窗口。轮询 current.json，检测窗口开启/关闭、预测等级变化以及概率跳变。
方法二：临时绕过配置启动
执行：codex --config /dev/null --no-config new（macOS/Linux）或 codex --config NUL --no-config new（Windows）。如果此时能正常新建会话，就【100%确认是 config.toml 文件损坏】，不是权限也不是网络问题。
鉴权与网络层：区分真实失败和假性超时
执行：codex --debug network ping，等待 8 秒。若返回 status: ok 但耗时 >5s，说明连接通但延迟高；若返回 timeout 或 connection refused，则需检查代理设置。
特别注意：如果你开了本地代理（如 Clash、Surge），请确认 ~/.codex/.env 中的 http_proxy 值是否为 HTTP 类型地址。WebSocket 连接失败常因误配 SOCKS5 代理导致，而 CLI 默认不报具体协议错误。
验证代理是否生效的最简方式：在同终端运行 curl -v https://api.openai.com/v1/models，看是否返回 200。不通过 Codex 走，直接测底层链路。
沙盒与权限层：Windows 用户必查项
打开 config.toml，搜索 sandbox =。如果值为 "elevated"，且你日常使用普通用户权限的 PowerShell 或 CMD 启动 Codex，就会触发 Failed to setup admin sandbox 报错。
直接改为：sandbox = "unelevated"，保存后重启 Codex 客户端。这步改完无需管理员权限即可运行，也避免了每次弹窗申请提权。
注意：不要手动删 auth.json 或清空整个 .codex 目录——那会丢失登录状态和历史会话索引，属于过度操作。
