多层级架构

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

概念10 分钟

一、为什么需要了解多层级架构

同一个人可能参与多个项目。每个项目的技术栈、编码规范、协作习惯不同,但一些偏好(回复语言、安全操作习惯)跨项目通用。团队成员之间需要共享项目规范,个人调试配置又不应该提交到共享仓库。

单一的 CLAUDE.md 文件无法同时满足这些需求。多层级架构将不同范围的指令分配到不同的物理位置,由 Claude Code 在会话启动时自动收集并合并。


二、核心内容

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

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,适合存放个人测试服务器地址、调试用环境变量等不应提交到团队仓库的配置。

付费内容

继续阅读完整课程

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

¥199¥399
  • 30 分钟完成第一个真实任务
  • 实战场景 + 深度配置
  • 长期访问,持续更新
CLAUDE.md 完全指南3/7