OFFICIAL SOURCE ANALYSIS

记忆系统全景

5 种记忆机制:CLAUDE.md、Auto Memory、Team Memory Sync、Magic Docs、Auto Dream、Thinkback。

8. 记忆系统全景(5+ 种记忆机制)

Claude Code 的记忆系统是其最复杂的子系统之一。它通过多种互补的机制,让 AI 助手能够在会话间保持对用户、项目和团队的"记忆"。这些机制从简单的手写规则文件到复杂的自动知识提取和团队同步,覆盖了不同场景的需求。

CLAUDE.md — 用户手写规则

CLAUDE.md 是最基础也最直接的记忆形式。用户在项目根目录或 ~/.claude/ 中编写 Markdown 文件,声明编码规范、项目约定和个人偏好。这些内容在每次会话启动时被加载到模型上下文中,作为系统级指令。它是显式的、可版本控制的、团队可共享的。

Auto Memory / Extract Memories — 自动提取

Auto Memory 是一种被动记忆机制。当 Claude Code 在会话中观察到值得记住的信息(如用户的偏好、项目的特殊约定、反复出现的模式),它会在对话结束时自动提取这些信息并持久化。下次对话开始时,这些记忆会被加载回来。这解决了"我上次已经告诉你了"的痛点。

Magic Docs — 自动更新文档

Magic Docs 比 Auto Memory 更进一步。它不仅提取记忆碎片,还能自动生成和更新项目文档。例如,当 Claude Code 在多次会话中积累了对一个项目架构的理解后,它可以将这些知识整合成一份结构化的文档,并在后续会话中发现新信息时持续更新。

Auto Dream — 定时记忆整合

Auto Dream 借鉴了人类睡眠中的记忆巩固概念。在用户不活跃时(如夜间),系统会对积累的记忆碎片进行整合——去除冗余、解决矛盾、建立关联。这确保记忆库随着时间推移变得更加精炼和有用,而不是无限膨胀。

Team Memory Sync — 团队知识共享

Team Memory Sync 将记忆从个人扩展到团队。通过 pushpullwatch 操作,团队成员可以共享和同步他们的 Claude Code 记忆。一个成员发现的项目约定可以自动传播给整个团队,实现知识的集体积累。

Thinkback — 年度回顾 / 记忆回放

Thinkback 是一个回顾性功能,允许用户回放和审视过去一段时间内 Claude Code 积累的记忆。它像一个"年度总结"——帮助用户了解 AI 助手学到了什么、哪些记忆最常被使用、哪些可能已经过时需要清理。

记忆层级对比
机制触发方式存储位置共享范围更新频率
CLAUDE.md用户手写文件系统项目/全局手动
Auto Memory会话结束时自动本地数据库个人每次会话
Magic Docs知识积累后自动项目目录项目按需
Auto Dream空闲时定时本地数据库个人定时
Team Syncpush/pull/watch云端团队按需/实时
Thinkback用户主动触发只读回放个人N/A