以 CLAUDE.MD 文件为例说明 AI 代码生成中的作用域控制机制
claude.md 表面上是一个普通的 Markdown 文件，但它的作用并不是给人读的，而是用来约束 AI 写代码的方式。你可以把它理解成一种“行为说明书”，AI 在生成代码时会主动读取它，并尽量按照里面的规则来执行。
根目录的用法¶
当 claude.md 放在项目根目录时，它的作用是覆盖整个项目。无论你在哪个文件夹里写代码，AI 都会参考这份规则。
这更像是一种“全局约定”。比如统一代码风格、统一技术选型、统一命名方式。这些内容一旦写在根目录，就意味着它们对整个工程都生效。
可以理解为：
这是整个项目的“基本法”。
子目录的用法¶
当 claude.md 出现在某个子目录时，它的作用范围就被限制在这个目录内部。AI 在处理这个目录下的代码时，会优先参考这里的规则，而不是根目录的。
这时候它就不再是全局规则，而是“局部约定”。
它可以对某一部分逻辑做更严格或更特殊的限制，比如某个模块必须用特定方案，或者必须遵守额外约束。
可以理解为：
这是某个模块的“内部规定”。
规则之间的关系¶
根目录和子目录之间并不是独立的，它们存在覆盖关系。AI 在工作时，会优先使用离当前代码最近的规则文件。
简单来说就是：
同一个问题，如果子目录里有规则，就用子目录的；
如果没有，再回退到根目录。
对比理解¶
| 维度 | 根目录 claude.md | 子目录 claude.md |
|---|---|---|
| 作用范围 | 整个项目 | 当前目录及其子目录 |
| 角色定位 | 全局规则 | 模块规则 |
| 优先级 | 较低 | 较高 |
| 使用目的 | 保持整体一致性 | 控制局部特殊逻辑 |
| 类比 | 公司制度 | 部门规定 |
本质¶
这套机制的核心不是文件本身，而是“作用域”。
你通过放置 claude.md 的位置，告诉 AI：
哪里需要统一，哪里可以特殊。
于是代码不再只是被写出来的，
而是在规则约束下被生成出来的。