CLAUDE.md (Claude Code)：存放位置及工具读取方式

CLAUDE.md 是 Claude Code 在启动时从主目录、项目目录和所有父目录加载的记忆文件。.claude/rules/ 中按路径限定的规则会提供额外指引，仅在读取匹配的文件时加载。

存放位置

• 项目级：./CLAUDE.md 或 ./.claude/CLAUDE.md，提交到版本库并与团队共享。
• 本地：./CLAUDE.local.md，用于存放不纳入 git 的个人备注。
• 用户级：~/.claude/CLAUDE.md，适用于每个项目。
• 规则：./.claude/rules/**/*.md 和 ~/.claude/rules/**/*.md，可通过 paths frontmatter 限定适用路径。
• 托管策略：macOS 上的 /Library/Application Support/ClaudeCode/CLAUDE.md、Windows 上的 C:\Program Files\ClaudeCode\CLAUDE.md，或 managed-settings.json 中的 claudeMd 键。

格式

Markdown。.claude/rules/ 中的文件可以 YAML frontmatter 开头，其中 paths 键用于列出 glob 模式。使用 @path/to/file 引入其他文件，最多支持 4 层嵌套；目前没有文档说明硬性大小限制，但 Anthropic 建议每个文件控制在 200 行以内。

Front matter 键： paths

@AGENTS.md

# Claude Code notes

- Run `pnpm test` after every change under src/.
- Use the `gh` CLI for issues and pull requests.
- Ask before adding a dependency.

## API

- Error format is described in @docs/api-errors.md.
- One handler file per route in src/api/.

优先级与合并

文件之间不会相互覆盖：所有找到的文件都会串联起来。先加载托管策略，再从文件系统根目录逐层加载到启动目录，因此路径越近的文件越晚读取；同一目录中，CLAUDE.local.md 在 CLAUDE.md 之后读取。Claude 在读取子目录中的文件时，会按需加载该目录中的文件；托管策略无法通过 claudeMdExcludes 排除。

可读取该文件的工具

提示

• 如果保留 CLAUDE.md，请在文件开头加入 @AGENTS.md；否则，在默认设置下 Claude Code 会忽略 AGENTS.md。
• 将特定区域的指导内容移到 .claude/rules/ 中，并使用 paths frontmatter，让它仅在处理匹配的文件时加载。
• 导入可以让文件结构更清晰，但仍会占用上下文，因为导入的文本也会加载。
• 运行 /doctor，一次性检查 CLAUDE.md、CLAUDE.local.md、AGENTS.md、rules 和 skills。

其他指令文件