路径作用域规则

定义

路径作用域规则（Path-scoped Rules）是 Claude Code .claude/rules/ 下、带有 paths: frontmatter 字段的规则文件：规则只在 Claude 触碰匹配该路径模式的文件时才加载进上下文，而非 session 启动即载。它是"按需加载约束"的机制，用来对抗无作用域规则与 CLAUDE.md 的永久上下文成本。

要点

• 无作用域 vs 有作用域：无 paths: 的规则机械上等同于写进 CLAUDE.md——启动即载、compaction 重注、永远花 token；加上 paths: 后只在相关目录被工作时才进上下文。
• 语法：frontmatter 里列 glob 模式，如 paths: ["src/api/**", "**/*.handler.ts"]，规则正文写约束（"所有 API handler 必须先用 Zod 校验输入"）。
• 压缩行为：与子目录 CLAUDE.md 一致——那个目录不再被触碰时即从上下文消失。
• 适用判据：横切多处（但非全部）的文件级约束。例如"迁移脚本只追加不修改"最适合做成路径作用域规则，而非塞进 CLAUDE.md。

示例

---
paths:
  - "src/api/**"
  - "**/*.handler.ts"
---
所有 API handler 必须先用 Zod 校验输入再处理。

纯文档 session 中，上面这条规则保持沉默、不占上下文。

相关概念

• 指令权威性梯度
• Hooks系统 - 需要确定性强制时，护栏应落在 hooks/permissions 而非规则
• Skills系统
• 上下文压缩

参考资料

• Anthropic, Steering Claude Code: skills, hooks, rules, subagents and more