关于Claude.md，你需要知道

CLAUDE.md 文件组是指令记忆的核心载体。你可以把它理解为 AI 的行为准则手册。但跟你想的不一样的是，这不是一个单一的文件，而是一套有着严格优先级体系的多层加载系统。

加载的记忆机制是基于一种特殊的双轨注入实现的，并非通过 system prompt 注入模型提示词的。

通道 A 负责注入指令记忆，也就是 CLAUDE.md 那些内容。它走的是对话消息通道，具体来说是作为对话列表的第一条 user message 注入的，用 system-reminder 标签包裹。注意，它不是放在 system prompt 数组里的。指令记忆对应的是用户写的、内容多变的、需要频繁更新的内容。

通道 B 负责注入 memory 的行为规范，是系统内建的、相对稳定的，具体讲包含告诉模型记忆类型有哪些、怎么保存、怎么召回。这些操作指引，才是真正放在 system prompt 数组里的，通过一个叫 system-prompt-section 的函数注入。通道 B 的内容，整个会话只计算一次就缓存下来了

放在不同的注入通道里，不仅在缓存策略上可以独立管理，而且在 token 预算分配上也更灵活。

四层优先级

从加载claude 的角度来看，一共有四层优先级，从低到高分别是：

第一层：managed。 路径在 /etc 下的 Claude Code 目录里的 CLAUDE.md。这是全局策略，通常由组织管理员设定，所有用户都适用。

第二层：user。 在你的个人目录、home 目录下的 .claude 里的 CLAUDE.md。这是你的私有全局指令，跨所有项目生效。

第三层：project。 就是项目根目录下的 CLAUDE.md。这个是检入代码库的、团队共享的项目级指令。

第四层：local。 CLAUDE.local.md，这是你的私有项目指令，不会检入版本控制。

这里最值得注意的是它的加载顺序。系统从 CWD 也就是当前工作目录，向根目录遍历，收集所有文件，然后反转顺序，变成从根到 CWD 的顺序处理。这意味着，离你当前工作目录越近的规则文件加载越靠后，模型对它的关注度就越高。换句话说，最后加载的规则优先级最高。

这个设计非常巧妙，它既保证了全局策略的基础约束力，又给了每个项目甚至每个子目录足够的灵活性。

三种扩展机制

除了基本的加载逻辑，指令记忆还支持三种扩展机制：

第一种：@include 递归包含。 你可以在一个 CLAUDE.md 里用 @ 语法引用其他文件，最多递归五层深度，还有循环检测，防止无限递归。这样你就可以把指令模块化组织，而不是把所有规则堆在一个大文件里。

第二种：条件规则。 你可以在 .claude/rules 目录下放规则文件，通过 front matter 里的 path 字段指定，这条规则只在访问特定路径时才生效。比如你可以写一条规则说，只有在操作 src/components 目录下的文件时，才应用这套 React 组件规范。匹配引擎用的是 picomatch，支持完整的 glob 语法。

第三种：嵌套记忆附件。 当工具访问 CWD 子目录中的文件时，系统会自动加载该目录链上的额外规则。

这个设计能够对模型上下文进行一个良好的控制，避免一次性将所有内容加入上下文。

\