Codex 的本地会话记录，通常可以通过四种方式查看：使用 CLI 命令 codex resume 列出当前 provider 下的会话；进入 ~/.codex/sessions/ 目录直接查看保存完整历史的 JSONL 文件；借助 codex-sessions 进行关键词检索与快速定位；或者直接使用 History Manager，在可视化界面中统一浏览和管理会话。
如果你想在 Codex 中快速找回上周调试接口时的那条会话，查看完整对话内容、时间戳以及对应文件路径，而不是靠记忆去翻 UUID，或不停点击“加载更多”，其实这些本地会话记录一直都在，只是默认没有直接展示给用户。
用 Codex CLI 列出所有会话
打开终端，进入任意项目目录或用户主目录，执行：
codex resume
执行后会显示一个纯文本会话列表，通常按时间倒序排列。每一行都包含会话 ID、创建时间、标题片段（如果你曾设置过）以及工作目录的缩略路径。需要注意的是：这个命令只会展示当前 model_provider 下的会话记录。如果你切换过 API Key 或订阅源，之前的旧会话可能不会显示出来——并不是数据丢失了，而是被当前 provider 条件过滤了。
如果命令返回为空，或者只显示很少的会话，也不用着急，接下来可以继续检查本地文件目录。
直接读取 ~/.codex/sessions 目录
所有会话的原始数据都会以 JSONL 格式保存在该目录下：
Linux/macOS：~/.codex/sessions/
Windows：C:Users{用户名}.codexsessions
目录通常按年/月/日分层存放，例如：
~/.codex/sessions/2026/07/22/rollout-2026-07-22T14-38-01-8a2f1c9d-4b5e-7f1a-9d0c-3e8a7b2f1c9d.jsonl
每一个文件都对应一次完整的 Codex 会话归档。无论你使用 VS Code、Notepad++，还是命令行工具（如 cat / less / head）打开文件，通常在前几行就可以看到 session_meta 字段，其中包含 id、cwd、model_provider、start_time 等关键信息。换句话说，只要对应文件没有被删除，这条会话记录就会一直保留在本地。
用 codex-session-browser 快速筛选并预览
安装后直接运行：
npm install -g codex-session-browser
codex-sessions
这是一个终端下的 TUI 工具。启动后，左侧会列出当前项目中的所有会话，右侧会实时展示所选会话的 model 名称、tools 使用情况以及最近三条消息摘要，底部还会附带一条可直接复制使用的 codex resume
按 / 可进入搜索模式，输入关键词（例如 “payment retry” 或 “xlsx export”）后，列表会即时过滤；通过 ↑↓ 键移动选择；按回车即可进入对应会话。整个查找流程不需要反复复制粘贴，也无需手动记住会话 ID。
需要注意，默认搜索范围仅限当前 $PWD 下创建的会话。如果你想跨项目查找历史记录，请加上 --all 参数：
codex-sessions --all
通过 Codex History Manager 浏览 Web 界面
下载项目后，Windows 用户双击 start_windows.bat，Linux/macOS 用户运行 python server.py，服务启动后访问 http://127.0.0.1:8765。
页面会自动按照“项目会话”“临时会话”“归档会话”三类进行分组。每条记录都会展示标题、时间、消息数量和本地路径，并支持点击展开完整内容。删除、重命名、归档等操作都带有二次确认弹窗，所有写入操作也都会通过最新的 Codex CLI 执行，不会直接写入 SQLite 或 JSONL 文件。
如果你刚刚切换了 model_provider，但历史会话仍然无法显示，通常说明索引还没有同步完成。此时不要手动修改文件，建议先使用 codex-provider-sync 工具修复元数据一致性。