Codex 历史会话在哪、怎么恢复:codex resume、/resume 与本地存储位置详解

退出终端后想接着上次的 Codex 对话继续写?按官方文档整理:本地转写默认存在 ~/.codex/sessions,终端用 codex resume 或会话内 /resume 恢复,跨目录要加 --all,附分叉对话与找回归档会话步骤。

NNathaniel bigo··原创首发·AI 辅助撰写
11 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 Plus 账号

结论先说

  1. 本地历史默认存在 $CODEX_HOME/sessions(即 ~/.codex/sessions),已归档会话存在 ~/.codex/archived_sessions,输入历史配置由 config.toml 的 [history] 表控制。
  2. 终端外恢复用 codex resume:直接敲 codex resume 打开会话选择器;敲 codex resume --last 直接恢复当前目录最近一条;跨目录找最近一条必须加 --all。
  3. 会话内切换用 /resume:在输入框敲 /resume 回车,可在当前目录(Cwd)、关联工作树仓库(Repo)或全部目录(All)三档范围里挑旧会话加载。
  4. 想保留原记录另试新思路,用 codex fork 或 /fork,它会克隆出一份新 ID 的会话,不破坏原对话上下文。
  5. 非交互脚本也能接续:两阶段流水线用 codex exec resume --last "下一步指令" 或指定会话 ID 继续执行。

Codex 各端找回与恢复旧会话的方法

图:本站根据 Codex 官方文档:Command line options 整理的示意图

本文根据 Codex 官方文档《Command line options》《Slash commands in Codex CLI》《Projects and chats》与《Sample Configuration》整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。如果你想清理或永久删掉旧记录,请看 Codex 怎么删除对话、清理任务。

适用于谁

  • 关掉终端窗口或重启电脑后,想接着上一轮 Codex CLI 会话继续改代码的人;
  • 想知道 Codex 的本地聊天记录到底存在硬盘哪个文件夹、怎么关掉本地落盘的人;
  • 运行 codex resume --last 却提示没找到刚才那条对话,不知道卡在哪一步的人。

一、历史会话文件存在哪、怎么管开关

按官方配置与排查文档,Codex CLI 的本地记录默认放在 CODEX_HOME(未手动设环境变量时就是用户主目录下的 ~/.codex):

  • 活动会话转写:~/.codex/sessions;
  • 已归档会话转写:~/.codex/archived_sessions;
  • 命令与输入历史:受 ~/.codex/config.toml 里的 [history] 表控制(完整配置结构见 Codex config.toml 完整详解)。

在 config.toml 里可以调整是否落盘和体积上限:

toml
[history]
persistence = "save-all"   # 默认 save-all;设为 "none" 则不保存本地历史
max_bytes = 5242880        # 历史文件最大字节数,超出后自动裁剪最旧记录

注意在 Windows 上,如果你一会儿在 PowerShell 跑原生 CLI、一会儿进 WSL 跑 Linux 版 CLI,两边各自读写 Windows 用户目录和 WSL 家目录下的 .codex,历史列表互不相通。

二、在命令行 CLI 里恢复与管理旧会话

1. 启动时直接恢复:codex resume

还没进交互界面时,直接在终端运行:

bash
codex resume                      # 打开交互式选择器挑选旧会话
codex resume --last               # 直接恢复当前工作目录下最近一次会话
codex resume --last --all         # 跨所有目录恢复最近一次会话
codex resume <SESSION_ID>         # 按指定会话 ID 精确恢复

官方说明,codex resume 允许你在恢复时顺手覆盖模型或沙箱参数(例如加 -m gpt-6.2-sol),但不支持与 --worktree 同时使用。

如果你当前所在的文件夹和那条会话当初保存的目录不一致,Codex 会弹窗问你用哪个目录。嫌每次被问麻烦,可以在 ~/.codex/config.toml 的 [tui] 表下固定默认行为:

toml
[tui]
resume_cwd = "session"   # 固定切回会话原目录;写 "current" 则留在当前目录

命令行显式传入的 --cd(或 -C)优先级高于 tui.resume_cwd。

2. 已经在 TUI 会话里:/resume、/agents 与 /rename

不想退出重进时,直接用斜杠命令(全部命令见 Codex 命令行常用命令一页看):

  • /resume:打开选择器,先切搜索范围——Cwd(当前目录)、Repo(含关联 Git 工作树的同仓库目录)、All(所有目录),再回车加载对应记录;
  • /agents(或终端跑 codex agents):打开代理命令中心,按 F3 或 / 输入会话名、提示词片段或工作目录关键字(不区分大小写)快速检索老对话;
  • /rename <新名字>:给当前会话起个好认的名字(如 /rename auth-bugfix),省得以后在一堆默认标题里翻找;
  • /app:在 macOS 和 Windows 上把当前 CLI 会话直接转到 ChatGPT 桌面端接着聊;
  • /export session.md:把整段对话导出成 Markdown 文件留档。

3. 想分叉试别的改法:codex fork 与 /fork

有时上次改到一半想换条技术路线,又怕把原记录冲掉。在会话内输 /fork,或在终端运行 codex fork --last(支持 codex fork <SESSION_ID> --worktree 直接分叉进新工作树),Codex 会把原对话完整复制到一个新会话 ID 下继续。

三、桌面端、网页版与 IDE 扩展去哪找历史

  • ChatGPT 桌面端:左侧边栏和 项目(Projects) 视图集中展示云端与本地项目对话。点侧边栏的 搜索对话(Search chats) 可以按正文词句或分支名检索(可在 设置(Settings)> 键盘快捷键(Keyboard Shortcuts) 给搜索绑快捷键);常用的对话或项目支持置顶(Pin)。
  • 网页版 ChatGPT Work:进对应项目的 对话(Chats) 栏查看,或按 Ctrl+K(macOS 按 Cmd+K)全局搜索;被归档的去 设置(Settings)> 数据控制(Data Controls)> 已归档对话(Archived chats) 恢复。
  • IDE 扩展(VS Code 等):打开对应工作区文件夹后,在面板的 近期对话(Recent chats) 列表点选继续。若遇到同会话在桌面端占用的提示,处理方法见 Codex VS Code 提示「This is open in another app」怎么办。

Codex 找不到旧会话时的排查顺序

图:本站根据 Codex 官方文档:Slash commands 与排查指南整理的示意图

四、找不到旧会话时的五个排查点

  1. 换了启动目录:codex resume --last 默认只认当前目录,加上 --all 再试一次。
  2. 会话被归档了:桌面端去 设置(Settings)> 已归档对话(Archived chats) 点取消归档(Unarchive);CLI 运行 codex unarchive <SESSION> 恢复。
  3. 之前跑脚本加了 --ephemeral:非交互模式传入 --ephemeral 时不会把会话文件写盘,跑完即焚。
  4. history.persistence 被设成了 "none":检查用户级与托管级配置是否关闭了持久化。
  5. 登错了账号或工作区:个人 Plus/Pro 工作区与公司 Business 工作区的云端记录彼此独立。如果团队多人开发需要独立工作区和集中管理,可了解本站 ChatGPT Business 团队版定制;个人续费或升级可看 ChatGPT Plus 充值说明。

常见问题

问:恢复旧会话后,之前消耗的上下文 token 还在吗?

答:在。恢复会把之前的对话记录重新带入上下文,如果原会话已经很长,接着聊之前可以先跑一次 /compact 压缩历史,省额度也更快。

问:桌面端的「锁定对话(Locked chats)」支持本地 Codex 会话吗?

答:官方《Projects and chats》明确说明,PIN 码锁定对话仅支持符合条件的云端 Chat 和 Work 对话,不支持本地 Work 与本地 Codex 会话。

问:已经执行 /delete 或在已归档列表点垃圾桶删掉的对话还能恢复吗?

答:不能。官方写明永久删除后的会话无法通过界面、API 或联系客服找回。

相关教程

参考资料

  • Codex 官方文档:Command line options — https://learn.chatgpt.com/docs/developer-commands
  • Codex 官方文档:Slash commands in Codex CLI — https://learn.chatgpt.com/docs/reference/slash-commands
  • Codex 官方文档:Projects and chats — https://learn.chatgpt.com/docs/projects
  • Codex 官方文档:Sample Configuration — https://learn.chatgpt.com/docs/config-file/config-sample

Nathaniel 的更多内容

  1. 01

    LangGraph 流式输出(Streaming)详解:逐字 Token 流、节点进度与自定义事件写法

    多步智能体如果等全部节点跑完才返回,网页前端就会白屏干等十几秒。本文按 LangGraph 官方文档讲清 updates、messages、custom 与 values 四种 stream_mode 的区别,以及组合订阅逐字打字机输出加工具内部实时进度的完整代码。

    其他 AI 工具0
  2. 02

    LangGraph 持久化与长期记忆怎么配:Checkpointer、Store 与 PostgreSQL 实战

    在生产环境跑 LangGraph,单靠 InMemorySaver 一重启就会丢失全部对话。本文按官方文档讲清线程内短期检查点(Checkpointer)与跨线程长期记忆(Store)的分工,以及用 langgraph-checkpoint-postgres 对接 PostgreSQL 的完整步骤。

    其他 AI 工具0
  3. 03

    LangGraph 多智能体怎么写:Supervisor 主管包与 Subgraph 隔离子图实战

    在 LangGraph 里把单个图扩展成多智能体协作有两条官方路线:快速原型用预置包 langgraph-supervisor,大型生产系统用原生子图(Subgraph)嵌套。本文讲清两种写法的完整代码、私有状态隔离防 Token 膨胀技巧以及检查点传播规则。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入审批怎么写:interrupt 暂停图运行与 Command 恢复实战

    企业之所以选 LangGraph,很大程度看中它能安全挂起等待人工审批(Human-in-the-Loop)。本文按官方最新规范讲清 interrupt() 动态暂停、Checkpointer 必备条件、Command(resume=...) 恢复执行,以及防止副作用重复运行的重入规则。

    其他 AI 工具0
  5. 05

    多 Agent 协作平台怎么选:Dify、扣子(Coze)、n8n 与 LangGraph 多智能体机制对比

    搜「多agent协作平台」时,Dify、扣子、n8n 和 LangGraph 都宣称支持多智能体,但底层的调度方式完全不同。本文跳过基础安装,专门从多 Agent 角色跳转、子代理工具调用、上下文隔离与私有化部署四个维度帮你一次选准。

    其他 AI 工具0
  6. 06

    企业微信有官方 MCP 和 CLI 吗:@wecom/cli 安装初始化、长连接机器人与接入教程

    搜「企业 微信 有 mcp 吗」不用再东拼西凑民间群机器人脚本了:企业微信官方已推出 @wecom/cli 命令行工具并内置 stdio 模式的 MCP Server。本文按官方开发者文档讲清安装、智能机器人长连接初始化、业务命令与接入 Claude Code 步骤。

    Claude其他 AI 工具0

同产品的其他教程

  1. 01

    AutoGen 现在怎么样了?微软官方演进路线与 Microsoft Agent Framework 入门

    搜 AutoGen 新教程常被 0.2、0.4、社区分支和 Semantic Kernel 绕晕。按微软官方文档,微软已将 AutoGen 与 Semantic Kernel 两支团队合并推出统一的开源框架 Microsoft Agent Framework。本文讲清现状与 Python 快速上手。

    ChatGPT其他 AI 工具0
  2. 02

    多 Agent 的成本为什么翻倍、怎么控制:Token 膨胀根源与五项降本措施

    刚把单智能体拆成多 Agent,用量往往暴涨好几倍。Anthropic 工程报告统计单智能体约为聊天的 4 倍 Token,多智能体可达约 15 倍。本文拆解固定前缀重复加载、历史搬运、工具链定义与缓存失效四大根源,并给出五条实操控费办法。

    ChatGPTClaude0
  3. 03

    多 Agent 协同开发怎么落地:「一个写、一个审」双代理工作流搭建指南

    多 Agent 协同开发里投入产出比最高的模式就是「一个写、一个审」。本文依据 Anthropic 与 OpenAI 官方编码最佳实践,讲清为什么同会话自审容易漏问题,以及用只读子代理、跨模型交叉审查(Claude Code + Codex)和自动化闭环落地的具体方法。

    ClaudeCodex0
  4. 04

    多 Agent 编排模式详解:编排者-工作者、交接(Handoffs)、并行与评估循环怎么选

    搜「multi-agent orchestration 中文」会被各家框架的不同术语绕晕。本文对照 Anthropic《Building effective agents》与 OpenAI 智能体指南,把编排者-工作者、去中心化交接、并行分片投票与生成-评估循环四种标准编排拓扑讲透。

    ChatGPTClaude0
  5. 05

    多智能体(Multi-Agent)是什么、什么时候该用:Anthropic 与 OpenAI 官方判断标准

    多智能体不是代理越多越聪明。本文依据 Anthropic 研究系统架构文章与 OpenAI 官方智能体指南,讲清确定性工作流、单智能体与多智能体的区别,以及哪三类瓶颈才值得上多智能体协同。

    ChatGPTClaude0
  6. 06

    codebase-memory 类 MCP 是什么、怎么用:基于语法树图谱的本地代码索引原理与配置

    codebase-memory-mcp(DeusData/codebase-memory-mcp)是一类本地代码图谱 MCP 服务器:用 Tree-sitter 把仓库解析成函数与调用关系的 SQLite 图库,帮编码助手查调用链并省下读整份文件的额度。

    ClaudeCodex0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~