CLAUDE.md 是什么？
解释 Claude Code 中 CLAUDE.md 的加载位置、适合写什么、不该写什么，以及如何维护项目长期上下文。
CLAUDE.md 是 Claude Code 的项目长期上下文文件。你可以把每次都要重复告诉 Claude 的内容写进去，例如常用命令、目录边界、代码风格、测试要求和交付规则。
最后核查：2026 年 5 月 24 日。Claude Code 现在有多种 memory 和 rules 机制。
CLAUDE.md适合稳定项目规则，不适合塞满临时笔记。
短答案
当你希望 Claude Code 在每次会话里都理解项目规则时，就应该写 CLAUDE.md。它要实用、当前有效，并且足够短。
常见加载位置
| 层级 | 位置 | 用途 | 谁会看到 |
|---|---|---|---|
| 用户指令 | ~/.claude/CLAUDE.md | 所有项目通用的个人偏好。 | 你自己。 |
| 项目指令 | ./CLAUDE.md 或 ./.claude/CLAUDE.md | 项目规则、命令、架构说明。 | 如果提交进仓库，团队成员都会看到。 |
| 本地指令 | ./CLAUDE.local.md | 个人本地说明、sandbox URL、测试数据。 | 你自己，通常 gitignore。 |
| Rules | .claude/rules/*.md | 更细粒度的目录或文件类型规则。 | 取决于仓库策略。 |
可以写什么
# 项目概览
- 主应用在 `src/app`。
- 内容页在 `content/pages`。
# 命令
- Build: `pnpm build`
- Lint: `pnpm lint`
# 规则
- 保留已有 SEO URL，除非明确做迁移。
- 优先使用模板已有 blocks。
- 内容迁移完成前必须跑 build。
# 检查清单
- 检查内部链接。
- 检查暗黑模式。
- 检查移动端布局。不要写什么
- 已经过时的历史说明。
- “做得更好”这种不可执行指令。
- 密钥、API key、客户隐私数据。
- 和 user / project / local 互相冲突的规则。
- 大段官方文档复制粘贴。
维护原则
不是每次出错都写进 CLAUDE.md。只有同类问题重复出现，或者你连续纠正 Claude 两次以上，才值得沉淀成规则。每隔几周读一遍，删掉不再真实的内容。