文档中心

Codex CLI 历史会话恢复命令:codex resume

发布时间: 2026-02-19 · 更新于: 2026-11-01

讲清 codex resume 的作用、基本用法、常见使用场景与恢复历史会话的注意事项,帮助你快速找回上下文并继续之前未完成的任务。

在 Codex CLI 里,查看和恢复历史对话通常有两种入口。先用帮助命令确认当前版本支持的写法:

codex --help
codex resume

如果 Codex 已经启动,也可以直接在输入框输入:

/resume

这个命令能做什么

  • 列出可恢复的历史会话
  • 选择一个会话继续对话
  • 减少重复描述上下文的时间

基本用法

codex resume

执行后通常会进入会话选择流程,选择会话后即可继续。若当前版本要求附加参数,以 codex resume --help 的输出为准。

恢复前后的建议

恢复会话后,先让 Codex 总结当前上下文,再继续执行具体任务:

请先总结当前会话的目标、已经完成的改动、未解决问题和下一步建议,不要修改文件。

确认总结与预期一致后,再让它继续操作。这样可以减少恢复到错误会话或遗漏上下文的风险。

典型使用场景

  1. 昨天做到一半的任务,今天继续。
  2. 复用之前已经整理好的项目上下文。
  3. 回看某次会话中的关键结论。

常见问题

没看到历史会话怎么办?

先确认你是在同一台机器、同一用户环境下运行 CLI,并且之前确实有本地会话记录。

恢复后上下文不完整怎么办?

可以在恢复后先补一条总结指令,例如让它先总结当前会话状态,再继续执行任务。

切换 Provider 后还能恢复吗?

这取决于当前客户端如何保存和识别会话。切换授权方式后,如果列表为空,先恢复原来的 Provider 或账号确认数据是否存在,再按当前版本文档处理迁移,不要直接删除本地配置目录。

常见问题

codex resume 和 /resume 有什么区别?

终端命令 codex resume 用于启动恢复流程;如果 Codex 已经运行,可以在输入框中输入 /resume,再按回车。具体命令以当前 CLI 版本的 --help 输出为准。

为什么看不到以前的会话?

先确认使用的是同一台电脑、同一用户和同一数据目录,再确认之前确实使用当前 CLI 保存过本地会话。切换 Provider 或授权方式后,历史会话可能不会出现在当前列表中。