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

张开发
2026/4/10 21:17:38 15 分钟阅读

分享文章

炸了!Claude Code终于补上最大短板:MEMORY.md让它第二天还记得你
炸了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共享的是同一个自动记忆目录。也就是说只要本质上还是同一个 repoClaude Code 看到的就是同一份项目记忆而不是每切一个目录就重新来过。这点很重要因为它决定了自动记忆是“按项目”工作不是“按当前终端路径”碎片化工作。新会话不是全量读记忆只读最关键的一小段这里有一个特别容易忽略、但非常关键的细节。Claude Code 在启动新会话时不会把整个MEMORY.md一股脑全塞进去。官方文档写得很明确启动时只加载MEMORY.md的前 200 行或 25KB以较小上限为准。这直接带来两个结论。第一MEMORY.md不能写成流水账。第二真正重要的信息必须尽量靠前、尽量精炼。所以更合理的结构通常是MEMORY.md放高密度总索引细节拆到其他主题文件里需要时再按需查看和更新这也是为什么自动记忆不是“无限增长的神秘黑盒”而是一套有组织的记忆文件系统。/memory不是摆设它就是控制台很多人看到这个功能时第一反应是那我怎么查看怎么改怎么关答案就是/memory。根据官方文档/memory可以做三件关键事查看和编辑记忆相关文件打开自动记忆目录里的文件直接切换 auto-memory 开关也就是说这套机制不是不可见的后台魔法。你能看。你能改。你也能关。这点非常关键因为“能记住”很重要“能控制它记什么”更重要。哪些版本能用这里一定要纠正一个常见误传。自动记忆不是很早就有也不是必须升级到某个更高的小版本才行。按官方更新日志auto-memory 需要 Claude Codev2.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

更多文章