炸了！Claude Code终于补上最大短板：MEMORY.md让它第二天还记得你

改写整理自 Youssef Hosni 于 2026 年 3 月 18 日发布的文章《Claude Code - MEMORY.md: Everything You Need to Know & How to Get Started》，并结合 Anthropic 官方文档与更新日志校正。

如果你真的拿 Claude Code 干过活，你一定懂这种崩溃感。

昨天它还知道你的项目结构、构建命令、代码习惯，连上一次怎么修掉的坑都门儿清。

今天重新开一个会话。

它又像刚入职。

前情提要全没了，你还得重新做一遍 onboarding。

这个坑，Claude Code 终于开始补了。

Anthropic 给它加上了自动记忆能力。核心就是一个文件：MEMORY.md。

一句话理解：

CLAUDE.md 是你写给 Claude 的规则，MEMORY.md 是 Claude 给自己记的项目笔记。

先说重点：它解决的不是“聊天记录保存”，而是“跨会话接着干”

自动记忆打开后，Claude Code 会把值得保留的项目信息写进记忆目录。

下次你再回到同一个项目，它会先读取这些内容，再开始新会话。

这意味着它记住的重点通常不是闲聊，而是这些真正有用的上下文：

• 项目怎么启动、怎么测试、怎么构建
• 哪些模块最关键，文件之间怎么关联
• 某个问题之前是怎么定位和修掉的
• 你在这个项目里的协作偏好和工作方式

说白了，它终于开始像“搭档”，而不是“每次都要重新认识你的实习生”。

MEMORY.md 到底是什么

很多人先接触的是 CLAUDE.md。

那个文件本质上是说明书，告诉 Claude 应该遵循什么规则、用什么风格、按什么方式协作。

但 MEMORY.md 不是这个定位。

它更像 Claude 在项目里的长期工作笔记。

两者区别可以直接记成这句：

• CLAUDE.md：你规定它怎么做
• MEMORY.md：它记录自己学到了什么

这也是为什么自动记忆真正有价值。

它不是多了一个配置文件，而是多了一个能持续积累项目上下文的机制。

它存在哪里

官方文档给出的自动记忆目录是：

~/.claude/projects/<project>/memory/

这里最关键的，不只是路径本身，而是它的作用范围。

同一个 Git 仓库下的子目录，甚至同一个仓库的 worktree，共享的是同一个自动记忆目录。

也就是说，只要本质上还是同一个 repo，Claude Code 看到的就是同一份项目记忆，而不是每切一个目录就重新来过。

这点很重要，因为它决定了自动记忆是“按项目”工作，不是“按当前终端路径”碎片化工作。

新会话不是全量读记忆，只读最关键的一小段

这里有一个特别容易忽略、但非常关键的细节。

Claude Code 在启动新会话时，不会把整个 MEMORY.md 一股脑全塞进去。

官方文档写得很明确：启动时只加载 MEMORY.md 的前 200 行或 25KB，以较小上限为准。

这直接带来两个结论。

第一，MEMORY.md 不能写成流水账。

第二，真正重要的信息必须尽量靠前、尽量精炼。

所以更合理的结构通常是：

• MEMORY.md 放高密度总索引
• 细节拆到其他主题文件里
• 需要时再按需查看和更新

这也是为什么自动记忆不是“无限增长的神秘黑盒”，而是一套有组织的记忆文件系统。

/memory 不是摆设，它就是控制台

很多人看到这个功能时，第一反应是：那我怎么查看？怎么改？怎么关？

答案就是 /memory。

根据官方文档，/memory 可以做三件关键事：

• 查看和编辑记忆相关文件
• 打开自动记忆目录里的文件
• 直接切换 auto-memory 开关

也就是说，这套机制不是不可见的后台魔法。

你能看。

你能改。

你也能关。

这点非常关键，因为“能记住”很重要，“能控制它记什么”更重要。

哪些版本能用

这里一定要纠正一个常见误传。

自动记忆不是很早就有，也不是必须升级到某个更高的小版本才行。

按官方更新日志，auto-memory 需要 Claude Code v2.1.59+。

如果版本不够，新功能就别指望了。

最稳的检查方式就两个命令：

claude update
claude --version

先更新，再确认版本号是否达到 2.1.59 或更高。

后面又补了什么

这次更新真正有意思的，不只是“有了自动记忆”，而是后续能力还在继续补。

根据官方 changelog，后续又加入了 autoMemoryDirectory 配置项。

这意味着自动记忆目录在后来的版本里有了更明确的可配置能力。

另外，--bare 模式会禁用 auto-memory。

这也很合理。

因为 --bare 的目标本来就是更干净、更少附加上下文的运行方式，自动记忆自然不会跟着一起启用。

它和 CLAUDE.md 不是替代关系，而是分工关系

很多人最容易问的一句就是：

“既然已经有 CLAUDE.md，为什么还要搞一个 MEMORY.md？”

因为这俩压根不是一回事。

CLAUDE.md 负责规则。

MEMORY.md 负责经验。

一个是你预先告诉它“应该怎么做”。

一个是它在真实协作里慢慢积累“这个项目到底是什么样”。

前者决定边界。

后者决定连续性。

两者叠在一起，Claude Code 才真正开始具备长期协作的味道。

这功能为什么值得关注

因为 AI 编程工具真正影响效率的，很多时候不是单次回答得多华丽。

而是你第二天回来，它还能不能接着昨天的进度继续做。

自动记忆补上的，正是这一刀。

它没有把 Claude Code 变成另一个产品。

但它确实把体验从“每次重开都像重置”往前推了一大步。

尤其是你长期维护同一个项目、频繁中断再继续的时候，这种提升非常直接。

不是模型更会说了。

而是工具终于没那么容易失忆了。

最后一句

CLAUDE.md 让你教会它规则。

MEMORY.md 让它保留合作经验。

前者让它更听话，后者让它更连续。

对于经常用 Claude Code 写代码的人来说，这不是小修小补。

这是它第一次认真补上“第二天还认不认识你”这个最大短板。

数据来源 / Sources

• 官方文档：https://code.claude.com/docs/en/memory
• 官方更新日志：https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md