4 CLAUDE.md 记忆文件：让 Claude Code 记住项目规矩

查看大图

如果只学 Claude Code 的一个习惯，我会选 CLAUDE.md。

因为真正拖慢 AI 编程的，经常不是模型不会写代码，而是它每次都要重新猜你的项目规矩：用 npm 还是 pnpm，测试命令是什么，哪些目录不能碰，生产部署脚本在哪里，接口风格是什么，代码注释要不要中文。

CLAUDE.md 就是把这些项目规矩写下来。Claude Code 会在会话里读取这些记忆，让后续任务更贴近你的项目。

CLAUDE.md 里最有价值的不是口号，而是项目真实规则：哪些目录不能碰，哪条命令能验证，发布前要看什么，哪些业务逻辑要特别谨慎。

查看大图

我会把它当成项目交接文档来写。一个新同事第一次进仓库需要知道什么，Claude Code 也需要知道什么。这样记忆文件才不会变成装饰。

先用 /init 生成初稿

在项目根目录打开 Claude Code 后，可以运行：

查看大图

维护项目记忆文件时，优先写清项目结构、测试命令、禁止修改范围、提交格式和部署方式。后续任务才能保持一致。

/init

官方命令说明里提到，第一次进入仓库可以用 /init 生成一个起步版 CLAUDE.md，再用 /memory 调整。你也可以自己手写，但新手用 /init 更省事，因为它会先根据项目结构整理一版。

生成后不要马上相信。打开文件，逐条改成你真的想长期执行的规则。

一个实用的 CLAUDE.md 模板

我常用的结构大概是这样：

查看大图

学《CLAUDE.md 记忆文件：让 Claude Code 记住项目规...》时，可以先找一个自己能复现的小场景，再看相关概念和练习步骤，读完后用自己的例子复述一遍。

# 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，适合团队共享。个人习惯写在用户目录里的配置里，别强行提交到项目。

查看大图

读完《CLAUDE.md 记忆文件：让 Claude Code 记住项目规矩》后，可以先挑一个小样例走完整流程，再判断哪些步骤已经能独立完成。

查看大图

读到这里，可以把《CLAUDE.md 记忆文件：让 Claude Code 记住项目规矩》整理成一张复盘表：先说清主线，再拿一个小任务检查结果。

例如“这个项目用 pnpm，不要 npm install”适合写进项目。
“我喜欢回复中文”这种个人偏好，不一定适合写进团队仓库。

下一篇讲计划模式。复杂需求如果不先拆计划，Claude Code 很容易一口气改多了。

参考资料：

• How Claude remembers your project
• Explore the .claude directory
• Claude Code Commands