1个文件让Claude Code记住你:MEMORY.md全解析

2026年3月20日

25

344

1个文件让Claude Code记住你:MEMORY.md全解析

你是否有过这样的体验:在Claude Code中完成了一个复杂的项目搭建,第二天打开新会话,却发现AI已经“失忆”,你需要重新交代项目细节、编码偏好和架构决策?这正是Claude Code用户长期面临的痛点——每次会话都是从零开始。而现在,Anthropic推出的自动记忆功能(auto-memory)彻底改变了这一局面。

自动记忆的工作原理

自动记忆功能的核心在于MEMORY.md文件。这个由Claude自动创建和更新的文件,相当于一个跨会话的持续笔记本,能够记录你在项目中积累的所有重要上下文信息。与传统的CLAUDE.md(由用户手动编写指令)不同,MEMORY.md完全由Claude自主维护,你无需任何手动操作,它就会默默观察并记录有价值的项目信息。

CLAUDE.md与MEMORY.md的区别

当你更新到Claude Code 1.0.18或更高版本后,自动记忆功能默认开启。Claude会在工作过程中自动记录以下类型的信息:项目模式(构建命令、测试流程、代码库组织方式)、调试经验(疑难问题的解决方案和错误根因)、架构笔记(重要文件、模块关系、核心抽象)、以及你的个人偏好(沟通风格、工作流习惯、工具选择)。 记忆文件存储在~/.claude/projects/<project>/memory/目录下,每个Git仓库有独立的记忆位置。MEMORY.md作为主索引文件,每次新会话启动时会被自动加载。值得注意的是,Claude采用了200行限制机制——新会话只会加载MEMORY.md的前200行,当内容过多时,详细笔记会被拆分到独立主题文件中,按需读取。

Claude 会自己判断什么重要,自动记下来。你不需要自己写 MEMORY.md,Claude 会自动创建和更新它。

“技术观察”

实战使用指南

理解这两个文件的区别至关重要。CLAUDE.md是你给Claude的指令手册,用来定义规则、偏好和项目要求;而MEMORY.md是Claude自己的笔记本,用来记录在工作中发现的有价值上下文。简单来说,一个是“你告诉它怎么做”,另一个是“它给自己记笔记”。 这种分层设计非常巧妙:CLAUDE.md确保Claude按照你的意图行事,而MEMORY.md则帮助它记住关于项目的“常识”,两者配合让AI在会话开始时就能拥有完整的上下文理解。

如何控制自动记忆

使用自动记忆非常简单。首先确保更新到最新版本,然后在一个Git项目中启动Claude Code,给它一个具体任务(如构建一个RAG pipeline),完成后Claude会自动开始记录。 你可以通过/memory命令查看和管理记忆:选项1是用户级记忆(跨项目生效),选项2是项目级CLAUDE.md,选项3是自动记忆文件夹。更有趣的是,你可以直接在命令行切换自动记忆的开关状态,当需要进行探索性工作而不希望被记录时,这个功能非常实用。

如有侵权,请联系删除。

Related Articles

联系我们 预约演示
小墨 AI