MEMORY.md
概述
MEMORY.md 是 Claude Code 三层记忆架构的第一层,作为整个记忆系统的轻量级指针索引,始终加载在上下文中。
关键内容
- 核心作用:
- 作为整个记忆系统的核心枢纽,存储指向数据的指针而非实际数据
- 每行约 150 个字符,保持极小的体积
-
始终加载到上下文中(永久占用上下文窗口)
-
结构特征:
- 内容是结构化的指针列表,指向更详细的 topic files
- 包含主题的最后更新时间戳
-
记录最近的决策和它们的来源位置
-
设计优势:
- 全局可见:Agent 在任何时候都知道有哪些主题可以检索
- 按需加载:只有真正需要的 topic 才会被读取
-
极小开销:整个索引文件只有几 KB
-
典型内容:
- 项目记忆索引列表,指向 memory/topics/ 目录下的具体主题文件
- 最近决策记录,包含时间戳和相关日志位置
来源
- raw/articles/ai-tools/claude-code/03_memory_architecture.md — Claude Code 源码泄露深度解析(三)
相关
- 三层记忆架构 — part_of
- Topic Files — relates_to
- Self-Healing Memory — relates_to
- Strict Write Discipline — relates_to