一、为什么需要了解多层级架构
同一个人可能参与多个项目。每个项目的技术栈、编码规范、协作习惯不同,但一些偏好(回复语言、安全操作习惯)跨项目通用。团队成员之间需要共享项目规范,个人调试配置又不应该提交到共享仓库。
单一的 CLAUDE.md 文件无法同时满足这些需求。多层级架构将不同范围的指令分配到不同的物理位置,由 Claude Code 在会话启动时自动收集并合并。
二、核心内容
四个作用域层级的触发行为
Claude Code 启动时自动加载四个层级的 CLAUDE.md,加上惰性加载的子目录级,共五个作用域:
托管策略级由组织 IT/DevOps 部署,个人用户通常不需要创建。它的作用是确保组织范围内的合规性指令(安全策略、审计要求等)强制生效。
CLAUDE.local.md 是项目级的个人覆盖层。文件创建后自动加入 .gitignore,适合存放个人测试服务器地址、调试用环境变量等不应提交到团队仓库的配置。