规则(Rules)
.claude/rules/ 里随 CLAUDE.md 一起加载的说明文件。用图和例子讲清它是什么、怎么运作、怎么用,以及要注意什么。
它是什么
规则是放在 .claude/rules/ 文件夹里的小 文件。不用写一个很长的 CLAUDE.md,而是每个主题一个文件,比如 testing.md 或 security.md,团队更容易保持更新。没有 paths 的规则在每个会话开始时加载,优先级和 .claude/CLAUDE.md 一样。frontmatter 里有 paths 的规则,只在 读、写或改匹配的文件时才加载,所以在需要之前不占空间。
它怎么工作
-
建一个 .claude/rules/ 文件夹
-
每个主题写一个 Markdown 文件
-
加 paths 限定加载时机
-
需要时 Claude 才读它
怎么使用
-
.claude/rules/testing.md一个文件一个主题。
frontend/这样的也可以,因为里面每个.md文件都会被找到。 -
paths写"src/api/**/*.ts"只有 Claude 处理匹配的文件时才加载规则,比如用 Read 或 Edit 工具,或用
cat读那个文件。 -
~/.claude/rules/这台电脑上所有项目通用的个人规则。它们比项目规则先加载。
-
ln -s ~/shared-claude-rules .claude/rules/shared用在多个项目之间共用一套规则。指向项目外面的链接需要你批准一次。
注意
paths 是 在规则里唯一读取的 frontmatter 字段,如果 写坏了,规则会当作没有 paths 来加载。用户规则和项目规则冲突时,Claude 可能照其中任何一个做,所以要让它们保持一致。只在某类任务中才需要的指令,用技能往往更好,因为技能只在被或相关时才加载。
相关术语
原文和官方文档
本页用简单的话解释这个术语。以原文为准:如果两者不同,请按原文。
- 在原文中查看这个术语Claude Code Docs — Glossary Anthropic · 确认于 2026-10-19
- Anthropic — Claude Code docs: How Claude remembers your project — Organize rules with claude/rules/(在新窗口中打开)
- Anthropic — Claude Code docs: How Claude remembers your project — Path specific rules(在新窗口中打开)
- Anthropic — Claude Code docs: How Claude remembers your project — User level rules(在新窗口中打开)
- Anthropic — Claude Code docs: Explore the .claude directory — File reference(在新窗口中打开)