记忆系统全景
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 将记忆从个人扩展到团队。通过 push、pull 和 watch 操作,团队成员可以共享和同步他们的 Claude Code 记忆。一个成员发现的项目约定可以自动传播给整个团队,实现知识的集体积累。
Thinkback — 年度回顾 / 记忆回放
Thinkback 是一个回顾性功能,允许用户回放和审视过去一段时间内 Claude Code 积累的记忆。它像一个"年度总结"——帮助用户了解 AI 助手学到了什么、哪些记忆最常被使用、哪些可能已经过时需要清理。
| 机制 | 触发方式 | 存储位置 | 共享范围 | 更新频率 |
|---|---|---|---|---|
| CLAUDE.md | 用户手写 | 文件系统 | 项目/全局 | 手动 |
| Auto Memory | 会话结束时自动 | 本地数据库 | 个人 | 每次会话 |
| Magic Docs | 知识积累后自动 | 项目目录 | 项目 | 按需 |
| Auto Dream | 空闲时定时 | 本地数据库 | 个人 | 定时 |
| Team Sync | push/pull/watch | 云端 | 团队 | 按需/实时 |
| Thinkback | 用户主动触发 | 只读回放 | 个人 | N/A |