Claude Code 里那些不会自动清理的本地文件

今天这段材料看起来很短，只是在讲history.jsonl、stats-cache.json、remote-settings.json这几个文件。但放到 Claude Code 的日常使用里，它其实牵出了一个很容易被忽略的问题，我们每天让 Claude Code 读代码、跑命令、生成补丁、恢复会话、统计用量，背后并不是所有数据都会跟着自动清理策略一起消失。有些文件会按周期清掉，有些文件会一直留在本机，直到我们主动删除。Claude Code 官方文档把这类内容放在Application data这一层。~/.claude不只是配置目录，它同时保存 Claude Code 在工作过程中写入的会话转录、提示词历史、文件快照、缓存和日志。官方文档还特别说明，Windows 上的~/.claude对应%USERPROFILE%\.claude，如果设置了CLAUDE_CONFIG_DIR，这些路径会整体迁到新的配置目录下。这就解释了为什么同样在~/.claude下，有的文件像项目会话转录一样会被cleanupPeriodDays管住，有的文件却不会。自动清理主要覆盖的是projects/project/session.jsonl、子代理转录、工具大输出、文件编辑快照、计划文件、调试日志、粘贴缓存、图片缓存、任务列表和一些会话环境数据。官方文档写得很直接，这些路径里的文件会在 Claude Code 启