CLAUDE.md (Claude Code): lokasi dan cara tool membacanya

CLAUDE.md adalah file memori yang dimuat Claude Code saat mulai dari direktori home, proyek, dan setiap folder induk. Aturan dengan cakupan path di .claude/rules/ memberikan panduan yang hanya dimuat saat file yang cocok dibaca.

Lokasi

• Proyek: ./CLAUDE.md atau ./.claude/CLAUDE.md, di-commit dan dibagikan dengan tim.
• Lokal: ./CLAUDE.local.md, untuk catatan pribadi yang tidak disertakan di git.
• Pengguna: ~/.claude/CLAUDE.md, berlaku untuk setiap proyek.
• Aturan: ./.claude/rules/**/*.md dan ~/.claude/rules/**/*.md, dengan cakupan opsional melalui frontmatter paths.
• Kebijakan terkelola: /Library/Application Support/ClaudeCode/CLAUDE.md di macOS, C:\Program Files\ClaudeCode\CLAUDE.md di Windows, atau kunci claudeMd di managed-settings.json.

Format

Markdown. File di .claude/rules/ dapat diawali YAML frontmatter dengan kunci paths yang berisi daftar glob. Sertakan file lain dengan @path/to/file, hingga kedalaman 4 tingkat; tidak ada batas ukuran pasti yang terdokumentasi, tetapi Anthropic menyarankan agar setiap file tidak lebih dari 200 baris.

Kunci 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/.

Prioritas dan penggabungan

Tidak ada file yang menimpa file lain: semua file yang ditemukan digabungkan. Kebijakan terkelola dimuat lebih dulu, lalu file dari root sistem file hingga direktori peluncuran, sehingga file yang lebih dekat dibaca belakangan; dalam direktori yang sama, CLAUDE.local.md dimuat setelah CLAUDE.md. File di subdirektori dimuat sesuai kebutuhan saat Claude membaca file di sana, dan kebijakan terkelola tidak dapat dikecualikan dengan claudeMdExcludes.

Tool yang membacanya

Tips

• Jika Anda menggunakan CLAUDE.md, awali dengan @AGENTS.md; jika tidak, Claude Code akan mengabaikan AGENTS.md dengan setelan default.
• Pindahkan panduan khusus area ke .claude/rules/ dan gunakan frontmatter paths agar panduan hanya dimuat untuk file yang sesuai.
• Impor membantu merapikan file, tetapi tetap menggunakan konteks karena teks yang diimpor juga dimuat.
• Jalankan /doctor untuk memeriksa CLAUDE.md, CLAUDE.local.md, AGENTS.md, rules, dan skills sekaligus.

File instruksi lainnya