Codex++是Windows/macOS/Linux通用的最快路径，可可视化管理历史会话：自动扫描、三类分组、详情查看、批量删除并调用官方安全流程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在 Codex 中快速定位某次调试记录、找回三天前的 API 设计方案，或者彻底清理掉测试项目留下的 27 个临时会话——但打开桌面客户端只看到一长串无标题、无时间戳、目录名全是哈希值的条目，根本分不清哪个是哪个。
用 Codex++ 可视化管理历史会话
这是 Windows/macOS/Linux 通用的最快路径，无需命令行、不碰 JSONL 文件、不读 SQLite 表结构。
第一步：下载 Codex++ 管理工具（注意：不是 Codex 官方客户端，而是独立第三方工具），解压后双击 【Codex++ Manager.exe】（Windows）或 【Codex++ Manager.app】（macOS）。
第二步：启动后自动扫描 ~/.codex 或 C:\Users\{用户名}\.codex 目录，5 秒内加载所有会话，按“项目”“临时”“归档”三类分组显示。
第三步：点击任意会话右侧的“详情”按钮，立即看到该会话的创建时间、最后活跃时间、消息总数、工作目录绝对路径，以及首条用户输入的完整文本——这比靠文件名猜内容可靠 10 倍。
第四步：勾选多个会话 → 点击顶部“批量删除” → 确认后工具调用官方 codex session delete 命令执行，【不会直接删文件，而是走 Codex CLI 的安全删除流程】。
用 Codex CLI 命令行精准操作
适合需要按时间范围、关键词或项目路径筛选的场景，比如“删掉上周所有以 test_ 开头的会话”。
方法一：列出全部会话 ID 和简要信息
codex session list --verbose
方法二：按关键词搜索并显示路径
codex session search "API 调试" --show-path
方法三：删除指定 ID 的会话（不可逆）
codex session delete abcdef12-3456-7890-abcd-ef1234567890
⚠️ 注意：这个 ID 必须完全匹配，复制时多一个空格或少一位字符都会报错“session not found”。建议先用 list 命令复制完整 ID，不要手打。
用 Codex History Manager 浏览器界面安全归档
当你不确定该不该删，又不想让它继续拖慢启动速度时，归档是最稳妥的选择——它把会话移出活跃列表，但保留全部数据可随时恢复。
第一步：启动 Codex History Manager（Python 3.10+ 环境下运行 python server.py）
第二步：浏览器打开 http://127.0.0.1:8765 → 在会话列表中找到目标项 → 点击“归档”按钮
第三步：页面立刻刷新，该会话从“项目”分组移入“归档”分组，【归档后的会话不会参与 Codex 启动时的历史加载，但所有消息、时间戳、上下文链完整保留】
第四步：需要恢复时，进入“归档”分组 → 找到对应条目 → 点击“恢复” → 会话回到“项目”分组，下次启动即重新生效。
手动清理前必须避开的三个坑
方法一：别直接删 .codex/sessions/ 下的 .snapshot 文件
每个快照文件都包含前一个快照的哈希引用，删掉中间一个会导致整条会话链断裂，后续所有消息无法回放。
方法二：别用资源管理器批量重命名会话目录
Codex 依赖目录名中的 UUID 关联状态，改名后会话在 UI 中消失，CLI 也无法识别，【恢复唯一办法是还原原名，且必须一字不差】。
方法三：别在多个 IDE 实例中同时操作同一项目
每个实例生成独立会话 ID，可能导致 active 文件被覆盖，断点续接时加载错乱会话。正确做法是关闭其他 IDE 窗口后再操作。
