夜雨聆风很多人用Claude Code时，常分不清它的自动记忆（核心以MEMORY.md为载体）和手动创建的CLAUDE.md到底有什么区别，也不明白这俩东西的实际作用。
一、先搞懂：自动记忆（Memory）是什么？有什么用？
自动记忆是Claude Code自带的“智能笔记本”，它会主动记录你项目里的关键信息——比如你的使用习惯、项目的隐性规则、之前踩过的坑、调试经验等。这些信息有个共同点：没法直接从代码、Git历史里直接推导出来，但又会持续影响后续开发决策。
举个直观的例子：你习惯用pnpm而非npm，或者上次解决了Redis连接池泄漏的问题，这些信息若没记录下来，下次对话就得重新说明。自动记忆就专门记这类“代码外的关键信息”，它会把内容整理成单独的Markdown文件，再用一个MEMORY.md做索引，避免后期混乱。
它的核心作用是让Claude Code记住你的项目语境，不用反复重复交代背景，跨会话也能延续上下文，让AI从“只会处理临时任务”变成“懂你项目的长期伙伴”。
需要特别区分的是，它不会记代码本身的结构、路径这些有权威来源的信息——比如具体的代码内容、文件路径，这些如果记入长期记忆，容易出现“代码说A，记忆说B”的矛盾，导致模型决策摇摆，所以源码明确禁止这类信息进入长期记忆。
另外，Claude Code的记忆不是单一模块，而是分了四层协同：
长期记忆：负责跨会话保存信息，核心载体就是MEMORY.md；
相关记忆：仅在当前轮对话生效，临时提取和当前问题相关的历史记忆，避免过度加载；
会话记忆：针对长对话，把前半段会话压缩成摘要存成summary.md，避免上下文过载；
子代理记忆：给子代理独立空间，让子代理能保存专属经验，不互相干扰。
二、再看：CLAUDE.md是什么？核心作用在哪？
CLAUDE.md本质是你写给Claude Code的“项目规则手册”，需要你手动编写，相当于给AI划定了明确的工作边界和标准。
它能定义的内容很具体，比如明确项目必须用TypeScriptstrict模式、规定API的设计规范、约定目录结构、提交代码前的测试命令，甚至能直接禁止某些行为（比如不让AI自动生成文档注释）。
这份手册不仅能让Claude Code完全按照你的项目规范执行，还可以直接放进项目仓库里，方便团队共享——让所有用Claude Code的开发者，都遵循同一套规则，保证项目开发风格的一致性。
三、核心区别：自动记忆（Memory）和CLAUDE.md，到底差在哪？
这俩的区别，核心从三个维度就能看透：
维护者完全不同
自动记忆是AI自动维护的：只要在对话中提及关键信息，Claude Code会根据规则主动整理、写入，完全不用你手动操作；
CLAUDE.md是你自己维护的：必须手动撰写、修改，你是规则的制定者，AI只会被动遵循你的要求。
核心定位天差地别
自动记忆是AI的“学习笔记”：内容是AI从你的对话里归纳总结的经验，比如“你总习惯用某种方式处理错误”“上次调试的关键结论”，属于动态生成的归纳性内容，会随着对话推进不断变化；
CLAUDE.md是项目的“刚性规则”：内容是确定性的指令，比如“必须用某个库”“要遵循某套代码规范”，属于静态的规则，不会因为你和AI的对话而改变。
共享和使用场景不同
自动记忆是本地私有的：存在系统特定目录，不会进Git仓库，是AI记录你个人偏好和项目隐性经验的专属文件，无法直接分享给团队；
CLAUDE.md可团队共享：存在项目根目录，能同步到Git，团队成员都能查看和使用，目的是统一团队的开发规则，保证大家协作时的一致性。
举个通俗的类比：CLAUDE.md就像你给手下定的“工作准则”，明确告诉他该做什么、按什么标准做；而自动记忆是手下自己的“工作笔记本”，他会根据和你协作的经验，自己记下注意事项、你的偏好，下次做事时自动参考，不用你重复交代。
四、为啥这俩必须配合用？单独用不行吗？
单独用任何一个，效果都会打折扣，两者配合才是最优解，核心逻辑是互补：
CLAUDE.md定框架，保证确定性：它提供的是刚性约束，确保AI不管和谁对话，都遵守项目的统一标准，比如不管你说多少偏好，都得按项目约定的库、规范来写代码，避免混乱。
自动记忆补细节，保证连续性：它提供柔性的上下文延续，弥补CLAUDE.md无法覆盖的动态经验——比如CLAUDE.md只说了“API要校验输入”，而自动记忆会记下你习惯用zod做校验，下次AI不仅能遵守校验规则，还会主动选zod，不用再教你。
简单说：CLAUDE.md让AI“守规矩”，自动记忆让AI“懂你”，两者结合，AI才能真正成为贴合你项目、懂你习惯的编程伙伴。
五、实用总结：该怎么用？
用CLAUDE.md定底线：把项目里确定性的规范、约定写进去，比如技术栈、代码风格、提交规则，确保AI的输出始终符合项目要求，这也能方便团队协作统一标准。
让自动记忆记经验：不用刻意操作，正常使用Claude Code即可，它会自动记录对话里的关键信息，比如你的偏好、调试经验，下次使用时直接调取，不用重复交代。
一句话概括：CLAUDE.md是你掌控AI方向的指挥棒，自动记忆是AI帮你省时间的工具——一个定规则，一个记经验，缺一不可。
