先区分三种“卡住”
- 等待审批/工具结果：界面有等待确认、运行命令或写文件的提示。它不是网络断线，先完成或拒绝审批。
- 正在重连或服务端等待：能看到
Reconnecting、429、503 等字样。按重连排查和错误码表处理。 - 本地界面/会话状态异常：按钮无反应、提交失败、窗口卡白，但新会话可以工作。先保留输入和工作目录，不要直接清空配置。
五步快速排查
- 先看是不是在等审批：工具调用、文件写入或网络访问可能停在等待确认；完成或拒绝后，回到会话观察是否继续。若没有任何审批提示，再继续下一步。
- 验证本地终端和磁盘：开一个新的终端窗口，运行
pwd、git status，并确认磁盘没有满。如果命令本身都卡住，先处理终端、磁盘、权限或网络，不要重复发送同一条消息。 - 用短请求和新会话做对照：先发一句不涉及代码的短问题。短请求能返回，通常是原任务上下文过大、某个工具调用或项目文件导致；短请求也失败，才更像连接、登录或服务端问题。新会话正常不代表旧任务已完成，先保存原任务内容。
- 更新并完全重启：保存未发送的文字，升级到稳定版本，退出应用（不是只关窗口）后再打开。仍无响应时切换到新会话测试。不要因为界面暂时空白就删除
.codex目录，也不要先删auth.json。 - 最后再看日志并做最小复现：macOS 日志通常在
~/Library/Logs/com.openai.codex/YYYY/MM/DD，会话记录在$CODEX_HOME/sessions。记录“打开应用 → 进入项目 → 发送短请求 → 卡住”的时间线，能帮助判断是界面、项目还是网络问题。
什么时候可以重试，什么时候应停止
- 只有一次短暂超时：等待后重试一次即可。
- 连续出现相同的 429/503：停止连点，按
Retry-After或逐步退避等待；继续狂点只会延长限流。 - 官方会话和中转都失败：先检查网络、系统时间、代理和状态页，再考虑登录/配置问题。
- 只有一个项目卡住：用空目录或新会话做对照，检查项目是否有巨大的日志、递归目录或异常 MCP/脚本；不要先删除项目文件。
如果错误是反复 Reconnecting，可先看这篇连接排查。如果是 capacity、429 或 503，按常见报错表处理。持续失败时，向 OpenAI 帮助中心提供完整错误、客户端版本、模型、时间和请求 ID；分享日志前删掉代码、路径、邮箱、token、API Key、代理密钥和 auth.json 内容。
参考：Codex 故障排除。