---
title: "CLAUDE.md (Claude Code)：路径和格式 · DotsAgent"
description: "CLAUDE.md 的存放位置、格式和 front matter，全局副本与嵌套副本的合并方式，以及哪些工具会读取它。核验日期：2026-10-01。"
url: https://dotsagent.io/zh/instructions/files/claude-md
---

CLAUDE.md

# 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`

`CLAUDE.md`

```
@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 排除。

## 可读取该文件的工具

| 工具 | 支持情况 |
| --- | --- |
| [GitHub Copilot](https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions) | 将根目录中的 CLAUDE.md 作为 Agent 指令读取，可替代 AGENTS.md。 |

## 提示

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

通过一个表单，为五种工具生成 AGENTS.md 和对应的规则文件。 [打开 AGENTS.md 生成器 →](https://dotsagent.io/zh/instructions)

## 其他指令文件

[AGENTS.md](https://dotsagent.io/zh/instructions/files/agents-md)

[GEMINI.md](https://dotsagent.io/zh/instructions/files/gemini-md)

[.cursor/rules/*.mdc](https://dotsagent.io/zh/instructions/files/cursor-rules)

[.github/copilot-instructions.md](https://dotsagent.io/zh/instructions/files/github-copilot-instructions)

[.devin/rules/*.md](https://dotsagent.io/zh/instructions/files/windsurf-rules)

[.clinerules/](https://dotsagent.io/zh/instructions/files/cline-rules)

[~/.openclaw/workspace/AGENTS.md](https://dotsagent.io/zh/instructions/files/openclaw-workspace)

## 来源

1. [code.claude.com](https://code.claude.com/docs/en/memory)/docs/en/memory

为 AI agent 开发者提供的独立参考资料。与此处提及的任何厂商均无关联。

© 2026 DotsAgent · 事实核查日期：2026年10月1日