Codex CLI Resume:继续之前的终端会话
学习用 codex resume、codex resume --all 和 codex resume --last 重新打开本地保存的 Codex CLI 会话,避免重复解释上下文。
适用场景
当你昨天让 Codex 查过一个 bug,今天想继续修;或者一个长任务还没结束,但你不想重新解释项目背景,就可以使用 codex resume。
官方 CLI features 页面说明,Codex 会在本地保存 transcripts,因此可以重新打开早前的终端会话。
基本命令
在项目目录运行:
codex resume
Codex 会显示最近的交互式会话列表。选中一个会话后按 Enter,即可回到当时的对话上下文。
如果想查看不属于当前工作目录的会话:
codex resume --all
如果想直接打开当前目录最近一次会话:
codex resume --last
如果要忽略当前目录限制,打开全局最近一次:
codex resume --last --all
步骤 1:先确认目录
resume 前先运行:
git status
确认你在正确仓库,并且知道当前工作区是否有未提交改动。
如果目录不对,codex resume 可能看不到你想要的会话,或者继续到错误项目里。
步骤 2:恢复后校准上下文
打开旧会话后,不要立刻让 Codex 继续写文件。先让它重新校准:
请根据当前仓库状态、git diff 和最近这段会话,总结我们上次做到哪里。先不要修改代码。
如果项目文件已经变化,再补一句:
请重新读取相关文件,确认旧结论是否仍然成立。
步骤 3:继续任务
确认上下文无误后,再继续:
请继续修复上次发现的测试失败,只改相关文件。完成后运行对应测试。
这样可以避免 Codex 基于过期 transcript 做出错误修改。
什么时候不要 resume
下列情况建议新开会话:
- 旧任务已经完成,新任务目标完全不同。
- 旧会话里混入了很多实验性方向。
- 仓库已经大幅重构。
- 你希望 Codex 从干净上下文重新分析。
resume 适合连续任务,不适合把所有工作都塞进一个长期会话。
常见错误
不要把 resume 当成版本控制。代码状态仍然以 git 和文件系统为准。
不要继续一个上下文很乱的旧会话。重新开一个更干净的任务往往更快。
不要忽略目录过滤。找不到会话时先试 codex resume --all。
小结
codex resume 的价值是延续上下文,但继续前要重新确认当前仓库状态。稳妥流程是:进入正确目录、查看 git status、resume、让 Codex 总结旧进度并重新读取关键文件,再继续修改。
相关教程
常见问题
resume 会自动恢复仓库当前状态吗?
resume 会重新打开之前的 transcript,但仓库文件可能已经变化。继续重要任务前,应让 Codex 重新检查关键文件和 git diff。
codex resume --all 和普通 resume 有什么区别?
普通 resume 通常按当前工作目录筛选最近会话;`--all` 会显示不限当前目录的本地会话。