Codex CLI

Codex CLI Resume:继续之前的终端会话

学习用 codex resume、codex resume --all 和 codex resume --last 重新打开本地保存的 Codex CLI 会话,避免重复解释上下文。

CodexCLIResume会话管理

适用场景

当你昨天让 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` 会显示不限当前目录的本地会话。