前言¶
ChatGPT 桌面版在 Windows 和 macOS 上都会为 Codex 留下本地存储:.codex 目录、runtime / cache / temp 残留、日报线程归档等。这些文件通常不会主动清理,长期使用后磁盘占用会逐渐增加;而直接手工删除又有误删配置或正在使用文件的风险。下面介绍的 Codex Cleaner 就是为这件事准备的:先审计,再清理,把低风险临时文件、过期日报和保留策略纳入同一个流程。
这是什么¶
Codex Cleaner 是一个跨平台 Skill,定位是安全审计并清理 ChatGPT 桌面版中 Codex 的本地存储,覆盖 Windows 和 macOS。它由社区发布者 user_433daef8 维护,坐标 @user_433daef8/codex-cleaner-romancekami,当前版本 0.1.13,来源标记为 community,分类为 it-ops-security。它解决的是 Codex 本地存储随时间膨胀、而普通用户缺少安全清理手段的问题。
核心功能¶
根据官方简介,Codex Cleaner 的能力集中在以下几处:
1、审计 Codex 磁盘占用,定位本地存储中占用较大或长期未变动的部分。
2、清理低风险临时文件,重点处理 Codex runtime / cache / temp 残留。
3、归档旧日报线程,保留历史记录的同时避免长期堆积。
4、删除过期日报会话。
5、设计安全的 Codex 保留策略,用于后续的定期清理。
其处理对象包括 .codex 目录以及 Codex 运行时产生的缓存、临时文件等残留。官方资料未逐项给出各功能对应的具体命令或参数,以上按简介范围整理。
安装与启用¶
Codex Cleaner 通过 SkillHub 分发,坐标为:
@user_433daef8/codex-cleaner-romancekami
官方页面:https://www.skillhub.cn/skills/user_433daef8/codex-cleaner-romancekami
本次本地抓取的官方资料中未提供具体安装命令、目录路径或配置字段,因此这里不列出未经验证的命令。该 Skill 的元数据标签为 requires_api_key=false,即使用时不要求提供 API Key。如需安装,建议以上述官方页面或 SkillHub 分发页的实际说明为准。
该 Skill 基于通用 SKILL.md 格式编写,可被支持该格式的 Agent 调用;具体在 Cursor、Codex CLI、Claude Code 等客户端中的启用方式,抓取资料未说明,不在此推测。
典型用法¶
根据官方简介,Codex Cleaner 面向的可复现场景包括:
1、查看 Codex 磁盘占用:在需要了解 Codex 本地存储占用时,先做一次审计,再决定清理范围。
2、清理低风险临时文件:针对 runtime / cache / temp 类残留执行清理。
3、归档旧日报:把不再高频访问的日报线程归档,保留历史。
4、删除过期日报会话:对确认过期的日报会话执行删除。
5、设计保留策略:为后续定期清理建立规则。
以上场景来自官方简介的能力描述,资料中未提供逐条命令示例,具体调用方式以官方页面为准。
适用场景与注意¶
适合谁:
1、使用 ChatGPT 桌面版并启用 Codex,且希望控制本地磁盘占用的开发者。
2、需要在 Windows 和 macOS 上统一处理 Codex 存储残留的人。
3、想以较低风险清理临时文件、归档旧日报的用户。
注意:
1、该 Skill 来源为 community,发布者为 user_433daef8,使用前建议先核对官方页面的说明。
2、删除过期日报会话和清理临时文件会改变本地数据,清理前应先确认归档与备份情况。
3、本次抓取的官方资料显示评分 100000、下载 897;任务线索中提到的评分 99646、下载 845 与之不一致,可能为页面不同时间的数据,以官方页面实时数据为准。
结尾¶
Codex Cleaner 的价值在于把「查看 Codex 磁盘占用 → 清理低风险临时文件 → 归档旧日报 → 删除过期会话 → 设定保留策略」串成一套跨平台的本地存储治理流程,降低手工清理的风险。官方地址:https://www.skillhub.cn/skills/user_433daef8/codex-cleaner-romancekami