一、核心内容
四个作用域层级的触发行为
Claude Code 启动时自动加载四个层级的 CLAUDE.md,加上惰性加载的子目录级,共五个作用域:
托管策略级由组织 IT/DevOps 部署,个人用户通常不需要创建。它的作用是确保组织范围内的合规性指令(安全策略、审计要求等)强制生效。
CLAUDE.local.md 是项目级的个人覆盖层。文件创建后自动加入 .gitignore,适合存放个人测试服务器地址、调试用环境变量等不应提交到团队仓库的配置。
子目录级的加载是惰性的——Claude Code 启动时不会主动遍历所有子目录。只有当 Claude 在工作过程中读取了某个子目录中的文件,该子目录的 CLAUDE.md 才会加载。这对 monorepo 中为不同子项目配置独立指令很有用。
合并与优先级规则
所有找到的 CLAUDE.md 文件内容叠加注入上下文——不是按 key 覆盖替换,而是全部共存。Claude 同时看到所有层级的指令。