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

图:本站根据 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 官方文档:Slash commands 与排查指南整理的示意图
四、找不到旧会话时的五个排查点
- 换了启动目录:
codex resume --last默认只认当前目录,加上--all再试一次。 - 会话被归档了:桌面端去 设置(Settings)> 已归档对话(Archived chats) 点取消归档(Unarchive);CLI 运行
codex unarchive <SESSION>恢复。 - 之前跑脚本加了
--ephemeral:非交互模式传入--ephemeral时不会把会话文件写盘,跑完即焚。 history.persistence被设成了"none":检查用户级与托管级配置是否关闭了持久化。- 登错了账号或工作区:个人 Plus/Pro 工作区与公司 Business 工作区的云端记录彼此独立。如果团队多人开发需要独立工作区和集中管理,可了解本站 ChatGPT Business 团队版定制;个人续费或升级可看 ChatGPT Plus 充值说明。
常见问题
问:恢复旧会话后,之前消耗的上下文 token 还在吗?
答:在。恢复会把之前的对话记录重新带入上下文,如果原会话已经很长,接着聊之前可以先跑一次 /compact 压缩历史,省额度也更快。
问:桌面端的「锁定对话(Locked chats)」支持本地 Codex 会话吗?
答:官方《Projects and chats》明确说明,PIN 码锁定对话仅支持符合条件的云端 Chat 和 Work 对话,不支持本地 Work 与本地 Codex 会话。
问:已经执行 /delete 或在已归档列表点垃圾桶删掉的对话还能恢复吗?
答:不能。官方写明永久删除后的会话无法通过界面、API 或联系客服找回。
相关教程
- Codex 怎么删除对话、清理任务
- Codex 命令行常用命令一页看
- Codex config.toml 完整详解
- Codex VS Code 提示「This is open in another app」怎么办
参考资料
- 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
0 条评论
还没有评论,来抢沙发~