Claude Code 的 Memory 系统：让 AI 记住你的偏好

在使用 Claude Code 进行开发时，你是否曾有过这样的困扰：每次开启新会话，都要重复告诉 AI 使用 pnpm 而不是 npm、提交代码时不加 Co-Authored-By、日志统一用 logger.info() 而非 console.log？这些看似简单的指令，却在一次次的重复中消耗着宝贵的时间和精力。事实上，Claude Code 本身就内置了一套完善的 Memory 系统，专门用于解决这类问题——只是很多人从未真正了解并善用它的能力。

CLAUDE.md 的层级结构与使用策略

Memory 系统的核心在于两套互补机制的协同运作：CLAUDE.md 是由用户主动编写的持久指令集，而 Auto memory 则是 Claude 根据你的操作习惯自动积累的学习笔记。两套机制都会在每次会话开始时加载，Claude 会将它们作为上下文来理解并执行。这意味着，指令越具体、越明确，AI 的执行一致性就越高；反之，模糊的规则很容易被忽视或遗漏。

Auto memory 的自动学习机制

Auto memory 是 Claude Code 另一个强大的特性，它会在工作过程中自动识别并保存有价值的信息——构建命令、调试模式、API 约定、代码风格偏好等。默认情况下 Auto memory 处于开启状态，存储位置在 ~/.claude/projects/<project>/memory/ 目录下。其中 MEMORY.md 作为索引文件，会在每次会话开始时自动加载。你可以随时通过 /memory 命令查看和管理所有 Memory 内容，包括手动编辑或删除过期的记忆。

什么该存，什么不该存

关于 Memory 的内容选择，业界公认三类信息值得存放：一是反复出现的纠正指令，如工具偏好（pnpm 优于 npm）、Git 规范（提交信息用中文）、日志规范等；二是项目背景和约束，包括技术栈、代码规范、目录结构等；三是跨项目的个人工作习惯，如偏好先讲结论再展开、方案对比时给出 2-3 个选项等。同时，有三类内容应当避免放入 Memory：代码实现细节应留在代码文件里而非指令中；会变化的事实如版本号、URL、API key 等应放在 .env 或代码注释中；架构决策和技术选型原因应记录在 Git commit message 或 ADR 文档中。

Memory 的维护与排错

Memory 系统并非一劳永逸，需要定期维护更新。依赖升级、架构调整、团队规范变更都可能导致原有规则过期。官方文档特别指出，当两条规则互相矛盾时，Claude 可能会随机选择执行，这比没有规则更加危险。建议在每次架构变更时检查 Memory、每季度用 /memory 命令全面梳理一次，删除或更新过时的条目。如果遇到 Claude 没有按 Memory 行事，首先确认文件是否被正确加载，然后检查规则是否足够具体、是否存在冲突，必要时可将重要规则通过 --append-system-prompt 参数提升到系统提示层面。

如有侵权，请联系删除。