Codex 历史任务未显示通常因索引损坏或路径配置问题,而非数据丢失;可直接访问本地 sessions/ 文件夹查看 JSONL 文件,或用 codex-history 命令行工具筛选恢复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想在 Codex 里找回上周调试失败的 Python 脚本生成任务,或者翻出三天前让 AI 重写过的 README.md 内容,但左侧边栏历史对话列表空荡荡——这通常不是数据丢了,而是索引没加载或路径没对上。
确认历史任务是否还在本地
先别急着重做,打开文件资源管理器,直接访问:【C:\Users\你的用户名\.codex\sessions\】(Windows)或 【~/.codex/sessions/】(macOS/Linux)。
这个文件夹里按年/月/日分层存放所有未归档会话的 rollout 文件,每个 .jsonl 文件就是一个完整的历史任务。只要它还在,内容就完好无损。
如果该目录下完全为空,说明你可能开启了 disable_response_storage = true,或曾手动清空过 .codex 目录——这种情况下,任务确实已不可恢复。
Windows 版:从侧边栏直接查看
点击左侧边栏底部的「历史对话」项,列表默认按时间倒序排列,最新任务在最上方。
若列表为空但 sessions/ 文件夹有内容,大概率是 【session_index.jsonl 索引文件损坏或未更新】。此时可尝试重启 Codex Desktop,或运行 codex-history doctor 检查索引状态。
滚动到底部会自动加载更多条目,但不支持分页跳转;列表只显示标题和简略时间,不展示内容预览。
Mac 版:用 Filter 快速筛选旧任务
方法一:快捷键触发
聚焦主窗口 → 按 ⌘ + F → 输入关键词(如“Dockerfile”“React 组件”)→ 实时高亮当前打开的对话内容;若要跨对话搜索,必须先点左上角「All Threads」再按 ⌘ + F。
方法二:侧边栏过滤
点击左侧 Threads 列表顶部的「Filter」→ 选择「Contains text」→ 输入词 → 点击「Apply」。该过滤器仅保留含关键词的对话条目,【关闭 Filter 后不会自动恢复原始排序】,需手动点「Clear filter」才能回到全量列表。
命令行方式:精准定位某次任务
第一步:列出最近 10 条未归档会话codex-history list --limit 10
第二步:按关键词筛选(比如找所有含 “API” 的任务)codex-history list --grep "API"
第三步:根据返回的 short-id 恢复指定任务codex resume 019e3431(ID 截取前 8 位即可)
这一步能绕过 UI 层索引问题,直接从 sessions/ 文件读取原始数据并重建会话上下文,适合索引失效时紧急调用。


















