有一段时间，我每次开 Claude Code 都要说一遍：
「这个项目是用 Next.js + TypeScript 做的，后端是 PostgreSQL，我们不用 ORM，直接写 SQL，代码风格用中文注释……」
说了两个月，说了几十次，每次都要说。
不是 Claude 不够聪明。是我没有给它地方记住这些信息，每次 session 结束，一切归零。
你第三次跟它解释同一件事，不是它笨，是你没有给它记忆。
Claude Code 的记忆层次
CLAUDE.md（永久记忆）：每次 session 开始时自动加载。项目背景、技术栈、代码约定、禁止行为，全部放这里。
/memory 命令（跨 session 记忆）：在对话中随时保存一条信息，下次 session 加载时读取。适合零散但重要的信息。
session 内上下文（临时记忆）：当前对话历史。session 结束即消失。大多数人唯一依赖的层次，也是最脆弱的。
CLAUDE.md 应该写什么
值得写进去的：
- 项目背景和技术栈
- 代码约定（命名风格、注释语言、格式要求）
- 禁止行为（不要用 console.log、不要写 any）
- 常用命令（怎么跑测试、怎么启动服务）
/memory 命令
/memory 这个项目的 auth 模块有一个已知 bug：并发请求时 session token 可能重复，暂时不修，等下个迭代
适合记录：已知 bug 和技术债、重要决策的背景、临时约定。
让 Claude 主动维护记忆
在 CLAUDE.md 里加规则：
## 记忆规则
当你发现以下情况，主动使用 /memory 记录：
- 用户提到了重要的项目约定
- 用户解释了技术决策的原因
- 发现了需要后续跟进的问题
- 用户纠正了你的理解
Claude 会在合适时候主动帮你记录，不需要每次手动触发。
记忆文件的维护
过期的记忆比没有记忆更危险——Claude 会带着错误的前提工作。每隔一两周检查记忆文件，删掉不再适用的条目。
下次你发现自己在跟 Claude 解释第二遍同一件事，停下来，把那件事写进 CLAUDE.md 或者用 /memory 记下来。三十秒，省掉以后每次的重复交代。
你现在 CLAUDE.md 里有多少行？欢迎评论区说说。
这是「Claude Code 那些没人告诉你的用法」第十二篇。关注不迷路。
更多 Java 工程实战与 AI 工具内容，欢迎关注公众号：SamLai 效率研习社
