应先执行 /models 命令定位故障：用 node llm-api-doctor.mjs --base-url URL 探测鉴权、路径、限流、上游或网络问题，依据 classification 字段快速归因，而非直接重装或换密钥。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在使用 Codex 时突然弹出报错，比如连接失败、超时、401、404、429、502 或反复显示 “reconnecting”，第一反应不该是重装或换 Key，而是要快速判断：问题出在你本地电脑上，还是服务端那边挂了。这一步判错了，后面所有操作都白忙。
先跑一条 /models 命令定位故障环节
准备好 Node.js 20+ 环境后，在终端执行：
node llm-api-doctor.mjs --base-url https://api.example.com/v1
这条命令会向你配置的 Base URL 发起 GET 请求，目标地址自动拼为 https://api.example.com/v1/models，只探测接口连通性与基础鉴权，不发提示词、不执行代码、不修改任何配置。
输出中的 classification 字段就是核心判断依据：如果返回 auth_failed，说明密钥无效或未传；endpoint_not_found 指 Base URL 路径错误（比如漏了 /v1）；rate_limited 对应 429；upstream_error 表明服务端异常；network_timeout 或 dns_failure 则基本锁定本地网络或代理问题。
注意：工具默认从 LLM_API_KEY 环境变量读密钥，若你用的是 OPENAI_API_KEY，需显式加参数：--key-env OPENAI_API_KEY。
看报错是否复现于多个客户端
打开浏览器，手动访问 https://api.example.com/v1/models（把 Base URL 替换为你实际配置的地址），带上 Authorization 头：Bearer YOUR_API_KEY。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
如果浏览器也返回相同状态码（如 401/404/429），那基本可排除 Codex 本地逻辑问题，属于服务端或密钥层故障。
如果浏览器能正常返回模型列表，但 Codex 仍报错，说明问题一定在本地——可能是代理没透传、证书被拦截、环境变量未生效，或 .codex/config.toml 里写死了错误的 provider 名称。
检查本地进程与沙箱状态
第一步：确认 app-server 进程是否存活。
Windows 用户打开任务管理器 → 详细信息页 → 查找 codex.exe 或 app-server 进程。若完全找不到，或进程存在但 CPU 占用为 0、内存恒定在 12KB 左右，说明后台服务根本没起来。
第二步：运行 codex login status，观察输出中 auth_status 和 sandbox_mode 字段。
若显示 sandbox initialization failed 或 unable to set admin sandbox，大概率是 config.toml 文件损坏，【不要改 Key，先删 config.toml】，重命名备份后重启 Codex 即可恢复。
第三步：检查安全软件日志。Windows Defender 或火绒常静默拦截 codex.exe 创建子进程，现象是点 Reload 后进程一闪即逝，无弹窗提示。临时关闭实时防护后重试，若恢复正常，需将 .codex 目录加入信任列表。
