Appearance
Claude Code的Memory：不是记住聊天，而是给Agent建一套项目大脑
不是备忘录，是一套让Agent能长期参与工程项目的上下文管理系统。
六层记忆系统
第一层：指令记忆 —— CLAUDE.md
写进CLAUDE.md的项目行为准则，会在会话启动时就进入Claude的上下文。
支持分层：组织级 → 用户级 → 项目级 → 本地级。组织写安全规范，个人写偏好，项目写架构约定，本地写不适合提交的环境信息。
核心原则：把隐性工程知识显性化，在正确范围内注入给Agent。
第二层：短期记忆 —— 当前对话上下文
你刚说过什么、Claude刚做过什么、工具返回了什么——在这一层。
第三层：工作记忆 —— 任务状态跟踪
和短期记忆的区别：
- 短期记忆偏"对话流"
- 工作记忆偏"任务状态"
前者让Claude能接上话，后者让Claude在复杂任务中不迷路。这也是Agent和Chatbot的区别——Chatbot只需要回答问题，Agent必须持续推进任务。
第四层：长期记忆 —— Auto Memory
Claude会把工作中发现的有价值信息写入本地memory目录。
存储位置：
~/.claude/projects/<project>/memory/MEMORY.md是入口索引，其他主题文件记录debugging、api-conventions等更细内容。
好的记忆原则：不是什么都记。代码文件路径、Git历史、实时架构细节应该现场读取。真正值得存的是"未来还会影响决策"的经验。
第五层：摘要记忆 —— 渐进式维护
长任务一定会遇到上下文窗口限制。Claude Code的思路是渐进式维护——把会话中值得保留的任务进展、关键决策、错误修复过程整理成摘要，让上下文压缩时有持续更新的session memory。
第六层：休眠重塑 —— 记忆维护
记忆最大的敌人不是遗忘，是污染。
AutoDream机制：在非即时任务阶段，对碎片化记忆做清理、合并、去重、消除矛盾，更新索引。可用的长期记忆，不是越多越好，而是越干净越好。
记忆分层一览
| 层级 | 名称 | 作用 | 存储 |
|---|---|---|---|
| 1 | 指令记忆 | 项目行为准则 | CLAUDE.md |
| 2 | 短期记忆 | 对话上下文 | session内存 |
| 3 | 工作记忆 | 任务状态跟踪 | session内存 |
| 4 | 长期记忆 | 经验沉淀 | 磁盘memory目录 |
| 5 | 摘要记忆 | 压缩维护 | 持续更新 |
| 6 | 休眠重塑 | 清理去重合并 | 后台运行 |
核心结论
Claude Code Memory的强项不在于"记性好"，而在于把记忆拆成不同类型，设计不同的加载方式：
| 信息类型 | 存放位置 | 加载方式 |
|---|---|---|
| 规则类 | CLAUDE.md | 会话启动时加载 |
| 任务类 | session/work memory | 执行期间停留 |
| 经验类 | Auto Memory | 索引→按需读取 |
| 长会话 | 摘要记忆 | 压缩时用 |
| 碎片化 | 休眠重塑 | 后台整理 |
AI编程正在从"提示词技巧"走向上下文工程。
未来真正厉害的团队，不是会写prompt，而是会设计AI可读的项目记忆系统。
关键词：Claude Code, Memory, 上下文工程, Auto Memory, CLAUDE.md
