Claude Code 自动记忆（Auto Memory）揭秘：跨会话长期记忆的实现与验证

许多 AI agent 早已加入长期记忆能力，例如“龙虾”、Hermes 等。同样，Claude Code 也内置了类似的功能，只是较少被系统性地探讨。从 v2.1.59 版本起，Claude Code 就已经引入了自动记忆（Auto Memory），能够跨不同会话保存并引用有用的上下文信息。

**版本 2.1.59：** · Claude 自动保存有用的上下文到自动记忆· 添加 `/copy` 命令· 改进复合 bash 命令的"始终允许"前缀建议· 修复 MCP OAuth 令牌刷新竞争条件

我们只需实际验证一下 Claude Code 是否真的拥有记忆，以及如何触发生成长期记忆。

如何快速检查记忆功能

Image

在对话中输入 /memory 命令，如果显示 Auto-memory: on，就说明自动记忆开关已打开。

主动触发记忆写入

在对话过程中直接告诉 Claude 记住某些关键信息，比如：

 ▎ “记住这个项目使用 pnpm 而不是 npm”

 ▎ “记住 API 测试需要本地 Redis”

随后，检查记忆目录下是否生成了对应的记录文件。同时，留意界面上的提示信息：如果出现 Writing memory，表示 Claude 正在写入记忆；出现 Recalled memory，则说明它正在读取此前保存的记忆。

实际操作示例

Image

更进一步，可以让 Claude Code 自己来验证 Auto Memory 是否工作正常：

Image

核心验证点

  1. 当前会话验证：如果在当前的对话中能够看到 <system-reminder> 里注入的 recalled memory 内容，就说明本会话已经加载了 auto memory。
  2. 跨会话验证：开启一个全新的会话，MEMORY.md 的前 200 行会被自动加载到上下文中。
  3. 最终验证方式：退出当前会话，重新启动 claude，然后提问“访问 GitHub 需要注意什么？”——如果它能准确回答出代理地址，就证明 auto memory 已经完全生效。

Auto Memory 的工作原理

  1. 加载：每次会话开始时，将 MEMORY.md 的前 200 行或 25KB 内容加载进上下文。
  2. 写入：Claude 在会话期间使用标准的文件工具对记忆文件进行读写。
  3. 索引：MEMORY.md 充当索引文件，Claude 会把更详细的笔记保存到单独的主题文件中（例如 debugging.md）。
  4. 按需读取：主题笔记不会在启动时加载，只有当 Claude 认为需要时才会主动读取。
  5. 界面提示：当对话框中显示 “Writing memory” 或 “Recalled memory”，就说明 Claude 正在对记忆文件进行操作。

什么是 Auto Memory？

Auto Memory 是 Claude Code 内置的自动记忆系统，让 Claude 可以在不同会话之间自主积累知识，无需你手动编写任何内容。Claude 会在工作过程中自动记录下可能有用的信息，例如：

  • 构建命令
  • 调试经验和关键洞察
  • 架构笔记
  • 代码风格偏好
  • 工作流习惯

需要说明的是，Claude 并不会将每次会话的内容都全盘保存，它会基于信息在未来的对话中是否仍有参考价值来进行判断，只保留值得记住的内容。

另外，CLAUDE.md 同样属于长期记忆的一种形式，不过它需要由用户主动撰写；而 Auto Memory 则完全由 Claude Code 自己来维护和更新。

全文完。