用途:指导编写与维护 CLAUDE.md 与 .claude/rules/,让规则真正被遵循,而非追求面面俱到。CLAUDE.md 作为系统提示之后的用户消息注入,只被阅读和权衡,不被强制执行;必须每次都成立的规则应放进 hook 或权限设置。
加载模型:CLAUDE.md 与 CLAUDE.local.md 在启动时从工作目录及其所有上层目录加载,按文件系统根到当前目录排序;子目录中的文件不在启动时加载,而是在 Claude 读取该目录文件时加载。层级由宽到窄为托管策略、~/.claude/、项目、CLAUDE.local.md;加载顺序不等于优先级,冲突时可能任选其一。@path 导入在启动时展开,最多四层;超过 4 MiB 的文件被整体跳过;块级 HTML 注释会被剥离。可用 /context 的 Memory files 或 InstructionsLoaded hook 确认实际加载内容。
rules 文件:.claude/rules/ 下所有 .md 递归发现;无 paths 的规则按启动优先级加载,带 paths 的规则在 Claude 读取匹配文件时触发,是真正降低基线上下文的方式;~/.claude/rules/ 先于项目规则加载,项目规则优先。插件无法随附规则。
压缩后:项目根 CLAUDE.md 会从磁盘重读并重新注入;嵌套 CLAUDE.md 与 paths 作用域规则不会,需等下次读取相关文件时重载;仅出现在对话中的指令会丢失。
内容归属:通用规则放 CLAUDE.md;按文件类型或路径限定的放 .claude/rules/;某类工作的流程放 skill;必须自动发生的放 hook;权限与环境配置放 settings。
CLAUDE.md 应包含能力地图、技术栈与工具、偏离语言默认值的约定、现在时规则、验证命令、关键约束和易错点;应排除通用最佳实践、严格顺序流程、临时状态、项目历史、目录树和自动化行为。写作要求:指令具体(精确路径、命令名、模式)、只用现在时、操作内容用列表、关键规则放文件首尾、每条规则只写一次。单文件目标 200 行以内,超过时做分类整理,安全关键、易违反、安全敏感的规则无论多罕见都保留。/doctor(v2.1.206 起)可对已入库的 CLAUDE.md 提出精简建议,/init 可生成起始文件。
规则被忽略时按序排查:从未加载、会话中途消失、被噪声淹没、过于模糊、内容过时、跨层矛盾、放错载体。
应用要求:只做外科式编辑,不整体重写;删除或改写规则前先对照代码确认其已过时;审计时先通读全文再逐条对照代码验证,给出具体行号与替换内容。
限制:以上为资料所述机制,实际行为可能依工具版本变化;具体价格与平台支持暂未提供。