最安全的批量删除codex会话方式是使用codex-history cli:先运行doctor检查兼容性,再list筛选目标,最后purge确认删除;codex++图形界面适合多选或按项目批量删;windows批处理仅限清空全部未归档会话且不可逆。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想一次性清理 Codex 里几十条测试会话、临时项目或过期对话,又不想一条条点归档再手动删文件?批量删除必须避开直接删目录这种高风险操作,否则会留下 SQLite 引用、索引错位甚至启动报错。
用 codex-history CLI 批量按条件删
这是目前最安全的批量方式,支持关键词、路径、归档状态等多维筛选,每一步都可确认、可验证。
第一步:先检查本地数据结构是否受支持
运行 codex-history doctor。如果返回 【unsupported structure】,说明 Codex 最近更新了存储格式,当前版本工具不兼容,停止后续操作。
第二步:列出匹配目标会话
比如要删所有含 “test” 的临时会话:codex-history list --grep "test"
或者删指定项目下的全部会话:codex-history list --cwd /Users/you/Projects/old-demo
第三步:执行批量删除
把上一步输出的短 ID 全部复制过来,一次性传入:codex-history purge 019e6885 019e6874 019e686a
也可以直接用条件批量删:codex-history purge --grep "temp" --archived
该命令会逐条展示待删项,并要求你输入对应短 ID 二次确认——【跳过此步将直接跳过删除,不会误删】。
第四步:验证是否清理干净
运行 codex-history list --grep "test",若无输出,再检查 ~/.codex/archived_sessions/ 和 ~/.codex/sessions/ 目录下是否还有对应 ID 的 rollout-*.jsonl 文件。有残留则说明某处引用未清除,需重跑 purge 并观察终端反馈的清理范围。
用 Codex++ 图形界面批量删
适合不熟悉命令行、但需要直观确认哪些会话该删的用户。它不修改底层文件,所有操作均调用官方 Codex CLI,安全性可控。
方法一:勾选后一键清空
打开 Codex++ → 点击左侧【会话管理】→ 在列表中按住 Ctrl(Windows)或 Cmd(macOS)多选 → 点击顶部【删除】按钮 → 弹窗确认后执行。
方法二:按项目分组批量处理
Codex++ 会自动将会话按工作目录聚类为“项目”。找到已废弃的项目分组 → 点击右侧【删除整个项目】→ 工具会自动识别并清理该路径下所有关联会话、索引及快照。
注意:Codex++ 不处理 logs_2.sqlite 或 shell_snapshots 中的缓存,如需清理日志,需额外执行 SQLite 命令或使用本文其他章节方法。
Windows 用户用批处理脚本清空 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 | ForEach-Object { $_.Id }"`) do (<br> taskkill /pid %%P /t /f >nul 2>nul<br>)<br>timeout /t 3 /nobreak >nul<br>if exist "%TARGET%" (<br> attrib -r -s -h "%TARGET%\*" /s /d >nul 2>nul<br> rd /s /q "%TARGET%"<br> mkdir "%TARGET%"<br>)<br>start "" "shell:AppsFolder\OpenAI.Codex_2p2nqsd0c76g0!App"
双击运行即可。脚本会强制结束 Codex 进程 → 清空 .codex\sessions 目录 → 重建空目录 → 重新启动 Codex。











