Claude Code 占用 Mac 空间：会话、日志与哪些该保留

会话记录、调试日志和文件快照各管各的事，先分别量一量，再决定删什么。文件夹再大，里面也可能有你还要用的对话或恢复记录。

要点

  • 简单说： 会话、调试日志和文件快照各有用处，删之前先分别测一下。
  • 注意： 删除对话记录就等于删除这段对话。大文件夹里也可能有你还需要的历史或恢复记录。
  • 用 Mint： Mint 在 Disk 页显示 Claude 的存储。测出来的大小不代表建议你清理。

~/.claude 里有什么

会话一般存放在 ~/.claude/projects/<encoded-path>/<uuid>.jsonl，里面可能有内嵌图片。有的会话旁边还有一个同名目录，可能放着工具结果和子 Agent 的会话记录，检查时把它和会话文件当成一组来看。

开启调试时写下的日志在 ~/.claude/debug/。文件编辑前的快照在 ~/.claude/file-history/<session>/，检查点恢复要靠它们，删掉就没有这些恢复副本了。

settings.json、CLAUDE.md、项目记忆目录这类配置和记忆文件要留着。CLI 缓存也可能不在这个目录里，而是在 ~/Library/Caches/claude-cli-nodejs/。

Claude Code 会按自己的保留规则自动清掉一部分应用数据，具体清什么，要看版本、配置和触发清理的条件。别以为数据永远不会被自动删掉，去看看 Claude Code 当前关于这个目录的文档。如果设置了 CLAUDE_CONFIG_DIR，就用那个位置代替 ~/.claude。

先测量，再判断

想比较各个一级目录的占用，可以运行这条只读命令：du -h -d 1 "${CLAUDE_CONFIG_DIR:-$HOME/.claude}" | sort -hr

如果 du 报了权限错误或路径不存在，结果就不完整。这条命令只告诉你空间在哪，能不能删要另外判断。

  1. 改动文件前先停止 Claude 任务，包括其他终端里的会话。
  2. 把还要留着的对话和恢复记录备份好。
  3. 调试日志和会话分开看。排查问题用不上了，再删日志。CLI 缓存用到时可能会重建，腾出来的空间之后可能又被占上。
  4. 在 projects/ 里，只删你确认不要的会话，有同名的伴随目录就一起处理。时间久可以帮你缩小范围，但旧会话不等于能放心删。项目记忆目录别跟着会话一起删掉。
  5. file-history/ 先留着，除非这些恢复副本你已经用不上了。挑好的文件先移到废纸篓，检查过再决定要不要清空。放在废纸篓里的文件照样占空间。

删除会话也会删除对话内容

删掉会话，里面的文字和图片也跟着没了，本地也没法再接着这段会话继续。引用它的记忆笔记可能会指向一条已经不存在的记录，不过删会话本身不会删掉或损坏这篇笔记。

不要为了清理而直接删除整个 ~/.claude。里面除了会话，还有配置和记忆。

Mint 能帮你做什么

Mint 会在“硬盘”页标出 Claude 相关的占用。量出来的大小不代表建议你清理，先弄清每条记录是做什么用的、还要不要留，再选操作。

常见问题

可以删除整个 ~/.claude/projects 吗？

别把整个目录当成可以扔掉的数据。里面可能有对话、相关记录和项目记忆。一段一段地看会话，还要接着用或回头查的就留下。

为什么 ~/.claude 很大？

要看具体的机器。用上面的只读命令分别量一下会话、调试日志和文件快照，哪一类最大，每台 Mac 都不一样。

看看 Claude Code 占了多少空间

扫描一次，在“硬盘”页找到 Claude。

扫描 AI Agent 存储