要彻底清空codex本地历史记录,需用codex-history工具跨sqlite、jsonl等层联动清理:先doctor检查兼容性,再list查看会话,最后purge-orphans和purge--all确认删除;windows可用clean_codex.bat一键清sessions目录;日志用sqlite3清空并vacuum,图像缓存整删,快照按时间清理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想彻底清空 Codex 本地所有历史任务记录,不是点一下“归档”或按一次 /clear 就能解决的事——界面里看不见的对话,可能还躺在 SQLite 数据库、JSONL 会话文件、日志表、快照目录甚至图像缓存里,随时可能被搜索召回或意外参与上下文推理。
用 codex-history 工具安全批量清理
这是目前唯一能跨存储层(SQLite + JSONL + 索引 + 快照)联动识别并清除本地会话引用的 CLI 方案。
第一步:检查本地结构兼容性
运行 codex-history doctor。如果返回 ✅ Supported,说明当前 ~/.codex 目录结构受支持;若报错或提示不兼容,【请勿继续执行 purge】,否则可能破坏会话元数据。
第二步:列出全部未归档会话
执行 codex-history list --all。该命令会显示所有未归档、已归档、以及 orphaned(孤立)会话的短 ID 和基础信息,包括创建时间、工作目录和首条消息预览。
第三步:确认并执行全量清理
输入命令:codex-history purge-orphans && codex-history purge --all。
前者清理无对应会话文件的数据库残留记录;后者将逐条提示你确认每条会话删除——此时终端会展示目标会话标题与路径,输入 y 继续,n 跳过。注意:该操作不可逆,且【不会删除服务端记录】,仅作用于本地。
第四步:验证清理结果
再次运行 codex-history list --all,应返回空列表;同时检查 ~/.codex/sessions/ 和 ~/.codex/archived_sessions/ 目录是否为空,state_5.sqlite 中 threads 表的行数应大幅减少。
Windows 用户一键脚本强制清空 sessions 目录
适用于只想快速清掉所有活跃会话、不关心归档或数据库状态的场景,适合重启前应急使用。
新建一个文本文件,粘贴以下内容,保存为 clean_codex.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%" >nul 2>nul<br> mkdir "%TARGET%" >nul 2>nul<br>)<br>start "" "shell:AppsFolder\OpenAI.Codex_2p2nqsd0c76g0!App"
双击运行该 .bat 文件,它会自动结束 Codex 进程 → 清空 sessions 目录 → 重建空目录 → 重新启动 Codex 应用。
注意:此脚本【不触碰 archived_sessions、state_5.sqlite 或 logs_2.sqlite】,只清空实时会话文件夹,适合日常轻量维护。
手动清空日志与缓存释放磁盘空间
方法一:安全截断日志表
在终端中执行:sqlite3 ~/.codex/logs_2.sqlite "DELETE FROM logs;"sqlite3 ~/.codex/logs_2.sqlite "VACUUM;"
这两条命令清空日志内容并回收磁盘空间,【切勿直接 rm -f ~/.codex/logs_2.sqlite】,否则 Codex 启动时会因缺失表结构报错。
方法二:整目录清理图像缓存
执行:rm -rf ~/.codex/generated_images/*
这些是 AI 绘图生成的中间产物,无复用价值,文件名无规律,必须整目录清空;Codex 下次绘图时会自动重建该目录。
方法三:按时间清理 shell 快照
进入目录:cd ~/.codex/shell_snapshots
执行:find . -name "*.json" -type f -mtime +7 -delete
保留最近 7 天快照,删除更早的——快照体积大且极少回溯查看,定期清理可节省数百 MB 空间。











