BotOf Tech
返回首页Claude Code 的 Auto Memory 到底怎么工作：最近两个月最值得理解的一层

Claude Code 的 Auto Memory 到底怎么工作：最近两个月最值得理解的一层

·2 分钟阅读·
ClaudeAgentMemoryArchitecture

从 2026-02-26 到 2026-04-22，Claude Code 的 memory 讨论明显升温了。2 月底开始，X 上大量开发者开始提到 “auto memory across sessions”；到了 4 月初，连系统 prompt 的“ignore memory”语义变化都有人专门跟踪。

这说明一件事：Claude Code 的竞争力已经不只在模型本身，而在它对跨会话项目记忆的处理。

Claude Code 不是一种记忆，而是两种

官方文档把这件事讲得很清楚：

  • CLAUDE.md
  • auto memory

它们不是替代关系，而是分工关系。

机制谁来写负责什么
CLAUDE.md你明确规则、编码规范、工作流
auto memoryClaude工作中学到的事实、模式、偏好

这套拆法非常合理。因为很多信息根本不适合写进 CLAUDE.md：

  • 某个仓库的实际构建命令
  • 某个测试经常失败的原因
  • 某个服务需要本地 Redis 才能跑
  • 用户在几次纠正里反复强调的风格偏好

这些更像“经验”，不是“制度”。

Auto Memory 的关键设计：文件化、可审计、可编辑

Claude Code 官方文档里最重要的一点是：auto memory 不是黑盒。

每个项目都会有自己的 memory 目录，位置在：

  • ~/.claude/projects/<project>/memory/

而且官方明确说明：

  • MEMORY.md 的前 200 行或前 25KB 会在每次会话启动时加载
  • 更细的主题文件不会默认全量注入，而是按需读取
  • memory 文件都是普通 markdown，可以审计、编辑或删除

这让 Claude Code 的记忆层和很多“云端神秘偏好系统”很不一样。它更像一个可见的项目知识缓存。

为什么这个设计聪明

因为它同时解决了三个问题。

1. 避免每次重讲同样的话

这是最直观的收益。常见例子包括：

  • “我们这里一律用 pnpm”
  • “这个仓库先跑 make gen 再测试”
  • “billing 目录改动要先 plan mode”

这些偏好和流程一旦被写入 memory，后续对话就不用不断重复。

2. 避免 CLAUDE.md 变成垃圾场

很多团队一发现 “写规则有效”，就会把所有东西都往 CLAUDE.md 里塞，结果文件越来越长、越来越混乱。Claude Code 的 auto memory 等于给 CLAUDE.md 腾出了一条更合适的通道：规则进 CLAUDE.md，经验进 memory。

3. 让记忆可回收、可治理

这点特别重要。因为 memory 不是永远正确的。项目命令会变、目录结构会变、人的偏好也会变。文件化记忆的好处就是：

  • 你可以删
  • 你可以改
  • 你可以 review

这比“模型背后偷偷学到了某些偏好”稳很多。

最近两个月最值得注意的两个变化

1. 2 月底开始，Auto Memory 变成默认讨论点

3 月初的 X 帖子里，开发者开始把 Claude Code 的升级总结成几件事：

  • worktree isolation
  • app preview
  • PR monitoring
  • auto memory across sessions

这说明在真实使用者眼里，memory 已经从“小功能”变成 productivity 的核心构件。

2. 4 月 7 日，ignore memory 的语义被放松

Claude Code Changelog 追踪到一个很有意思的变化：

  • 系统不再要求在 “ignore memory” 模式下把 MEMORY.md 完全当作空
  • 而是改成不去应用、引用、比较或提及 memory 内容

我的理解是，这代表团队开始更精细地对待 memory 的语义边界。不是简单粗暴地“全部忘掉”，而是对“能看见但不能使用”的行为做更明确的限制。

同一条变更里还有一个很关键的细节：

  • 每个 Agent run 都应被视为没有 memory

这说明 Claude Code 对 subagent 的处理非常克制：主会话可以有跨会话记忆，但一次子代理调用不应该偷偷继承隐性上下文。

Claude Code 这条路线适合什么

我认为它特别适合：

  • coding agent
  • 本地项目工作流
  • 需要审计和回滚的团队
  • 想把“口头纠正”沉淀成项目经验的人

但它不是万能的。它更像 repo-local memory，而不是完整的多用户、多 Agent 共享知识库。要做组织级 memory，还得接额外层。

我的判断

Claude Code 的 auto memory 最值得学的，不是“让模型自己记住东西”这句话，而是它背后的工程选择：

把记忆做成项目里可见、可控、可加载、可编辑的一层。

这比很多夸张的“长期人格化记忆”叙事都更实际，也更适合真正的工程团队。

来源

← 返回所有文章