codex 提供三种任务恢复方式:一是用 codex resume 列出并选择历史会话,但默认仅保留7天未活跃会话;二是用 codex --continue 秒级恢复上一会话,依赖 latest.json 指针;三是通过 handoff.md 文档手动重建,需包含目标、当前状态、已验证事实、已排除路径、下一步动作、失败约束六项内容。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当你在 Codex 中执行一个耗时任务(比如分析日志、重构模块、调试接口),中途因会议、通勤或系统休眠被迫中断,但又不想丢失已查的文件路径、已排除的错误原因、已运行的关键命令和当前决策逻辑——这时必须靠 Codex 的历史任务恢复机制,而不是重新描述一遍上下文。
用 codex resume 列出并选择会话
打开终端,进入项目根目录,直接运行:
codex resume
这会拉出所有保存过的会话摘要列表,每条记录包含时间戳、初始指令关键词和最后交互时间。Codex 默认只显示最近 10 条,但实际会话可能更多。
如果列表里没有你要找的那条,说明它可能被自动清理了——【Codex 默认只保留最近 7 天未活跃的会话】。超过这个时限,除非你手动导出过 session 文件,否则无法通过 resume 找回。
用方向键高亮目标会话,按回车即可加载完整上下文,包括已读文件内容、工具调用输出、中间变量状态和未完成的待办清单。
用 codex --continue 快速续跑上一次会话
如果你刚退出不到 5 分钟,且没启动过其他 Codex 会话,可以直接运行:
codex --continue
这条命令不展示列表,而是跳过选择环节,直接恢复上一次关闭前的会话。它依赖本地 .codex/sessions/ 目录下的 latest.json 指针文件,所以只要该文件没被清理或覆盖,就能秒级复原。
注意:如果在这期间你启动过另一个 Codex 任务,latest.json 就会被更新为新会话,此时 --continue 将指向错误的上下文。
从 Handoff 文档手动重建任务状态
当 resume 和 --continue 都失效(比如跨设备、重装系统、会话被手动删除),唯一可靠的方式是读取你写过的 Handoff 记录。
第一步:找到项目根目录下的 HANDOFF.md 或 ./codex/handoff/ 目录
第二步:确认其中是否包含以下六项关键信息——目标、当前状态、已验证事实、已排除路径、下一步动作、失败约束
第三步:新建会话,把整段 Handoff 内容粘贴为第一条消息,末尾加上“请基于此继续执行”
Handoff 不是备忘录,它是给下一个执行者(无论是人还是 AI)的最小可执行说明书。缺少“已排除路径”或“失败约束”,新会话极大概率会重复踩坑;漏掉“当前状态”,AI 可能误判任务进度,从头开始扫描代码。
如果 HANDOFF.md 为空或缺失,说明上次中断时没写 Handoff。此时你只能靠 git diff 查变更、靠 terminal history 翻命令、靠编辑器打开的文件判断断点——这些操作无法还原决策过程,只能重建部分技术状态。











