课程章节
第 5 章：项目记忆与 CLAUDE.md
学会把长期规则放进项目记忆，让 Claude Code 每次进入项目时都更像“已经提前读过项目说明”。
学完你会得到什么
- 能说清项目记忆、`CLAUDE.md` 和自动记忆之间的区别。
- 会写一份短、准、可执行的项目规则卡。
- 知道哪些内容该写进记忆，哪些不该写。
开始前你最好知道
- 能进入正确项目目录
- 已经知道会话控制和任务描述的基本节奏
先看这些风险提醒
- 不要把密码、密钥、API Key、私有凭据写进项目记忆。
- 不要把互相矛盾、过长、过散的规则全塞进去。
- 不要把临时想法误当成长期项目约定。
做完怎么验证
- 你能拿出一份最小可用的 `CLAUDE.md` 草稿。
- Claude Code 在读取项目后能更稳定地遵守你的约定。
- 你能分辨“当前会话里说过的话”和“项目长期规则”谁更适合放在哪。
术语引导
建议先认识这些术语
可视化路线
本章路线图
先看结构，再读正文，会更容易把一章真正学会。
- 01第 1 步
区分长期规则与临时需求。
- 02第 2 步
整理项目目标、常用命令和禁区。
- 03第 3 步
写成最小可用的 `CLAUDE.md`。
- 04第 4 步
用一个小任务验证规则是否真的生效。
一句话结论
项目记忆不是万能大脑，而是让 Claude Code 每次进项目时都先看到同一份“项目规则卡”。
项目记忆和当前会话不是一回事
当前会话解决的是“这一次我们在聊什么”；项目记忆（Project Memory）解决的是“这个项目长期遵守什么规则”。
很多新手会把这两者混在一起，结果是：今天说过的话，明天想让它自动记住；或者把长期规则全堆进一次聊天里。更稳的做法是分层：长期的写进记忆，临时的留在会话。
CLAUDE.md 与自动记忆的区别
CLAUDE.md 更像你主动写下来的项目说明卡；自动记忆（Auto Memory）更像 Claude 在工作中自己积累的偏好或提示。
对团队和项目来说，CLAUDE.md 更稳定、可审阅、可共享；自动记忆更偏个人化，不适合承担全部项目规则。
一份好 CLAUDE.md 应该写什么
优先写这几类内容：
- 项目是做什么的
- 常用命令是什么
- 测试和验证习惯是什么
- 哪些目录不要乱碰
- 输出风格或代码习惯有什么固定约定
如果一条内容无法指导行动，就先别写太长。
写得太长为什么反而没用
新手很容易把 CLAUDE.md 写成项目百科全书，但这通常适得其反。
太长意味着重点不突出；规则彼此矛盾时，Claude 也更难稳定执行。项目记忆最重要的特征不是“信息多”，而是“让后续行动更稳定”。
一个适合新手的最小模板
你可以先从最小模板开始：
# 项目说明
- 项目目标：这个仓库主要做什么
- 常用命令：开发、构建、测试各用什么
- 输出要求：文案或代码要遵守什么风格
- 禁止区域：哪些目录或文件不要随便改等你连续用了几次，再慢慢补，而不是一次写满。
不要这样写
不要写“尽量写得更好”“保持专业”这类无法判断的空话。
也不要把今天临时想到的一条偏好立刻写成长期规则。项目记忆应该代表“稳定约定”，不是会话里的灵感收纳箱。
做完本章怎么验证
如果你已经能写出一份最小可用的 CLAUDE.md，并让 Claude Code 在同一个项目里表现得更稳定，那说明项目记忆这章就学会了。
接下来进入第 6 章，你会把“长期规则”再往前推进一步，升级成可复用的命令与技能。
下一步
继续顺着课程主线往下走
学习进度
做完这一章了吗？
你可以把本章标记为已完成，首页和课程列表会记录你的学习进度。