目前更安全的批量清理方法，是使用 codex-history CLI：先通过 doctor 检查本地数据结构是否受支持，再用 list 查看未归档会话，随后借助 purge 按 cwd、grep 或 archived 条件精准筛选，最后根据逐条显示的短 ID 进行确认删除。
如果你想批量删除 Codex 里积压的旧会话，但又担心误删正在使用的项目记录，或者只删除了表面可见的数据文件，那么直接手动翻 .codex 目录并不是理想方案。更不要直接删除 SQLite 表，因为这可能会遗留 JSONL 日志、shell snapshot 或归档引用。要想安全批量清理 Codex 历史任务，必须使用能够识别完整本地数据结构、支持条件筛选、删除前可预览目标、删除后可验证引用关系的方式。
用 codex-history CLI 批量删除
这是当前相对最安全的 Codex 批量删除方案。它不会盲目猜测数据结构，只会操作已经明确支持的存储类型（SQLite、JSONL、状态快照），而且每一步都支持人工确认，更适合需要安全清理 Codex 历史会话的用户。
第一步：先检查本地结构是否被当前版本支持，避免在未知格式上直接执行删除操作：
运行 codex-history doctor。如果输出 ✓ Supported structure detected，即可继续；如果提示 【Unsupported structure】，应立即停止。这通常表示 Codex 本地数据布局已经更新，而当前工具还未完成适配，因此强行执行 list 或 purge 也会被拒绝。
第二步：列出所有未归档会话，先快速查看会话总量与时间分布情况：codex-history list。该命令默认只显示未归档内容，可以减少误删已归档重要知识库会话的风险，也更适合做 Codex 历史记录批量清理前的预检查。
第三步：按条件精确锁定要处理的批次——无需逐条翻找，可直接通过参数限定范围：
例如，要删除上周所有与 Astro 项目相关的会话，可使用：codex-history purge --cwd "Astro" --grep "build"；
如果需要一次性清理全部已归档会话，可执行：codex-history purge --archived；
若要移除指定目录下的所有会话（路径需填写完整，或包含可识别的关键片段），可使用：codex-history purge --cwd "/Users/me/Projects/legacy"。
第四步：真正执行删除时，系统会逐条展示匹配会话的标题、创建时间、工作目录和短 ID，并要求你**再次输入该短 ID 确认**。即使是批量删除，也仍然强制对每个目标进行人工核验，从而避免因正则误匹配或路径识别模糊而导致连带误删。
用 Codex History Manager 可视化批量删除
这种方式适合不熟悉命令行、希望先看清每条会话内容再进行删除的用户。它不会直接操作底层文件，所有删除行为都通过 Codex 最新 CLI 接口完成，因此在一致性和安全性上更有保障。
方法一：按项目分组批量清理会话
服务启动后，可以在 Web UI 左侧找到“项目”标签页；每个项目名称都对应一个独立工作目录。点击项目名右侧的 ⚙️，然后选择“删除此项目下所有会话”，页面会先弹出预览窗口，展示该目录内全部会话的标题与时间戳。确认无误后，再点击“永久删除”，工具会自动调用 codex delete --force，依次完成清理。
方法二：用搜索结果批量勾选删除
在顶部搜索框中输入关键词，例如“测试”“demo”“temp”，结果列表支持多选操作。勾选完成后点击右上角“批量删除”，系统会先生成待删除会话清单，并要求再次确认。注意：【勾选后不会立刻执行，必须点击确认按钮才会真正触发删除】，这样可以有效避免误触导致的数据清理问题。
Windows 用户用脚本一键清空 sessions 目录
这种方法仅适用于 Windows 应用商店版 Codex，并且前提是你明确接受“直接清空整个 .codexsessions 目录”这种较粗粒度的删除方式——它不会区分项目、不保留归档内容，也不会验证引用关系，但执行速度最快，适合需要快速清空 Codex 会话记录的场景。
新建一个文本文件，粘贴以下内容并保存为 clean_codex_sessions.bat：
@echo off
setlocal
set "TARGET=%USERPROFILE%.codexsessions"
for /f "usebackq tokens=1" %%P in (`powershell -NoProfile -ExecutionPolicy Bypass -Command "Get-Process -Name Codex -ErrorAction SilentlyContinue | Where-Object { $_.ProcessName -ceq 'Codex' } | ForEach-Object { $_.Id }"`) do (
taskkill /pid %%P /t /f >nul 2>nul
)
if exist "%TARGET%" (
attrib -r -s -h "%TARGET%*" /s /d >nul 2>nul
rd /s /q "%TARGET%" >nul 2>nul
mkdir "%TARGET%" >nul 2>nul
)
start "" "shell:AppsFolderOpenAI.Codex_2p2nqsd0c76g0!App"
双击运行这个批处理文件后，脚本会依次执行：强制结束 Codex 进程 → 清空 sessions 目录 → 重建空目录 → 重新启动 Codex。执行这一步后，所有本地会话记录都会被删除，包括未归档和已归档内容，且【不可逆】。