Claude Agent 记忆四层架构:从便利贴到自我改进
大多数人的 agent 是金鱼。每次会话从零开始,重新发现相同的东西,在第 100 次运行上犯和第 1 次同样的错误。
每次打开新 Claude 聊天,它从什么都没有开始。不知道你的名字。不记得昨天做的三个纠正、上周发现的 workaround、或者你讨厌 bullet-point summary。每次会话重新发现相同上下文,犯相同错误,问你已回答过的问题。
例子:你的编码 agent 发现 export 工具在超过 50MB 的文件上失败,通过先拆分文件修复,你继续。下周,新会话,它再次遇到同样的失败。没有记忆,那个教训随聊天而逝。
对 casual 聊天机器人,这没问题。对做真实、重复工作的 agent,这是你的 setup plateau 的单一最大原因。没有记忆的 agent 在第 100 次运行上和第 1 次一样有用。
记忆不是一个开关。它是四层,每层解决下一层无法解决的问题。第一层是便利贴。第四层是每周五回顾一周、回来更 sharp 的员工。难的部分不是技术。是决定什么值得存活到下一轮。
Layer 1:账户记忆——便利贴
从已存在的东西开始。Claude 可以跨对话保持对你的记忆:你的角色、你的项目、你喜欢的沟通方式。如果账户有记忆设置,打开它。
但大多数人错过的部分:不要等 Claude 从过去聊天推断你的偏好。直接陈述,一条消息,新对话中。Explicit beats inferred 每次,而且立即落地而不是等下次后台同步。
Remember the following about me for future conversations:
- I work in [field]; my main projects are [X, Y].
- I prefer [direct prose / no bullet points / short replies].
- My writing style is [describe it].
- Never [the thing you always have to correct].
一条消息消除整个类别的重复解释。这是便利贴。不多,但它是其他一切站立的地板。
Layer 2:Project——持久工作空间
Project 是持久工作空间。你写的自定义指令加载进其中开始的每次对话:agent 的角色、你的标准、你的约束。设置一次,每次会话继承。
陷阱——大多数人在这里被 burn:Project 持久化指令,不是对话历史。
你设置 Project,给它丰富指令和项目知识,工作几个会话,然后在同一 Project 中打开新聊天,讨论的细节不会自动 carry forward。架构决策、半完成的任务、debug thread:除非保存在某处持久的地方,否则消失。Project 记住它的规则和知识。默认不记住你的周。
那个 gap 正是下一层填补的。
Layer 3:持久记忆文件——真正有效的最小记忆
真正有效的最简单持久记忆是一个 agent 在会话开始时读取、结束时更新的单一文件——如果你的工作流告诉它这样做。Claude Code 中是 CLAUDE.md。任何其他 agent 中可以是项目知识中的 memory.md。
纪律是整个游戏,有两条规则:
规则一:保持精简。新会话可以在你打一个字前花数千 tokens 加载指令。不要把文件当 wiki dump。如果自动生成 starter 文件,counterintuitive 的下一步是删除大部分——它通常陈述模型已经看到的东西。
规则二:给它结构。无节增长的文件变成噪音。有 section 的文件变成 agent 真正能咨询的东西:
Preferences
- Prose over bullets for status updates
- Always cite the source file for any claim
Decisions
- 2026-04-18 - chose Postgres over Mongo (relational reporting)
Known workarounds
- Export tool chokes on files >50MB; split first
Mistakes to avoid
- Don't auto-approve PRs touching the auth module
然后是让整个东西工作的 filter。不是一切都该保存。每次有意义的会话后,问每个候选条目一个问题:这会改变 agent 下次的行为吗?如果是,存储。如果否,让它走。存储一切的记忆和什么都不存储的记忆一样无用。
Layer 4:定期整合——闭环
只增长的文件最终腐烂。Duplicates 堆积。昨天的决定与上个月的矛盾。Signal 淹没。
第四层关闭循环:一个 scheduled 后台进程,读取现有记忆加最近明确保存的会话 transcript,然后重写记忆——干净:duplicates 合并、stale 条目替换为当前值、genuinely new patterns 浮现。人们有时从神经科学借用一个词称之为 agent "dreaming",因为它是工作之间而非工作期间发生的 consolidation。
不需要特殊产品来做。它是普通的 scheduled job——夜间或每周 cron,把旧记忆文件和最新 transcript 交给模型,附指令:"Consolidate this into a clean memory store. Merge duplicates, replace stale entries, surface new recurring patterns. Here are the criteria."
一条规则保持安全:把结果写到新文件,保持旧文件只读直到 review 完。检查合并是否正确、"replaced"条目确实 stale、浮现的洞察是真实 signal 不是噪音。只有 then 把 agent 切换到新存储。因为选择全新文件,坏的 consolidation 永远不会静默 corrupt 你已有的东西。
一个条件决定这是否值得:第四层只帮助重复跑相同类型任务的 agent。它在许多会话中整合模式,所以一次性 agent 没什么可整合。在工作马身上跑,不是游客。
四个常见错误
- 把 Project 当记忆。它们持久化指令,不是历史。假设否则,你会丢失上下文而不理解为什么
- 把一切都 dump 进记忆文件。Bloated 文件浪费 tokens 并 bury signal。Lean and structured beats long and complete
- 无 filter 存储。如果一切都值得记住,什么都不值得。只保存改变未来行为的东西
- Auto-deploy 没读过的整合。写到新文件的整个 point 是 review 步骤。跳过它,你失去安全网
结论
第一层是便利贴。第四层是每周五反思、回来更 sharp 的同事——无 retraining,无手动重配置,只是一个复利的 loop。
大多数人继续以他们一直有的方式打开 Claude:每次 fresh、健忘的聊天,每次运行重新解释自己,wonder 为什么他们的 agent 从不变得更好。
今晚设置前三层。那 alone 会改变你下次会话的感觉。当你的 agent 终于有一周值得记住时,添加第四层。