Codex++ 处理会话杂乱问题，基本可以分为四个关键步骤：先通过分类归档，按项目路径、标题关键词或首条消息快速筛选历史会话；再补充清晰的语义化标题标签，既能直接手动编辑，也能使用 /title 指令统一命名；接着借助项目绑定机制，把不同任务的对话按项目拆分管理，并自动继承对应工作区路径；最后再通过 codex-history 工具，用 CLI 批量清理临时会话和无效记录。

Codex 会话记录一旦持续增加，就很容易出现多个项目混在一起、标题不清晰、临时对话无处归档等问题。等到你想快速查找某次调试记录、历史输出结果或交付内容时，往往要翻很久都找不到重点——这本质上不是存储容量不足，而是会话管理和信息结构失去了秩序。

用 Codex++ 管理界面分类归档

打开 Codex++ 客户端 → 在左侧菜单点击【会话管理】→ 系统会自动加载当前所有本地会话记录。

默认列表会按时间倒序显示，但更高效、真正实用的筛选方式其实在顶部搜索框右侧：点击下拉箭头后，可以选择“按项目路径”“按标题关键词”“按首条消息内容”进行过滤搜索。

找到测试类、原型类或已经结项的历史会话后，勾选对应记录并点击【归档】按钮。归档后的会话不会被删除，也不会参与启动时的默认加载，但仍会保存在独立分组中，后续可随时右键选择【恢复】。

【归档操作不可逆撤销】一旦完成归档，下次启动 Codex 时，这些会话的元数据将不再被默认读取，因此能够明显提升客户端冷启动速度和会话加载效率。

给会话加明确标题和标签

方法一：在 Codex 对话窗口顶部点击当前标题（通常默认显示为“新会话”或时间戳），直接修改为更清晰的语义化名称，例如：“v2.3 API 文档生成｜2026-08-05”。

方法二：在会话中输入指令 /title ，然后加上空格和新标题，例如 /title 【交付】前端登录页截图+HTML 模板。Codex 会立即更新标题，并同步写入本地索引，方便后续搜索和整理。

注意：标题中尽量不要使用斜杠 / 或反斜杠 ，否则 Codex++ 的路径解析器可能会将其误识别为目录分隔符，导致归档后无法正确显示所属项目。

按项目粒度拆分会话并绑定工作区

第一步：在 Codex 左侧【项目】目录下，右键 → 【新建项目】→ 选择一个空文件夹或现有代码目录作为项目根路径。

第二步：进入该项目后，点击【+ 新建对话】→ 此时新建会话会自动继承该项目路径，并在左侧树形结构中显示为对应子节点。

第三步：在同一个项目里，不同任务尽量分别开启独立对话，例如“接口联调”“样式优化”“SEO 元信息补全”等，让每条会话只围绕一个主题展开。

这样做的优势在于：无论是导出、归档还是搜索，Codex++ 都可以直接按照项目路径进行批量管理；同时 Artifact Radar 也能更准确地识别当前会话产出的文件，是否真正位于对应工作区范围内。

用 codex-history CLI 批量清理无主会话

打开终端后，执行：codex-history list --grep "temp|test|draft"，先列出所有带有临时标识的会话记录。

确认无误后，复制其中一条会话的 short-id（如 abc123），再运行：codex-history purge abc123。

如果想一次性清理所有测试类或临时类会话，可以直接使用这条命令：codex-history list --grep "temp|test|draft" --quiet | xargs -I {} codex-history purge {}。

这一步会同时清理 JSONL 快照、SQLite 索引、状态文件以及 rollout 日志中的关联引用，相比手动删除 .codex/sessions/ 目录，更安全，也更适合长期维护 Codex 会话记录。