codexx 找到你丢失的会话

来源：互联网时间：2026-06-05 07:21:18

codexx

codexx 是一个为 Codex CLI 准备的小工具，专门解决一个让人头疼的问题：当你切换了 provider 之后，发现之前辛辛苦苦建的会话，在 resume 列表里找不到了。

codexx 找到你丢失的会话

其实那些会话并没有凭空消失。它们还老老实实地躺在 ~/.codex/sessions 目录下。只不过是 Codex 原生的 resume 列表会受当前的 model_provider 配置影响，导致看起来像是某些会话突然失踪了一样。codexx 的逻辑很直接：直接从本地 session 的元数据里，把与当前项目相关的所有会话找出来——不管它们当时用的是哪个 provider。

它解决什么问题

在实际开发中，你很可能需要在同一个项目里来回切换 provider：

model_provider = "openai" model_provider = "custom"

切换之后，再执行：

codex resume

你就会发现，一些旧会话从列表里消失了。这时候，codexx resume 会直接扫描 ~/.codex/sessions/**/*.jsonl，按照当前工作目录 cwd 进行过滤，然后把所有 provider 下的匹配会话都给你列出来。

默认情况下，codexx 会隐藏 helper/subagent 这类子线程，让列表更干净，只展示你真正关心的用户会话。如果你确实想查看这些底层线程，可以加上 --include-subagents 参数。

安装

安装过程很简单，一行命令搞定：

npm install -g @meta v_xly/codexx

需要满足两个前提：Node.js 版本在 18 或以上，并且官方的 codex CLI 已经在 PATH 环境变量中。

快速开始

在项目目录里直接运行：

codexx resume

你会看到类似这样的输出：

Matched cwd: C:path oproject Found 3 sessions. 1. 2026-06-03T01:19:15.977Z [custom] 为什么 resume 找不到旧会话 019e8b10-... 2. 2026-06-02T03:07:57.494Z [openai] 分析当前架构 019e864d-... 3. 2026-06-01T10:17:09.954Z [openai] 检验飞书 CLI adapter 019e82af-... Select session number:

选中你需要的会话后，codexx 会使用该 session 记录里的 provider，自动调用官方 Codex 来恢复：

codex -c model_provider="openai" resume

原生选择界面模式

默认的 codexx resume 提供的是一种轻量级列表，方便跨 provider 快速定位 session。如果你想要进入 Codex 原来的 resume 界面，使用原生的展开、预览等交互操作，可以用这个模式：

codexx resume --native

它会先让你选择一个 provider，然后在每个 provider 下面展示最多 3 条最近的会话摘要：

1. [openai] 3 sessions - 2026-06-02T03:07:57.494Z 分析当前架构 - 2026-06-01T10:17:09.954Z 检验飞书 CLI adapter - 2026-06-01T07:46:12.435Z 生成架构图 2. [custom] 1 sessions - 2026-06-03T01:19:15.977Z 修复 resume 找不到旧会话 Select provider number:

选定之后，就进入 Codex 自己的选择界面：

codex -c model_provider="openai" resume

如果你已经知道要用哪个 provider，也可以直接指定，跳过外层选择：

codexx resume --native --provider openai

常用命令

codexx resume codexx --version codexx -v codexx resume --latest codexx resume --latest --dry-run codexx resume --provider openai codexx resume --include-subagents codexx resume --cwd C:path oproject codexx resume --native codexx resume --native --provider custom

参数说明

参数	说明
`-v`, `--version`	显示当前安装的 `codexx` 版本。
`--cwd`	指定要匹配的工作目录。默认是当前目录。
`--provider`	只显示某个 provider 的会话。在 `--native` 模式下会跳过 provider 选择。
`--include-subagents`	包含 helper/subagent 子线程。默认隐藏，避免普通 resume 列表被底层线程刷屏。
`--latest`	直接恢复最近更新的匹配会话。
`--native`	先选择 provider，然后进入 Codex 原生 `resume` 界面。
`--dry-run`	只打印将要执行的 `codex` 命令，不真正执行。
`--no-provider-override`	用 session id 恢复，但不传入 `model_provider=...`。
`--codex-command`	指定 Codex 可执行文件名或路径。默认是 `codex`。
`--codex-home`	指定 Codex home 目录。默认使用 `CODEX_HOME` 或 `~/.codex`。