多层级架构

CLAUDE.md 配置体系的多层指令分发系统,让不同范围的指令各归其位、自动叠加生效

概念10 分钟

一、核心内容

四个作用域层级的触发行为

Claude Code 启动时自动加载四个层级的 CLAUDE.md,加上惰性加载的子目录级,共五个作用域:

作用域文件位置加载时机版本控制
托管策略级(Managed)macOS: /Library/Application Support/ClaudeCode/CLAUDE.md;Linux: /etc/claude-code/CLAUDE.md启动时自动加载,不可排除组织 IT 管理
项目级(Project)./CLAUDE.md./.claude/CLAUDE.md启动时自动加载Git 跟踪,团队共享
CLAUDE.local.md./CLAUDE.local.md启动时自动加载自动 gitignore,仅个人
用户级(User)~/.claude/CLAUDE.md启动时自动加载,所有项目生效个人文件
子目录级(Subdirectory)子目录中的 CLAUDE.mdClaude 读取该子目录文件时按需加载取决于目录位置

托管策略级由组织 IT/DevOps 部署,个人用户通常不需要创建。它的作用是确保组织范围内的合规性指令(安全策略、审计要求等)强制生效。

CLAUDE.local.md 是项目级的个人覆盖层。文件创建后自动加入 .gitignore,适合存放个人测试服务器地址、调试用环境变量等不应提交到团队仓库的配置。

子目录级的加载是惰性的——Claude Code 启动时不会主动遍历所有子目录。只有当 Claude 在工作过程中读取了某个子目录中的文件,该子目录的 CLAUDE.md 才会加载。这对 monorepo 中为不同子项目配置独立指令很有用。

合并与优先级规则

所有找到的 CLAUDE.md 文件内容叠加注入上下文——不是按 key 覆盖替换,而是全部共存。Claude 同时看到所有层级的指令。

付费内容

继续阅读完整课程

购买后即可解锁全部 16 个功能模块、实战场景与深度配置。

¥199¥399
  • 30 分钟完成第一个真实任务
  • 实战场景 + 深度配置
  • 无需续费,持续更新