Codex会话记录会悄然占用几十GB磁盘空间,尤其在长期使用--continue模式、分析大文件或运行Agent任务时,~/.codex/sessions/目录可能膨胀超15GB且Windows资源管理器无法显示;需用PowerShell命令Get-ChildItem递归统计真实体积,超8GB即属高风险;推荐用Remove-Item -Exclude "archived_*"清理未归档会话,或按LastWriteTime筛选删除7天前文件;日常应执行codex /archive压缩归档,或启用--no-history彻底禁用历史保存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

codex会话记录确实会悄悄占满几十GB磁盘空间,尤其当你长期使用--continue模式、分析大文件或运行Agent任务时,~/.codex/sessions/目录可能在你毫无察觉的情况下膨胀到15GB以上,而资源管理器里根本看不到它——因为Windows默认不统计隐藏目录下的子文件夹体积。
先确认真实占用量
打开终端(PowerShell或CMD),执行:Get-ChildItem -Path $HOME\.codex\sessions -Recurse -File | Measure-Object -Property Length -Sum。这一步必须做,否则你看到的“已用空间”可能比实际少30%以上——Windows磁盘属性只统计顶层目录,不递归计算嵌套JSONL文件。
如果返回结果超过8GB,说明已进入高风险区;若提示“拒绝访问”,请先在系统设置→隐私与安全→完全磁盘访问中勾选PowerShell或终端应用。
精准清理会话文件
方法一:只删未归档会话(推荐)
执行:Remove-Item -Path "$HOME\.codex\sessions\*" -Exclude "archived_*"。这条命令保留所有归档会话(archived_*前缀),仅清除当前侧栏可见的活跃对话记录。归档会话仍可在Codex桌面版侧栏点击“显示归档”恢复,删除后无法找回未归档会话的上下文。
通过 Codex CLI 生成图片,支持尺寸控制和批量模式。依赖:codex (npm)。代理默认启用。用 generate.sh 生成单张,batch_generate.sh 批量生成游戏 UI 素材,gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
方法二:按时间批量清理
第一步:列出最近7天外的会话Get-ChildItem -Path "$HOME\.codex\sessions" -File | Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-7) }
第二步:确认无误后执行删除| ForEach-Object { Remove-Item $_.FullName -Force }
注意:【不要跳过第一步直接运行第二步】,Codex会话文件名不含时间戳,全靠LastWriteTime判断新旧,误删可能导致正在调试的Agent任务丢失断点。
防止下次爆仓
每次结束长会话前,手动执行codex /archive。这个命令会把当前会话移入archived_sessions/并压缩为单个.tar.zst文件,体积平均缩小62%。不执行此操作,会话将以原始JSONL格式保留在sessions/目录,每轮对话新增约1.2MB纯文本记录。
禁用自动保存历史:在Codex CLI启动时加--no-history参数,或在配置文件~/.codex/config.yaml中添加save_history: false。启用后,所有交互仅存于内存,关闭终端即清空,彻底规避磁盘占用问题。

















