Praktik Terbaik CLAUDE.md: 9 Aturan Agar Claude Tidak Mengabaikan Anda (2026)

Praktik Terbaik CLAUDE.md: 9 Aturan yang Membuat Claude Berhenti Mengabaikan Anda (2026)

Sebagian besar artikel praktik terbaik CLAUDE.md hanya memberi Anda sebuah template lalu selesai, padahal file yang Anda tulis minggu lalu kemungkinan besar sudah diabaikan, dan Anda tidak tahu alasannya. Solusinya jarang berupa "tambahkan lebih banyak aturan." Biasanya justru sebaliknya. Kami telah menerapkan Claude Code di setiap proyek klien terbaru kami, dan 9 aturan inilah yang benar-benar memberikan dampak nyata: hierarki yang sesuai dengan cara Claude memuat file, anggaran instruksi yang tidak boleh Anda langgar, keputusan soal AGENTS.md, serta enam alasan mengapa Claude diam-diam mengabaikan file Anda di tengah sesi.

Poin-Poin Penting

• CLAUDE.md adalah memori proyek yang dimuat ke dalam konteks Claude Code, jaga agar tetap di bawah 200 baris atau aturan akan mulai terabaikan.
• File dimuat dari atas ke bawah: global, root proyek, subdirektori (lazy), dan CLAUDE.local.md (pribadi, di-gitignore).
• Gunakan AGENTS.md jika Anda juga menjalankan Cursor atau Copilot; buat symlink CLAUDE.md ke AGENTS.md untuk menargetkan keduanya.
• Jika Claude mengabaikan file Anda, 90% penyebabnya adalah panjang file, ketidakjelasan, atau tidak adanya "alasan."

Apa Fungsi CLAUDE.md Sebenarnya (Dan Mengapa Itu Penting)

Singkatnya: CLAUDE.md adalah file markdown yang dibaca Claude Code sebagai memori proyek di awal setiap sesi. Ini bukan system prompt, hook, atau skill, melainkan konteks penasihat yang mengarahkan Claude pada konvensi tim Anda. Anggaplah ini bukan sebagai dokumentasi, melainkan sebagai file konfigurasi yang benar-benar dibaca oleh AI pair programmer Anda.

Banyak tim menulis CLAUDE.md seperti README. Itulah kesalahan pertama. README menjelaskan proyek kepada manusia yang bisa membaca cepat dan melewatkan bagian tertentu. CLAUDE.md dikonsumsi secara keseluruhan oleh Claude Code di awal sesi, setiap barisnya menghabiskan token dan kepatuhan. Ini jauh lebih mirip file konfigurasi atau sekumpulan test fixture daripada dokumentasi.

Ini juga bukan satu-satunya cara untuk mengarahkan Claude. Hook menjalankan tindakan deterministik (formatting, memblokir commit). Skill membundel alur kerja yang dapat digunakan kembali. CLAUDE.md berada di antaranya sebagai konteks penasihat, Claude mengevaluasinya, terkadang mengesampingkannya, dan pasti melupakan sebagian isinya jika Anda menulis terlalu banyak. Perbedaan itulah yang menjadi dasar bagi semua hal di bawah ini, dan itulah mengapa CLAUDE.md adalah salah satu alat dalam praktik rekayasa konteks yang lebih luas, bukan solusi ajaib.

Aturan #1: Perlakukan seperti kode, bukan dokumentasi. Beri versi. Tinjau dalam PR. Pangkas sebagaimana Anda merefactor modul yang membengkak. Menurut panduan CLAUDE.md Anthropic, file ini dimuat dengan prioritas yang sama seperti instruksi sistem mana pun, yang berarti aturan usang dari enam bulan lalu masih secara aktif membentuk setiap respons saat ini.

Cara CLAUDE.md Dimuat: Hierarki 4 Tingkat

Singkatnya: Claude Code memuat CLAUDE.md dari empat tingkat: global (~/.claude/CLAUDE.md), root proyek, CLAUDE.local.md untuk override pribadi, dan file subdirektori yang dimuat secara lazy hanya saat Claude membaca file di dalam direktori tersebut. Subdirektori sibling tidak pernah saling melihat CLAUDE.md satu sama lain, sehingga memori claude code tetap memiliki cakupan yang ketat.

Hierarki ini adalah bagian yang paling sering disalahpahami dari CLAUDE.md, dan di bagian inilah 0 dari 5 hasil SERP teratas membahasnya secara mendalam. Berikut yang sebenarnya terjadi di balik layar:

Dua istilah yang perlu dipahami: lazy loading dan isolasi sibling.

Lazy loading berarti CLAUDE.md di subdirektori tidak masuk ke konteks Claude sampai Claude benar-benar membuka file di dalam direktori tersebut. Jika Anda meminta "perbaiki bug login" dan Claude hanya menyentuh backend/, maka frontend/CLAUDE.md Anda tidak akan pernah dimuat. Ini hal yang baik, karena menjaga context window tetap bersih, tetapi ini menjadi masalah bagi tim yang menaruh aturan penting di subdirektori dengan harapan aturan tersebut selalu berlaku.

Isolasi sibling adalah konsekuensinya: frontend/CLAUDE.md dan backend/CLAUDE.md tidak pernah saling memuat. Keduanya hanya berbagi apa yang ada di root proyek. Jadi jika aturan frontend Anda bertentangan dengan aturan backend, itu tidak masalah. Jika keduanya perlu berbagi konvensi, naikkan ke file root.

CLAUDE.local.md adalah jalan keluarnya. File ini dimuat tetapi tidak di-commit, cocok untuk override gaya "saya lebih suka pnpm tetapi tim menstandarkan pada npm". Masalahnya: file ini tidak otomatis di-gitignore. Anda harus menambahkannya sendiri. Lupa melakukannya dan Anda akan meng-commit aturan pribadi Anda ke repo tim. Aturan #4: Sesuaikan instruksi dengan tempat Claude benar-benar membacanya. Aturan gaya untuk komponen React seharusnya berada di frontend/CLAUDE.md, bukan di root. Aturan migrasi database seharusnya berada di backend/. Dokumentasi Anthropic Memory (diperbarui November 2025) mengonfirmasi hal ini, perilaku lazy-load memang disengaja dan menjadi bagian penting yang menopang sistem.

Apa yang Perlu Ditulis di Dalam CLAUDE.md (Dan Apa yang Harus Ditinggalkan)

Singkatnya: Di dalam CLAUDE.md, masukkan apa pun yang tidak bisa disimpulkan Claude dari kode Anda: perintah build, konvensi penamaan, anti-pattern yang pernah membuat tim Anda terjebak, dan alasan di balik setiap aturan. Yang tidak perlu dimasukkan adalah apa pun yang sudah ada di README, apa pun yang ada di package.json, serta aturan apa pun yang berubah setiap minggu. instruksi claude code harus dapat diuji dan spesifik.

Berikut adalah CLAUDE.md minimalis yang benar-benar berguna:

# Proyek: techsy-app
## Perintah
- Build: `pnpm build` (Turbopack — flag Webpack tidak berlaku)
- Test: `pnpm test --run` (kami menggunakan Vitest, bukan Jest)
- Lint: `pnpm lint` (akan menggagalkan CI jika ada peringatan, bukan hanya error)
## Konvensi
- Komponen server secara default. Tambahkan `'use client'` hanya jika benar-benar diperlukan.
  Alasannya: LCP kami sempat mencapai 8 detik pada kuartal lalu akibat terlalu banyak client component.
- Akses database hanya melalui helper di `lib/db/` — jangan pernah menulis SQL mentah di route.
  Alasannya: kebijakan keamanan tingkat baris (row-level security) berada di dalam helper-helper tersebut.
- File test ditempatkan berdampingan sebagai `*.test.ts` di sebelah file yang diuji.
## Yang Tidak Boleh Dilakukan
- Jangan menambahkan dependensi baru tanpa membuka komentar PR terlebih dahulu.
- Jangan gunakan `any` — gunakan `unknown` lalu persempit tipenya.
## Tempat untuk Mencari
- Skema: `db/schema.ts`
- Alur autentikasi: `lib/auth/README.md`

Now compare that to the anti-pattern version most teams ship:

# Aturan Proyek

- Tulis kode yang bersih dan mudah dipelihara.
- Ikuti praktik terbaik.
- Gunakan TypeScript dengan benar.
- Pastikan semua tes lolos.
- Konsisten dengan pola yang sudah ada.
- Dokumentasikan logika yang kompleks.

File kedua tidak salah. Hanya saja tidak berguna. Claude sudah ingin menulis kode yang bersih. "Konsisten" tidak memberi tahu Claude pola mana yang harus diikuti. Contoh-contoh publik dari engineer Anthropic, Boris Cherny, sangat condong ke gaya pertama: perintah konkret, nama tool yang jelas, dan alasan di balik keputusan yang tidak terlihat langsung dari codebase.

Aturan #2: Jadilah spesifik, bukan aspiratif. "Tulis kode yang bersih" itu aspiratif. "Server components secara default; tambahkan 'use client' hanya jika benar-benar diperlukan" itu bisa diuji. Disiplin yang sama juga menjadi fondasi prompt engineering yang baik: instruksi yang spesifik dan bisa diuji mengalahkan aspirasi yang samar, baik di dalam prompt maupun di CLAUDE.md.

Aturan #3: Jelaskan mengapa setiap aturan penting. "Mengapa" bukan sekadar pelengkap—ia adalah cara Claude memutuskan kasus-kasus batas. Aturan yang disertai alasan ("kami mengalami LCP 8 detik karena terlalu banyak client component") bisa digeneralisasi ke situasi serupa. Aturan tanpa alasan akan diabaikan begitu konteks berubah. Pola ini juga didokumentasikan dalam panduan CLAUDE.md dari Builder.io.

Mengapa Claude Mengabaikan CLAUDE.md Anda? Anggaran Instruksi

Singkatnya: Claude tidak berniat jahat, ia hanya kehabisan perhatian. Setelah sekitar 80 baris, Anda akan mulai menyadari aturan-aturan yang terlewat; setelah 200 baris, blok-blok besar akan diabaikan sepenuhnya; setelah 500 kata aturan yang padat, kepatuhan runtuh. Solusinya adalah anggaran instruksi. Perlakukan setiap baris sebagai biaya terhadap claude code memory dan kepatuhan per aturan.

Riset terbaru mengonfirmasi apa yang terus ditemukan oleh para pengguna di produksi: kemampuan mengikuti instruksi menurun secara non-linear seiring bertambahnya jumlah aturan. Makalah arxiv 2507.11538 tentang kapasitas mengikuti instruksi menunjukkan bahwa kepatuhan per aturan menurun saat Anda menumpuk lebih banyak aturan, dan analisis HumanLayer terhadap CLAUDE.md di lingkungan produksi juga menggemakan temuan yang sama.

Artinya: setiap aturan yang Anda tambahkan membuat setiap aturan lain sedikit lebih kecil kemungkinannya untuk diikuti. Jadi CLAUDE.md 400 baris bukan 4 kali lebih efektif daripada yang 100 baris. Justru sering kali kurang efektif, karena aturan yang benar-benar Anda pedulikan menjadi encer oleh aturan yang Anda tulis di hari Jumat tiga bulan lalu dan tidak pernah dihapus.

Dalam file CLAUDE.md kami, apa pun yang melewati baris 150 mulai terlihat kehilangan kepatuhan. Pada baris 250, kami pernah melihat Claude melewati seluruh bagian. Jadi kami membatasinya.

wc -l CLAUDE.md

Itu saja alatnya. Jalankan. Jika Anda melebihi 200, Anda sudah melebihi anggaran. Aturan keras yang kami terapkan untuk klien:

Perlakukan CLAUDE.md seperti anggaran 200 baris. Setiap baris memakan kepatuhan. Belanjakan di tempat yang penting.

Aturan #1 diperkuat: Jaga agar tetap singkat. Di bawah 200 baris. Di bawah 500 kata aturan yang padat. Jika Anda merasa ingin menambahkan aturan otomatisasi ("selalu jalankan prettier setelah mengedit"), aturan-aturan itu sebaiknya masuk ke hook Claude Code saja, hook bersifat deterministik dan tidak memakan token anggaran instruksi.

Haruskah Anda Menggunakan CLAUDE.md, AGENTS.md, .cursorrules, atau copilot-instructions?

Singkatnya: Jika Anda hanya menggunakan Claude Code, CLAUDE.md sudah cukup. Jika Anda menggunakan dua atau lebih CLI agen (Codex, Cursor, Copilot, Sourcegraph), beralihlah ke AGENTS.md dan buat symlink CLAUDE.md ke AGENTS.md. AGENTS.md muncul pada akhir 2025 sebagai standar lintas alat, dan sebagian besar agen modern menggunakannya sebagai fallback, sehingga satu file dapat melayani seluruh ekosistem.

Inilah pertanyaan nomor 0 yang benar-benar dijawab oleh 5 hasil teratas. Berikut matriksnya:

Trik target ganda ini hanya satu baris:

ln -s AGENTS.md CLAUDE.md

Itu saja. Kini Claude Code, Codex, dan semua alat yang mendukung AGENTS.md membaca file yang sama. Perbarui sekali, setiap agen langsung mengikutinya. Spesifikasi AGENTS.md bersifat terbuka dan memang dibuat minimal, isinya hanya markdown dengan bagian-bagian konvensional.

Ada dua kendala di dunia nyata. Pertama: jika tim Anda memiliki pengguna berat Cursor, .cursorrules milik Cursor mengambil pendekatan berbeda, satu file, tanpa hierarki, format yang lebih kaku. Beberapa tim mempertahankan keduanya: AGENTS.md untuk aturan bersama, .cursorrules untuk kekhasan khusus Cursor. Kedua: .github/copilot-instructions.md milik Copilot tidak melakukan fallback ke AGENTS.md, sehingga tim yang sangat bergantung pada Copilot memerlukan file terpisah.

Jika Anda memilih tumpukan agen dari nol, ulasan Claude Code vs Cursor vs Copilot kami membahas berbagai pertukaran di tingkat penggunaan. Versi singkatnya: hierarki Claude Code adalah yang paling andal untuk monorepo, UX Cursor unggul untuk pekerjaan solo, dan integrasi IDE Copilot masih yang paling mulus untuk adopsi bertahap.

Aturan #9: Gunakan AGENTS.md jika Anda menjalankan lebih dari satu CLI agen. Jangan memelihara dua file yang isinya sama. Pilih file yang dibaca oleh sebagian besar tumpukan Anda, lalu buat symlink untuk sisanya.

CLAUDE.md vs Hooks vs Skills: Segitiga Keputusan

Singkatnya: CLAUDE.md = konteks advis. Hooks = aksi deterministik. Skills = kemampuan yang dibundel. Salah pilih dan Anda akan membakar anggaran instruksi untuk sesuatu yang seharusnya ditangani hook, atau menulis aturan CLAUDE.md untuk sesuatu yang hanya bisa diberikan oleh skill. Segitiga ini adalah cara termurah untuk menjaga CLAUDE.md tetap ringkas.

Tiga alat, tiga tugas. Kesalahan yang paling sering kami lihat: menaruh "selalu jalankan prettier setelah mengedit" di CLAUDE.md. Claude membacanya. Claude kadang-kadang menjalankan prettier. Anda frustrasi. Solusinya adalah memindahkan baris itu keluar dari CLAUDE.md dan ke dalam hook, karena hook menyala secara deterministik setiap saat, tanpa ruang kompromi advis.

Jika sebuah aturan harus selalu menyala, itu milik hook. Jika itu preferensi gaya yang bisa dievaluasi Claude terhadap konteks, itu milik CLAUDE.md. Jika itu alur kerja multi-langkah dengan aset yang dibundel (template, skrip, prompt), itu milik skill.

Aturan #8: Pilih CLAUDE.md vs hooks vs skills dengan benar, menaruh hook di CLAUDE.md adalah pemborosan anggaran instruksi yang paling umum. Konfigurasikan aksi deterministik dengan hook Claude Code dan kemas alur kerja yang dapat digunakan ulang sebagai skill Claude. CLAUDE.md Anda menjadi lebih pendek, pagar pengaman Anda menjadi lebih kokoh, dan Claude berhenti "melupakan" aturan-aturan yang penting.

Pola Monorepo: CLAUDE.md Bersarang, @imports, dan .claude/rules/

Singkatnya: Dalam sebuah monorepo, jaga agar CLAUDE.md di root tetap kecil, hanya berisi penunjuk dan konvensi bersama. Dorong detail spesifik ke apps/*/CLAUDE.md agar setiap subtree memiliki aturan sesuai cakupannya. Gunakan @imports untuk berbagi file aturan modular melalui .claude/rules/. Inilah pengungkapan progresif—Claude mengambil setiap bagian hanya saat relevan.

Pohon CLAUDE.md monorepo yang umum:

.
├── CLAUDE.md                        # 30 lines — points to subdirs and shared rules
├── .claude/
│   └── rules/
│       ├── style.md
│       ├── testing.md
│       └── security.md
├── apps/
│   ├── web/
│   │   └── CLAUDE.md                # Next.js-specific rules
│   └── api/
│       └── CLAUDE.md                # Fastify-specific rules
└── packages/
    └── shared/
        └── CLAUDE.md                # Library author rules

Sintaks @import memungkinkan file root menarik potongan aturan bersama tanpa perlu mengulanginya:

# CLAUDE.md Root

Ini adalah Turborepo. Lihat CLAUDE.md di subdirektori untuk aturan khusus aplikasi.

@import .claude/rules/style.md
@import .claude/rules/testing.md
@import .claude/rules/security.md
## Perintah tingkat atas
- `pnpm dev` menjalankan semua aplikasi secara paralel
- `pnpm test` menjalankan skrip pengujian di setiap workspace

Ini adalah progressive disclosure dalam praktiknya. File root-nya adalah pointer sepanjang 30 baris. CLAUDE.md di setiap subdirektori menambahkan 50–80 baris aturan yang terfokus. File .claude/rules/ menyimpan potongan konvensi yang dapat ditarik oleh beberapa subdirektori. Tidak ada yang terduplikasi, tidak ada yang terlewat, dan tidak ada satu pun file yang melampaui anggaran instruksi.

Aturan lazy-loading dari sebelumnya menjadi lebih penting di sini: ketika Claude mengerjakan apps/web/Button.tsx, ia melihat file root ditambah apps/web/CLAUDE.md ditambah file aturan yang di-@import. Ia tidak melihat apps/api/CLAUDE.md. Itulah intinya, konvensi backend tidak mencemari konteks frontend, dan context window Anda tetap dapat digunakan.

Aturan #6: Gunakan @import agar file root tetap di bawah 200 baris. Panduan Praktik Terbaik Anthropic untuk Claude Code memperlakukan ini sebagai pola monorepo standar. Subagent juga mewarisi konteks CLAUDE.md induk, yang perlu diketahui jika Anda menyusun workflow bertingkat, lihat rekayasa konteks untuk bagaimana hal itu berinteraksi dengan desain subagent.

6 Alasan Claude Mengabaikan File Anda (Dan Solusi untuk Masing-Masing)

Singkatnya: Ketika Claude mengabaikan CLAUDE.md, hampir selalu karena salah satu dari enam penyebab: file terlalu panjang, frasa yang samar, hilangnya penjelasan "mengapa", pemadatan konteks, konflik dengan file induk, atau nama file yang salah. Masing-masing punya solusi 60 detik. Uji di sesi baru setelah setiap perubahan, itulah Aturan #7.

1. File terlalu panjang (>200 baris / >500 kata)

Jalankan wc -l CLAUDE.md. Jika lebih dari 200, pangkas besar-besaran. Pindahkan aturan otomasi ke hook. Pindahkan alur kerja ke skill. Pecah bagian yang dipakai bersama ke .claude/rules/ dan muat dengan @import. Alasan paling umum Claude "berhenti mengikuti" aturan Anda adalah file yang menjadi terlalu panjang seiring waktu, dan kepatuhan pun runtuh secara diam-diam.

2. Frasa yang samar ("tulis kode yang bersih")

Ganti setiap aturan yang bersifat aspiratif dengan aturan yang spesifik dan dapat diuji. "Bersikaplah konsisten" tidak kasatmata bagi Claude. "Gunakan server components secara default; tambahkan 'use client' hanya untuk form atau UI interaktif" adalah sesuatu yang benar-benar dapat diterapkan oleh Claude.

3. Tidak ada penjelasan "mengapa"

Aturan tanpa alasan tidak bisa digeneralisasi. Claude tidak bisa menyimpulkan kapan harus melonggarkan aturan karena ia tidak tahu apa yang dilindungi oleh aturan tersebut. Setiap aturan yang tidak jelas alasannya diberi penjelasan satu baris: "kami menggunakan unknown, bukan any, karena kuartal lalu kami mengalami tiga kali crash di runtime akibat respons API yang di-tipe-kan sebagai any."

4. Pemadatan konteks membuangnya

Sesi yang panjang memicu pemadatan, Claude merangkum konteks sebelumnya agar muat di jendela konteks, dan konten CLAUDE.md terkadang dirangkum hingga hilang tak berbekas. Solusinya: /clear setelah penggunaan konteks yang besar, atau mulai ulang sesi sepenuhnya. Inilah yang terus muncul di GitHub Issue #17530.

5. CLAUDE.md induk yang berkonflik

Global mengatakan "gunakan 4 spasi." Root proyek mengatakan "gunakan 2 spasi." Subdirektori tidak mengatakan apa-apa. Claude memilih salah satu, terkadang yang salah. Periksa ~/.claude/CLAUDE.md dan root proyek untuk mencari kontradiksi. Yang lebih spesifik seharusnya menang, tetapi hanya jika Anda membuatnya eksplisit.

6. Lokasi file atau huruf kapital nama file yang salah

Claude.md dan CLAUDE.md adalah file yang berbeda di Linux dan macOS. Begitu juga claude.md dan CLAUDE.md. Pastikan path-nya persis ./CLAUDE.md (semua huruf kapital), dan pastikan Claude Code diluncurkan dari direktori yang berisi file tersebut. GitHub Issue #668 penuh dengan kasus di mana file-nya ada tetapi Claude tidak dapat melihatnya karena masalah path.

Aturan #7: Uji di sesi baru. Setelah perubahan apa pun pada CLAUDE.md, buka sesi baru dan minta Claude untuk "merangkum aturan di CLAUDE.md." Jika rangkumannya melewatkan sesuatu, berarti file tersebut tidak menjalankan fungsinya.

CLAUDE.md Pertama Anda dalam 10 Menit: Panduan Awal 5 Langkah

Singkatnya: Jalankan /init untuk membuat draf awal, pangkas menjadi 6–10 aturan sungguhan lengkap dengan alasannya, tambahkan 3 perintah yang perlu Claude ketahui, tambahkan 2 anti-pola yang pernah tim Anda alami, lalu uji di sesi baru dengan meminta Claude merangkum file tersebut. Total waktu: sekitar 10 menit. Resep 5 langkah ini yang kami gunakan pada hari pertama di setiap repo baru.

1. Jalankan /init untuk membuat draf awal. Perintah /init milik Claude Code memindai repo Anda dan menulis CLAUDE.md awal. Jangan langsung memakai hasilnya. Output /init adalah titik awal, bukan file jadi, dan terus terang, sebagian besar yang dihasilkannya bisa dibuang.

2. Pangkas menjadi 6–10 baris aturan sungguhan lengkap dengan alasannya. Hapus apa pun yang generik. Hapus apa pun yang sudah ada di README. Simpan hanya aturan yang tidak bisa Claude simpulkan sendiri dari kodenya.

3. Tambahkan 3 perintah yang perlu Claude ketahui. Build, test, lint. Sertakan perintah persisnya beserta flag apa pun yang tidak jelas. Jika Anda memakai Vitest bukan Jest, sebutkan.

4. Tambahkan 2 anti-pola yang pernah tim ini alami. Yang sungguhan. "Jangan pakai any karena kami pernah mengalami tiga crash runtime" selalu lebih baik daripada "gunakan TypeScript dengan benar".

5. Buka sesi baru dan verifikasi. Minta Claude untuk "merangkum aturan di CLAUDE.md." Jika ada yang terlewat, berarti file-nya terlalu panjang, terlalu samar, atau缺少 "mengapa"-nya. Perbaiki dan ulangi.

Aturan #5: Jangan menghasilkan otomatis hanya dari /init. /init adalah titik awal, bukan file jadi. 8 menit yang Anda habiskan untuk memangkasnya adalah di mana nilainya berada.

Pertanyaan yang Sering Diajukan

Apa itu file CLAUDE.md?

File CLAUDE.md adalah file markdown yang dibaca Claude Code sebagai memori proyek di awal setiap sesi. File ini memberi tahu Claude tentang konvensi, perintah, dan antipola Anda, sehingga ia tidak perlu menebak-nebak. File ini bekerja di empat level: global, root proyek, subdirektori (dimuat secara lazy), dan CLAUDE.local.md pribadi yang Anda gitignore.

Seberapa panjang seharusnya file CLAUDE.md?

Di bawah 200 baris dan di bawah 500 kata aturan yang padat. Melewati ambang batas tersebut, kemampuan Claude dalam mengikuti instruksi akan menurun; setiap aturan yang Anda tambahkan membuat aturan lain sedikit lebih kecil kemungkinannya untuk diikuti. Perlakukan ini sebagai anggaran tetap. Jika Anda membutuhkan lebih, pecah menjadi file CLAUDE.md di subdirektori dan gunakan @import untuk bagian yang digunakan bersama.

Di mana sebaiknya saya meletakkan CLAUDE.md?

File utama diletakkan di root proyek Anda (./CLAUDE.md) dan ikut di-commit. Tambahkan file CLAUDE.md di subdirektori untuk aturan khusus aplikasi di monorepo. Letakkan preferensi lintas proyek di ~/.claude/CLAUDE.md. Gunakan CLAUDE.local.md untuk pengaturan personal yang tidak ingin Anda commit, tetapi jangan lupa menambahkannya ke gitignore secara manual.

Mengapa Claude mengabaikan CLAUDE.md saya?

90% kasusnya disebabkan oleh salah satu dari tiga hal: file terlalu panjang (lebih dari 200 baris), aturannya terlalu samar ("tulis kode yang bersih"), atau aturan tidak menyertakan "alasan" yang bisa digunakan Claude untuk menerapkannya. Jalankan wc -l CLAUDE.md, lalu periksa apakah aturannya sudah cukup spesifik. Uji perubahan di sesi baru dengan meminta Claude merangkum file tersebut.

Haruskah Saya Menggunakan CLAUDE.md atau AGENTS.md?

Jika tim Anda hanya menggunakan Claude Code, tetap gunakan CLAUDE.md. Jika Anda menggunakan dua atau lebih CLI agen (Codex, Cursor, Sourcegraph), beralihlah ke AGENTS.md dan buat symlink CLAUDE.md yang mengarah ke file tersebut: ln -s AGENTS.md CLAUDE.md. Sebagian besar CLI agen modern akan menjadikan AGENTS.md sebagai cadangan, sehingga satu file dapat digunakan untuk semua alat.

Haruskah saya menjalankan /init untuk membuat CLAUDE.md?

Ya, sebagai draf. Tidak, sebagai file final. /init memindai repo Anda dan menghasilkan file awal, tetapi isinya bertele-tele dan generik. Anthropic maupun HumanLayer sama-sama menyarankan untuk memangkasnya secara agresif setelah menjalankan /init. Delapan menit yang Anda habiskan untuk memotong dan menambahkan baris "mengapa" justru menjadi bagian yang membuat file tersebut benar-benar berguna.

Bagaimana cara kerja file CLAUDE.md di monorepo?

CLAUDE.md di root dibuat sekecil mungkin, hanya berisi pointer dan aturan bersama. Setiap app memiliki apps/*/CLAUDE.md sendiri dengan konvensi yang cakupannya terbatas. File di subdirektori dimuat secara lazy hanya saat Claude membaca file di dalam subtree tersebut, sehingga sibling tetap terisolasi. Gunakan @import .claude/rules/style.md untuk berbagi potongan aturan modular tanpa menduplikasinya di seluruh app.

Apa perbedaan antara CLAUDE.md, hooks, dan skills?

CLAUDE.md adalah konteks yang bersifat saran — Claude membacanya dan biasanya mengikutinya. Hooks adalah tindakan deterministik yang selalu dijalankan (pemformatan, memblokir commit). Skills adalah kumpulan kemampuan untuk alur kerja yang dapat digunakan ulang beserta asetnya. Gunakan CLAUDE.md untuk panduan gaya, hooks untuk aturan ketat, dan skills untuk pekerjaan multi-langkah yang akan Anda ulangi di berbagai proyek.

Cara Techsy Melakukan Ini

Di Techsy, setiap proyek Claude Code yang kami kirim memiliki CLAUDE.md di bawah 150 baris dan symlink AGENTS.md. Kami memperlakukan file tersebut seperti kode—memversikannya, meninjau perubahan dalam PR, dan menguji ulang di sesi baru sebelum merge. Butuh bantuan untuk mengintegrasikan agen AI ke dalam alur kerja pengembangan Anda? Dapatkan konsultasi gratis.