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。frontmatter の paths で適用範囲を指定できます。
• 管理ポリシー: macOS では /Library/Application Support/ClaudeCode/CLAUDE.md、Windows では C:\Program Files\ClaudeCode\CLAUDE.md、または managed-settings.json の claudeMd キー。

形式

Markdown。.claude/rules/ 内のファイルは、paths キーに glob パターンを指定する YAML frontmatter で始められます。@path/to/file でほかのファイルを読み込めます（最大 4 階層）。明確なサイズ上限は記載されていませんが、Anthropic はファイルあたり 200 行未満を推奨しています。

Frontmatterのキー: 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 をまとめて監査できます。

その他の指示ファイル