📌 一句话摘要

本文详细介绍了 Claude Code 的自动记忆功能，包括 MEMORY.md 的工作原理、与 CLAUDE.md 的区别、记忆层级机制，并通过实战演示展示了如何配置与控制这一功能。

📝 详细摘要

文章针对 Claude Code 用户每次开启新会话都需要重复交代项目背景的痛点，详细介绍了 Anthropic 推出的自动记忆功能。核心是引入了一个由 Claude 自动创建和维护的 MEMORY.md 文件，它不同于用户手动编写的 CLAUDE.md，而是 Claude 在协作过程中自主记录的项目上下文，如构建命令、编码偏好、架构决策等。文章深入解析了自动记忆的工作机制，包括信息存储位置（~/.claude/projects//memory/）、200 行限制、记忆层级（用户级、项目级、自动记忆），并通过创建 RAG 管道的实战演示，展示了从开启功能到冷启动会话测试的完整流程。最后，文章还提供了多种控制自动记忆的方法，包括针对单个项目、全局以及在 CI 环境中关闭该功能。

💡 主要观点

1. Claude Code 的自动记忆功能通过 MEMORY.md 文件实现跨会话上下文持久化。 该功能由 Claude 自主创建和维护 MEMORY.md，记录项目模式、调试心得、架构笔记和个人偏好，无需用户手动干预，解决了每次新会话需重复交代背景的痛点。
2. MEMORY.md 与 CLAUDE.md 有明确分工：指令 vs 备忘录。 CLAUDE.md 是用户编写的指令文件，告诉 Claude 如何行事；MEMORY.md 是 Claude 自动生成的备忘录，记录其在协作中积累的上下文。两者协同工作，提供更完善的会话初始上下文。
3. 自动记忆功能提供多种控制方式，适应不同场景需求。 用户可通过 /memory 命令、settings.json 配置文件或环境变量 CLAUDE_CODE_DISABLE_AUTO_MEMORY 来开启或关闭该功能，支持项目级、全局级和 CI 环境下的精细控制。

💬 文章金句

• 你再也不用担心在 Claude Code 中丢失会话上下文了。全新的自动记忆功能解决了工作流中最令人头疼的问题之一。
• CLAUDE.md 是你下达的指令，而 MEMORY.md 是 Claude 自己的备忘录。
• 自动记忆功能在你更新 Claude Code 后即默认开启，无需额外安装或配置，开箱即用。
• Claude 自行判断哪些内容重要，并自动记录下来。
• 如果你即将进行一些不希望 Claude 记住的探索性工作，或者只是临时跑一次性任务，这是暂停当前项目记忆功能最快捷的方式。

📊 文章信息

阅读完整文章