Claude Code 存储
~/.claude 为什么这么大,哪些可以删
Claude Code 把每个会话存成 ~/.claude/projects 下的 .jsonl 文件,旁边还有调试日志和文件快照,而且从来不自动清理。在一台开发者的 Mac 上,610 个会话占了 1.75 GB,其中大约 30% 是内嵌截图;公开的 bug 报告里,还有人的 ~/.claude/debug 和 ~/.claude/file-history 涨到了几百 GB。只要没有 claude 进程在跑,旧会话、调试日志和 CLI 缓存都可以放心删。
~/.claude 里有什么
会话放在 ~/.claude/projects,每个项目路径一个文件夹。每个会话是一个 <uuid>.jsonl 文件,旁边常常还有一个同名文件夹,存着工具结果和子 Agent 的记录。这个文件夹跟会话是一体的,要删就一起删。
~/.claude/debug 是每个会话的调试日志,~/.claude/file-history 是 Claude Code 改过的文件的快照。这两个文件夹没有任何轮换机制,~/.claude 涨到几百 GB 时,多半就是它们。CLI 缓存和 MCP 日志放在这个目录外面的 ~/Library/Caches/claude-cli-nodejs。
settings.json、你的 CLAUDE.md 记忆文件和 .credentials.json 是配置和登录信息。Claude Code 没法重新生成它们,留着别动。
自己动手清理
先量一量再动手。几个大文件夹变大的原因不一样,清理方法也不一样。
- 退出所有 claude 进程,包括开在其他终端窗口里的会话。
- 运行 du -sh ~/.claude/* | sort -rh,看看是哪个文件夹大。
- 清空 ~/.claude/debug 和 ~/Library/Caches/claude-cli-nodejs,Claude Code 下次运行时会重新写入。
- 删掉 ~/.claude/projects 里的旧会话文件,连同它的同名文件夹一起删。
Mint 能帮你做什么
在 Mint 的“硬盘”页,Claude Code 列在 Claude 下面,各个文件夹都标好了大小。会话被当作对话历史原样保留,Mint 不会帮你删,旧会话还是要自己动手清。
在 Direct 版和 Setapp 版里,Claude Code 的缓存可以清,但只限 Claude Code 和 Claude App 都没在运行的时候。Mint 不会动 ~/.claude/debug 和 file-history,也不会缩小 Claude Code 会话里的截图,“优化”目前只用于 Codex 对话。
删之前要注意的事
别运行 rm -rf ~/.claude。它会把设置、记忆文件、登录信息和所有会话一起删掉,之后 Claude Code 没法正常启动。
也留意一下剩余空间。有人反馈磁盘满到 0 字节时,Claude Code 连自己的设置和登录信息都保存不了,所以最好在下次开会话之前先腾出空间。
常见问题
可以删掉 ~/.claude/projects 吗?
Claude Code 还能用,但 claude --resume 就没有可恢复的会话了。更稳妥的做法是只删几个月没打开过的会话。
删掉一个会话会影响别的东西吗?
不会。我们用一个单独的配置目录测过,删掉的会话只是不再出现在 claude --resume 里,恢复它的 id 会给出明确的报错。没有别的东西引用这个文件。
为什么 ~/.claude 会有几百 GB?
到这个量级,罪魁祸首很少是会话,多半是调试日志和 file-history 快照,先量这两个文件夹。
Mint 能像处理 Codex 那样缩小 Claude Code 会话里的截图吗?
不能。“优化”只用于 Codex 对话,Claude Code 的会话 Mint 会原样留着。想腾出这部分空间,就按上面的方法手动删旧会话。
看看 Claude Code 占了多少空间
扫描一次,在“硬盘”页找到 Claude。会话、缓存和 ~/.claude 里的其他文件夹都在那里标好了大小。