最安全的批量清理方式是使用 codex-history cli：先运行 doctor 检查结构支持，再 list 查看未归档会话，接着用 purge 按 cwd、grep 或 archived 精准筛选，最后逐条确认短 id 执行删除。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想批量清理 Codex 中积压的旧会话，又怕误删正在用的项目记录或只删表面看不到的文件？手动翻 .codex 目录风险高，直接删 SQLite 表可能留下 JSONL 日志、shell snapshot 或归档引用。必须用能识别完整本地数据结构、支持条件筛选、执行前展示目标、删除后验证引用的批量方式。
用 codex-history CLI 批量删除
这是目前最安全的批量清理方式，它不猜测结构，只操作已知受支持的存储类型（SQLite、JSONL、状态快照），且每步都可确认。
第一步：先检查本地结构是否被当前版本支持，避免在未知格式上执行删除：
运行 codex-history doctor。如果输出 ✓ Supported structure detected，继续；若提示 【Unsupported structure】，立即停止，说明 Codex 本地数据布局已更新，该工具暂未适配，强行 list 或 purge 会被拒绝。
第二步：列出所有未归档会话，快速浏览总量和时间分布：codex-history list。默认只显示未归档项，避免误删已归档的重要知识库会话。
第三步：按条件精准筛选目标批次——不是靠眼睛扫，而是用参数锁定范围：
比如清掉上周所有 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，且你明确接受“清空整个 .codex\sessions 目录”的粗粒度操作——它不区分项目、不保留归档、不验证引用，但速度最快。
新建一个文本文件，粘贴以下内容并保存为 clean_codex_sessions.bat：
@echo off<br>setlocal<br>set "TARGET=%USERPROFILE%\.codex\sessions"<br>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 (<br> taskkill /pid %%P /t /f >nul 2>nul<br>)<br>if exist "%TARGET%" (<br> attrib -r -s -h "%TARGET%\*" /s /d >nul 2>nul<br> rd /s /q "%TARGET%" >nul 2>nul<br> mkdir "%TARGET%" >nul 2>nul<br>)<br>start "" "shell:AppsFolder\OpenAI.Codex_2p2nqsd0c76g0!App"
双击运行该批处理文件。脚本会强制结束 Codex 进程 → 清空 sessions 目录 → 重建空目录 → 重新启动 Codex。这一步会丢失所有本地会话记录，包括未归档和已归档的，【不可逆】。
