展开本页目录
开始前准备什么
- 自己的 Codex 版本、错误全文和会话记录。
- 可检查差异的 Git 工作目录，任务开始前已保留原状态。
- 有权读取目标日志；公开问题前删除 Key、客户数据与私有地址。
- 保存错误
- 核对差异
- 区分原因
- 恢复剩余步骤
- 独立验收
保存已完成操作、未知状态、剩余步骤与独立验收。
先判断停在模型请求还是本地工具
| 观察 | 核对位置 | 处理 |
|---|---|---|
| permission denied / 命令被拒绝 | 本地工具与执行规则 | 核对工作目录和授权范围 |
| 401 / provider 错误 | 认证、provider、精确型号 | 先修复最小请求 |
| stream interrupted / timeout | 请求日志与会话事件 | 结果未知，先查已执行步骤 |
| 测试失败 | 测试输出与文件差异 | 保持原断言，修复实现后再测试 |
- 观察
- permission denied / 命令被拒绝
- 核对位置
- 本地工具与执行规则
- 处理
- 核对工作目录和授权范围
- 观察
- 401 / provider 错误
- 核对位置
- 认证、provider、精确型号
- 处理
- 先修复最小请求
- 观察
- stream interrupted / timeout
- 核对位置
- 请求日志与会话事件
- 处理
- 结果未知，先查已执行步骤
- 观察
- 测试失败
- 核对位置
- 测试输出与文件差异
- 处理
- 保持原断言，修复实现后再测试
先做这四个只读检查
在原工作目录运行下面命令，核对改过哪些文件、是否出现意外新增文件、当前客户端版本。git diff 默认不包括未跟踪文件，所以需要一起看 status。
不要先丢弃修改、删除会话或把整个任务重新发一遍。若包含提交、邮件、支付或发布等外部写入，还要单独检查目标系统状态。
bash
codex --version
git status --short
git diff --stat
git diff -- path/to/target-file
本站绘制的内容说明图：中断不等于修改全部丢失；此页先检查实体和差异，保留共享工作区已完成部分。
恢复会话时，把现状告诉 Codex
先运行 codex resume --help 核对已安装版本，再使用 codex resume 从列表选择原会话。exec 工作流用 codex exec resume --help 查对应语法，不能把交互式参数混进去。
恢复说明写明已修改文件、已通过测试、仍失败的步骤，以及不能重复的外部操作。会话恢复不会自动证明之前每个步骤成功，恢复后仍需独立验收。
text
任务因工具执行失败中断。请先读取现状并继续剩余步骤。
已完成：目标实现修改；尚未完成：独立测试与差异核对。
保持测试文件不变，只处理目标实现。
不要重复之前的外部发布或提交；执行前核对状态。
本站绘制的内容说明图：恢复命令与任务补充针对原会话；模型叙述完成不能替代测试，也不能授权重复外部动作。
实际案例：工具受阻以后仍要验收结果
已有 Codex 仓库案例记录了一个缓存清理命令被本地执行规则拒绝，随后在隔离目录内改用允许的操作继续任务。它属于本地工具问题，不能归因到 API 不可用。
最终结果由独立复跑的五项测试与差异核对确认，而不是只看 Codex 的完成消息。新页面没有追加在线调用或新的费用观察。
断流后，先查原请求再决定重发
记录任务时间、准确模型 ID、状态码和可用的请求 ID，在控制台核对对应记录。任务可能包含多个模型请求；只看最后一条无法统计完整费用。
减小上下文、限制并行或调整超时前，先确定具体失败阶段。关闭自动重试可以减少重复提交，但不能保证超时请求未执行，也不是费用上限。
怎样确认已经完成
- 错误、时间与会话已保留，公开记录已脱敏。
- 目标文件与未跟踪文件均已核对。
- 恢复只处理未完成步骤，外部写入未盲目重复。
- 独立测试和人工 diff 确认最终结果。
常见问题
直接换 API 能解决所有中断吗？
不能。本地执行权限、错误命令、测试失败和客户端问题要分别处理；先明确失败阶段。
resume 会再次收费吗？
继续会话可能产生新的模型请求。先核对已有请求与账单，记录恢复产生的全部用量和费用。