欢迎关注我的CSDN：https://spike.blog.csdn.net/
免责声明：本文来源于个人知识与公开资料，仅用于学术交流，欢迎讨论，不支持转载。
一、层级系统
CLAUDE.md 支持多层级配置，Claude 会自动加载并合并不同层级的指令：
| 层级 | 路径 | 作用范围 |
|---|---|---|
| 全局级 | ~/.claude/CLAUDE.md |
所有项目 |
| 项目级 | ./CLAUDE.md |
整个项目 |
| 子目录级 | ./src/CLAUDE.md |
src 目录 |
| 深度子目录级 | ./src/api/CLAUDE.md |
api 子目录 |
通过这套层级系统，你可以使用引用语法在 CLAUDE.md 中嵌套子目录的完整上下文，实现从粗粒度到细粒度的精准控制。
二、重要性
项目最有价值的 AI 资产
CLAUDE.md 是整个项目最有价值的 AI 配置资产。把它纳入 git 版本控制，与团队共享，让所有人与 Claude 的协作方式保持一致。
自我进化的规则系统
CLAUDE.md 的独特之处在于------Claude 是参与规则编写的一方。其进化路径如下：
Claude 犯错
↓
记录到 CLAUDE.md
↓
下次不再犯同样的错
↓
错误率持续降低从第一条护栏开始写，每次 Claude 犯错就增加一条规则。久而久之，CLAUDE.md 成为项目的"行为记忆"。
情绪调节器
把 CLAUDE.md 当作整个代码库的情绪调节器------它不写业务逻辑，但它决定 Claude 以什么姿态、什么边界来参与项目。
三、常见格式与内容
一份好的 CLAUDE.md 通常包含以下几类内容：
- 聚焦范围：明确 Claude 应关注哪些模块
- 开发规范：分支命名、提交信息格式等
- 代码风格：缩进、命名约定、文件结构
- 常见规范：测试要求、错误处理原则
- 重要程度标注：哪些内容是核心约束，哪些是参考建议
个人偏好的存放位置
个人专属的偏好配置，建议存放在：
~/.claude/projects/{项目ID}/memory/这样可以与团队共享的项目级 CLAUDE.md 区分开，避免个人习惯干扰团队协作。
四、编写原则
1. 从空文件开始
CLAUDE.md 从空文件起步，每次 Claude 犯错就增加一条规则，而不是一开始就写满所有约束。
2. 保持精简
文件要轻、要简。避免把 CLAUDE.md 写成一本手册------它的目标是关键约束，而非详尽文档。
3. 列明边界，绝不逾越
对于不允许 Claude 擅自修改的部分，明确列出文件路径和变量名，并注明"未经授权不得改写"。这是防止 Claude 进行不必要重构的最有效手段。
4. 放入 git，与团队共享
CLAUDE.md 是团队协作的一部分。提交到版本库，让每位成员、每次 CI 运行都能受益于积累下来的规则。
5. 持续维护
CLAUDE.md 需要自己主动维护。定期回顾，移除过时的规则，补充新的约束，让它始终反映项目的真实状态。
五、一句话总结
CLAUDE.md 从一个空文件开始，每次 Claude 犯错就加一条规则，保持精简，放入 git 与团队共享，这就是项目最有价值的 AI 资产。