最近看到一个关于 Codex CLI 的问题,刚开始我也以为是标题党,什么“AI 工具把 SSD 写废了”,听起来有点夸张。
https://github.com/openai/codex/issues/28224

但看完社区反馈以后,我觉得这事还是值得提醒一下。
问题大概出在这个文件:
~/.codex/logs_2.sqlite
如果你用过 Codex CLI,或者 Codex Desktop,本地可能会有这个 SQLite 日志库。正常来说,软件写点日志没什么,出问题方便排查,大家都能理解。
但这次的问题是:它写得太多了。
社区有人实测,Codex 会把大量 TRACE 级别日志持续写进本地 SQLite。这里面可能包括 WebSocket / SSE 的流式报文、底层系统 IO、OpenTelemetry 遥测,还有一些依赖库产生的高频日志。
说白了,不是普通那种“报错才记一下”,而是很多细碎动作都可能被记录下来。
最吓人的是,有用户反馈 21 天累计写入了大约 37TB。按这个速度粗略折算,一年可能接近 640TB 写入量。这个数字是什么概念?很多普通 1TB 消费级 SSD,质保写入寿命 TBW 也就几百 TB。
也就是说,如果你是重度 Codex 用户,长时间开着,多窗口、多任务跑,真的不是完全没有风险。
最坑的是 SQLite WAL
这事最坑的地方还不是 logs_2.sqlite 本身,而是 SQLite 的 WAL 文件。
你可能会看到这几个文件:
~/.codex/logs_2.sqlite
~/.codex/logs_2.sqlite-wal
~/.codex/logs_2.sqlite-shm
SQLite 开 WAL 模式后,很多写入会先进入:
logs_2.sqlite-wal
如果 Codex 一直在写日志,WAL 文件就可能持续变大。
更坑的是,如果 Codex 进程还在运行,你直接删文件,有时候磁盘空间并不会马上回来。因为进程可能还握着已经删除的文件句柄。
你看目录里文件没了,但系统层面空间还被占着,直到你把 Codex 相关进程关掉。
所以这件事不是简单一句“删掉日志文件就行”。
怎么自查?
Mac / Linux 可以执行:
du -h ~/.codex/logs_2.sqlite*
ls -lh ~/.codex/logs_2.sqlite*
重点看这个文件有没有异常变大:
~/.codex/logs_2.sqlite-wal
如果只是几 MB、几十 MB,问题不大。
如果已经几百 MB、几个 GB,甚至更大,那就建议处理一下。
怎么处理?
先彻底退出 Codex CLI、Codex Desktop、相关 VSCode 插件进程。
Mac / Linux 可以用:
pkill -f codex
然后再删除日志文件:
rm -f ~/.codex/logs_2.sqlite ~/.codex/logs_2.sqlite-wal ~/.codex/logs_2.sqlite-shm
注意,社区反馈里说这个 logs_2.sqlite 主要是诊断日志,不是你的会话历史。一般删掉它不会影响聊天记录。
但我不建议你乱删整个 ~/.codex 目录,尤其不要随便删类似 state_5.sqlite 这种看起来像状态库的文件。
如果删了文件,空间还是没回来?
这种情况也可能发生。
可以查一下是否有 Codex 进程还占着已经删除的文件:
lsof -nP +L1 | grep codex
如果有,说明文件虽然从目录里消失了,但进程还没释放句柄。
这种情况下,继续退出或杀掉 Codex 相关进程,空间才会真正回来。
Windows 用户怎么看?
Windows 用户可以去用户目录下找:
%USERPROFILE%.codexlogs_2.sqlite
%USERPROFILE%.codexlogs_2.sqlite-wal
%USERPROFILE%.codexlogs_2.sqlite-shm
重点也是看 logs_2.sqlite-wal 有没有异常增长。
现在修了吗?
目前看,CLI 方向已经有人提 PR 做了日志过滤,能减少大量写入。
但 Desktop、Windows、长时间运行场景,社区里仍然有人反馈还会复现。
所以我觉得不能只看官方说“修了没有”,最好自己看一下本机文件增长情况。
最简单的判断方式就是:清掉日志以后,开着 Codex 正常用一会儿,再看看文件是不是持续快速变大。
Mac / Linux 可以这样观察:
watch -n 5 'ls -lh ~/.codex/logs_2.sqlite*'
如果它几秒钟变一次,而且一直涨,那你就要小心了。
我的建议
我个人对这个事的看法是:不用恐慌,但要重视。
Codex 这类 AI 编程工具现在大家用得越来越重,很多人一天开十几个小时,甚至挂在 tmux、VSCode、桌面端里不关。
以前我们觉得 AI 工具最多就是费 token、费钱,现在还得多关注一个问题:它本地到底在干什么。
尤其是 MacBook、笔记本、消费级 SSD,硬盘不是无限写的。平时看不到,不代表没有发生。
建议大家现在就查一下:
du -h ~/.codex/logs_2.sqlite*
一分钟的事。
如果没问题,安心用。
如果已经很大,先关 Codex,再清理。
如果清理后又飞快增长,先升级最新版,或者临时减少长时间常驻使用。
这事本质上不是说 Codex 不能用,而是提醒大家:AI 编程工具越来越像一个本地常驻开发环境了,不再只是一个简单命令行工具。
它的日志、缓存、遥测、索引、后台进程,都可能影响你的机器。
工具好用归好用,但别让它悄悄把硬盘写爆了。