4 CLAUDE.md 记忆文件：让 Claude Code 记住项目规矩
如果只学 Claude Code 的一个习惯，我会选 CLAUDE.md。
因为真正拖慢 AI 编程的，经常不是模型不会写代码，而是它每次都要重新猜你的项目规矩：用 npm 还是 pnpm，测试命令是什么，哪些目录不能碰，生产部署脚本在哪里，接口风格是什么，代码注释要不要中文。
CLAUDE.md 就是把这些项目规矩写下来。Claude Code 会在会话里读取这些记忆，让后续任务更贴近你的项目。
先用 /init 生成初稿
在项目根目录打开 Claude Code 后，可以运行：
/init
官方命令说明里提到，第一次进入仓库可以用 /init 生成一个起步版 CLAUDE.md，再用 /memory 调整。你也可以自己手写，但新手用 /init 更省事，因为它会先根据项目结构整理一版。
生成后不要马上相信。打开文件，逐条改成你真的想长期执行的规则。
一个实用的 CLAUDE.md 模板
我常用的结构大概是这样：
# Project Notes
## Tech stack
- Frontend: Next.js / React / TypeScript
- Styling: Tailwind CSS
- Content: Markdown under content/
## Commands
- Install: npm install
- Dev: npm run dev
- Build: npm run build
## Working rules
- Do not edit .env, keys, certificates, or generated folders.
- Prefer small scoped changes.
- Run build before reporting done.
- Keep unrelated dirty files untouched.
## Content rules
- Chinese articles should be practical and concrete.
- Do not add generic AI filler.
- Keep images under public/images/.
重点不是格式漂亮，而是规则具体。官方 memory 文档也提醒，像“使用 2 空格缩进”这种具体规则，比“代码写好看点”更有用。
什么该写，什么不该写
适合写进 CLAUDE.md 的内容：
- 项目启动、测试、构建命令。
- 目录结构说明。
- 代码风格和命名规则。
- 不允许修改的文件或目录。
- 部署前必须做的验证。
- 常见业务术语。
不适合写进去的内容：
- 密码、API key、服务器登录信息。
- 临时聊天记录。
- 和项目无关的人设。
- 又长又泛的“请认真工作”。
CLAUDE.md 是工程说明书，不是许愿池。越具体越有用。
用 /memory 查看加载情况
你可以在 Claude Code 里运行：
/memory
官方文档说明，/memory 可以查看当前会话加载的 CLAUDE.md、CLAUDE.local.md 和 rules 文件，也可以调整 auto memory。这个功能很适合排查：你明明写了规则，Claude Code 却没按规则做，那就先看它到底有没有加载。
我的建议：项目级和个人级分开
项目规则写在仓库里的 CLAUDE.md，适合团队共享。个人习惯写在用户目录里的配置里，别强行提交到项目。
例如“这个项目用 pnpm，不要 npm install”适合写进项目。
“我喜欢回复中文”这种个人偏好，不一定适合写进团队仓库。
下一篇讲计划模式。复杂需求如果不先拆计划，Claude Code 很容易一口气改多了。
参考资料：
Continue