Catatan Redaksi: Saat banyak orang menggunakan Claude Code, masalah terbesarnya bukan modelnya tidak cukup kuat, melainkan setiap kali harus memulai dari nol.

Anda perlu berulang kali menjelaskan latar belakang proyek, teknologi yang digunakan, standar kode, bagian mana yang tidak boleh disentuh, solusi mana yang sudah dicoba sebelumnya. Selama informasi ini tidak tetap, Claude akan bekerja berdasarkan tebakan, hasilnya bisa saja mengubah file yang tidak seharusnya, merestrukturisasi kode yang tidak diminta, bahkan merekomendasikan alat yang tidak cocok untuk proyek saat ini.

CLAUDE.md yang diperkenalkan dalam artikel ini adalah manual penggunaan yang ditulis untuk Claude Code. Anda hanya perlu meletakkannya di direktori utama proyek, dan Claude akan membacanya secara otomatis setiap kali dijalankan. File ini bisa memberi tahu Claude sebelumnya: cara menjawab, cara menulis kode, kapan harus bertanya terlebih dahulu, operasi apa yang tidak boleh dilakukan tanpa izin, teknologi apa yang digunakan proyek, serta keputusan penting apa yang sudah dibuat sebelumnya.

Sederhananya, fungsi CLAUDE.md adalah: mengurangi penjelasan berulang, membatasi model agar tidak keluar batas, membuat pemrograman AI lebih stabil dan terkendali.

Jika Anda sedang menggunakan Claude Code, bisa mulai dari 4 aturan yang disimpulkan Karpathy: jika tidak jelas tanyakan dulu, lakukan solusi paling sederhana terlebih dahulu, jangan sentuh kode yang tidak relevan, jelaskan ketidakpastian secara eksplisit. Masukkan dulu beberapa aturan ini ke dalam CLAUDE.md, lalu tambahkan secara bertahap sesuai proyek Anda, pengalaman penggunaan akan meningkat secara signifikan.

Berikut adalah teks aslinya:

Sebuah file bernama CLAUDE.md menduduki puncak trending GitHub.

8,2 ribu bintang, 7,8 ribu fork.

Hal ini dimulai dari Andrej Karpathy. Dia pernah menjadi kepala AI di Tesla, juga salah satu anggota pendiri OpenAI. Dia merangkum 4 perilaku yang menyebabkan Claude Code gagal, dan menuliskannya ke dalam sebuah file.

Kemudian, seorang pengembang melanjutkan pengembangan 4 aturan ini dan merilis file ini secara publik. Hasilnya, ia langsung populer.

Alasannya langsung: akurasi coding meningkat dari 65% menjadi 94%.

Tapi kebanyakan pengembang yang menggunakan Claude Code setiap hari sebenarnya belum pernah melakukan pengaturan ini. Setiap sesi mereka mulai dari nol: menjelaskan konteks yang sama lagi, membersihkan perubahan cakupan yang tidak perlu, mengembalikan restrukturisasi yang tidak diminta siapa pun.

Berikut adalah file lengkapnya.

Pengaturan yang Terlewatkan Kebanyakan Pengembang

Setiap kali Anda membuka Claude Code, secara default ia tidak tahu apa-apa.

Ia tidak tahu teknologi Anda, tidak tahu standar kode Anda, tidak tahu latar belakang proyek Anda, tidak tahu apa yang sudah Anda coba, apalagi keputusan eksplisit yang Anda buat tiga sesi lalu untuk tidak melakukan sesuatu.

Jadi ia hanya bisa menebak. Dan begitu mulai menebak, ia bisa merestrukturisasi kode yang tidak Anda minta, merekomendasikan framework yang akan merusak arsitektur yang ada, menghapus file tanpa konfirmasi, bahkan membatalkan keputusan yang sudah Anda buat sebelumnya.

CLAUDE.md adalah file teks biasa yang diletakkan di direktori utama proyek. Claude Code akan membacanya secara otomatis di awal setiap sesi.

Satu kali pengaturan, tidak perlu berulang kali menjelaskan, dan bisa memperbaiki tiga jenis kesalahan yang mahal.

Pengaturan Default: Anda Membayar 375 Dolar Seminggu Hanya untuk Menjelaskan Diri Sendiri Berulang Kali

Pengembang biasa menghabiskan sekitar 30 menit setiap hari untuk menjelaskan kembali konteks kepada Claude.

Teknologi, standar pengkodean, latar belakang proyek, metode yang sudah dicoba - kecuali Anda menuliskan informasi ini sekaligus dan membuat Claude membacanya secara otomatis setiap kali, informasi itu tidak akan bertahan di antara sesi yang berbeda.

Jika dihitung berdasarkan tarif per jam pengembang 150 dolar:

· 30 menit per hari, berarti 75 dolar;

· per minggu berarti 375 dolar.

· Jika tim berisi 5 orang, per minggu berarti 1875 dolar biaya tersembunyi.

7 aturan berikut ini harus diletakkan di bagian paling depan file CLAUDE.md.

→ Hilangkan basa-basi

Saat menjawab, jangan gunakan pembuka seperti "pertanyaan bagus", "tentu saja", "tidak masalah" atau basa-basi serupa. Langsung berikan jawaban. Jangan basa-basi, jangan ulangi pertanyaan.

→ Sesuaikan panjang jawaban dengan tugas

Panjang jawaban harus sesuai dengan kompleksitas tugas. Pertanyaan sederhana jawab langsung dan singkat; tugas kompleks berikan penjelasan lengkap dan detail. Jangan gunakan pengulangan pertanyaan atau kalimat penutup yang mengulang kesimpulan untuk mengisi halaman.

→ Berikan rencana dulu sebelum bertindak

Sebelum memulai tugas penting apa pun, berikan 2–3 jalur yang layak, tunggu saya pilih dulu baru lanjutkan.

→ Sebelum ketidakpastian menyebabkan kerugian, akui dulu ketidakpastiannya

Jika Anda tidak yakin tentang fakta, data, tanggal, atau informasi teknis apa pun, jelaskan secara eksplisit sebelum mengutip. Jangan gunakan informasi yang tampak masuk akal untuk mengisi celah pengetahuan. Jika tidak yakin, katakan langsung tidak yakin.

→ Siapa saya, apa yang saya ketahui

Tentang saya: [nama] / peran: [peran Anda] / latar belakang: [bidang].

Saya mahir: [konten yang Anda kuasai].

Saya masih belajar: [kekurangan pengetahuan].

Sesuaikan kedalaman setiap jawaban berdasarkan informasi ini. Jangan terlalu menjelaskan konten yang sudah saya ketahui, juga jangan lewatkan latar belakang yang saya perlukan.

→ Konteks proyek saat ini

Saya sedang mengerjakan: [nama proyek] / tujuan: [hasil spesifik] / audiens: [siapa yang akan menggunakan] / latar belakang teknologi: [keterbatasan terkait] / yang perlu dihindari: [daftar].

Terapkan konteks ini pada setiap tugas. Jika suatu kebutuhan tidak sesuai dengan konteks, tunjukkan sebelum mengeksekusi.

→ Kunci gaya ekspresi Anda

Gaya penulisan saya adalah: [deskripsikan gaya ekspresi Anda].

Panjang kalimat: [preferensi].

Kata yang sering saya gunakan: [contoh].

Kata yang tidak akan pernah saya gunakan: [contoh].

Format: [prosa atau terstruktur].

Saat Anda mewakili saya menulis konten apa pun, harus sangat cocok dengan gaya ini, jangan gunakan pola ekspresi Anda sendiri secara default.

Waktu menjelaskan kembali konteks setiap hari: 30 menit

Dihitung berdasarkan tarif per jam pengembang 150 dolar: 75 dolar / hari

Per minggu: setiap pengembang 375 dolar

Tim 5 orang: 1875 dolar per minggu

Waktu pengaturan bagian CLAUDE.md ini: total 45 menit

Kesalahan yang perlu dihindari: jangan tulis CLAUDE.md dari nol. Gunakan prompt ini dulu, lalu edit hasilnya:

Berdasarkan apa yang saya ceritakan tentang diri saya, proyek saya, dan cara saya ingin bekerja, tuliskan file CLAUDE.md lengkap untuk saya. Isinya meliputi: siapa saya, latar belakang teknis saya, preferensi komunikasi saya, serta perilaku default yang harus dipatuhi setiap sesi. Harus spesifik, teks biasa, dalam 500 kata.

Batasan Perilaku: Perubahan "150 Dolar per Jam" yang Tidak Anda Otorisasi

Anda menyuruh Claude memperbaiki sebuah fungsi.

Hasilnya ia merestrukturisasi tiga file, mengganti nama variabel, mengatur ulang impor, dan menulis ulang komentar yang Anda tulis dengan susah payah.

Dan semua ini tanpa konfirmasi Anda.

Mereview dan mengembalikan perubahan yang tidak perlu ini mungkin butuh 1 jam, artinya 150 dolar. Terjadi tiga kali seminggu, berarti 450 dolar. Untuk tim 5 orang, per minggu berarti 2250 dolar, digunakan untuk membersihkan perubahan yang tidak ada yang otorisasi.

7 aturan berikut ini harus dimasukkan ke bagian batasan perilaku CLAUDE.md.

→ Kendalikan cakupan dengan ketat

Hanya modifikasi file, fungsi, dan baris kode yang secara langsung terkait dengan tugas saat ini. Jangan restrukturisasi, ganti nama, atur ulang, format ulang, atau "optimalkan" konten apa pun yang tidak saya minta secara eksplisit untuk dimodifikasi.

Jika Anda menemukan tempat lain yang layak diperbaiki, beri catatan di akhir. Jangan sentuh, jangan pernah.

→ Tanya dulu sebelum perubahan besar

Sebelum membuat perubahan signifikan pada konten yang sudah saya buat, termasuk menulis ulang bagian, menghapus paragraf, merestrukturisasi, mengubah nada, dll., harus berhenti dulu, jelaskan secara akurat apa yang akan Anda ubah, dan mengapa. Tunggu konfirmasi saya sebelum melanjutkan.

→ Harus konfirmasi sebelum operasi apa pun yang merusak

Sebelum menghapus file apa pun, menimpa kode yang sudah ada, menghapus catatan database, atau menghapus dependensi, harus berhenti dulu, daftar konten apa yang akan terpengaruh secara spesifik, dan minta konfirmasi eksplisit saya. Hanya jika saya bilang "ya" di pesan saat ini, Anda boleh lanjut.

"Anda sebelumnya pernah menyebutkan" tidak sama dengan konfirmasi.

→ Operasi lingkungan produksi harus jeda paksa

Operasi berikut harus mendapatkan konfirmasi eksplisit dalam sesi saat ini, tidak ada pengecualian:

· Menerapkan atau mendorong ke lingkungan apa pun;

· Menjalankan migrasi atau perubahan struktur database;

· Mengirim panggilan API eksternal apa pun;

· Menjalankan perintah apa pun yang memiliki efek samping tidak dapat dibalik.

· Saya harus bilang "ya" secara eksplisit di pesan saat ini.

→ Selalu tunjukkan apa yang diubah

Setelah menyelesaikan tugas coding apa pun, akhirnya harus mencakup:

File yang dimodifikasi: daftar semua file yang disentuh;

Konten modifikasi: satu kalimat untuk setiap file;

File yang sengaja tidak dimodifikasi;

Hal yang perlu ditindaklanjuti.

→ Tanpa konfirmasi eksplisit, jangan bertindak mewakili saya

Tanpa konfirmasi eksplisit saya di pesan saat ini, jangan mengirim, memposting, berbagi, atau menjadwalkan konten apa pun atas nama saya. Termasuk email, undangan kalender, berbagi dokumen, atau operasi apa pun yang terjadi di luar percakapan saat ini. Saya harus bilang "ya" secara eksplisit di pesan saat ini.

→ Pikirkan dulu sebelum menulis kode

Untuk tugas yang melibatkan keputusan arsitektur, debugging masalah kompleks, atau pengembangan fungsi non-sederhana, analisis masalah langkah demi langkah terlebih dahulu, baru tulis kode. Tunjukkan proses penalaran Anda, tunjukkan ketidakpastian, baru kemudian eksekusi.

Pengembalian perubahan cakupan tidak perlu per minggu: 150 dolar

Pengecekan diff manual per minggu: 75 dolar

Pemborosan terkait perilaku setiap pengembang: 225 dolar / minggu

Tim 5 orang: 1125 dolar / minggu

Waktu pengaturan bagian perilaku CLAUDE.md: 30 menit

Memori & Teknologi: Pengaturan agar Claude Code Benar-Benar Andal

Claude akan melupakan segalanya di antara sesi yang berbeda.

Setiap keputusan yang Anda buat, setiap solusi yang gagal, mengapa enam bulan lalu memilih Prisma bukan Drizzle, serta mengapa suatu batasan berasal dari kebutuhan klien tertentu - semuanya akan dilupakan.

Lalu, ia akan mengusulkan kembali solusi yang sudah Anda kesampingkan.

Bagian ini setara dengan mekanisme untuk memberikan Claude "memori sejati" terdekat saat ini, sekaligus mengunci teknologi Anda, mencegahnya terus merekomendasikan alat yang akan merusak arsitektur yang ada.

→ Log Keputusan MEMORY.md

Pertahankan file bernama MEMORY.md di proyek. Setiap kali membuat keputusan penting, tambahkan catatan baru:

· Apa yang diputuskan;

· Mengapa diputuskan begitu;

· Apa yang dikesampingkan, mengapa dikesampingkan.

Di awal setiap sesi, baca MEMORY.md terlebih dahulu. Tanpa pengingat, jangan bertentangan dengan keputusan yang sudah dicatat.

→ Rangkuman Akhir Sesi

Ketika saya bilang "session end", "wrapping up", atau "let's stop here", tuliskan rangkuman sesi ke MEMORY.md, termasuk:

· Apa yang ditangani kali ini;

· Apa yang sudah selesai;

· Apa yang masih berjalan;

· Keputusan apa yang dibuat;

· Prioritas untuk sesi berikutnya.

→ Log Kegagalan ERRORS.md

Pertahankan file bernama ERRORS.md. Ketika suatu solusi dicoba lebih dari dua kali dan belum berhasil, catat:

· Apa yang tidak berhasil;

· Solusi terakhir apa yang berhasil;

· Apa yang perlu diperhatikan lain kali.

Sebelum mengusulkan solusi untuk tugas serupa, periksa ERRORS.md terlebih dahulu.

→ Daftar Fakta Permanen

Fakta berikut ini selalu berlaku untuk proyek ini, dan harus diterapkan tanpa pengecualian ke setiap sesi:

[Keterbatasan permanen Anda, keputusan arsitektur, dan aturan]

Jika suatu tugas bertentangan dengan fakta-fakta ini, tunjukkan sebelum mengeksekusi.

→ Kunci Tumpukan Teknologi

Tumpukan teknologi proyek ini adalah sebagai berikut, selalu gunakan alat-alat ini. Kecuali saya minta secara eksplisit, jangan rekomendasikan alternatif:

Bahasa: [misal TypeScript]

Framework: [misal Next.js 14]

Pengelola paket: [misal pnpm]

Database: [misal PostgreSQL dengan Prisma]

Testing: [misal Vitest]

Gaya: [misal Tailwind CSS]

Jika suatu alat tampak tidak cocok, bisa ditunjukkan. Tapi kecuali saya jelaskan secara eksplisit, harus gunakan tumpukan teknologi yang sudah ditetapkan.

→ Aktifkan Pemikiran Ekstensi untuk Keputusan Sulit

Untuk masalah yang melibatkan arsitektur sistem, pertukaran kinerja, desain database, atau keputusan teknis jangka panjang, gunakan mode pemikiran ekstensi.

Analisis masalah langkah demi langkah, usulkan pertukaran yang mungkin tidak saya pertimbangkan, tunjukkan asumsi yang mungkin tidak berlaku setelah skalanya diperbesar, lalu berikan rekomendasi Anda.

→ 4 Aturan yang Populer Itu

Karpathy merangkum 4 perilaku yang menyebabkan Claude Code gagal. Seorang pengembang merumuskannya menjadi 4 baris aturan berikut. Akurasi coding meningkat dari 65% menjadi 94% karena ini.

Tanya dulu, jangan asumsikan.
Jika ada hal yang tidak jelas, tanya dulu sebelum menulis baris kode pertama. Jangan membuat asumsi diam tentang maksud, arsitektur, atau kebutuhan.

Lakukan solusi paling sederhana dulu.
Selalu implementasikan solusi paling sederhana yang bisa bekerja terlebih dahulu. Jangan tambahkan lapisan abstraksi atau fleksibilitas yang tidak diminta secara eksplisit.

Jangan sentuh kode yang tidak relevan.
Jika suatu file atau fungsi tidak berhubungan langsung dengan tugas saat ini, jangan modifikasi. Meskipun Anda pikir bisa dioptimalkan, jangan sentuh.

Tandai ketidakpastian secara eksplisit.
Jika Anda tidak yakin tentang suatu solusi atau detail teknis, jelaskan sebelum melanjutkan. Tampil percaya diri tanpa kepastian menyebabkan kerusakan lebih besar daripada mengakui kekurangan pengetahuan.

· Biaya pemulihan karena lupa keputusan dan saran salah per minggu: setiap pengembang 300 dolar

· Rekomendasi tumpukan teknologi salah dan alat tidak kompatibel: 75 dolar per minggu

· Pemborosan terkait memori setiap pengembang: 375 dolar / minggu

· Tim 5 orang: 1875 dolar / minggu

· Waktu pengaturan MEMORY.md + ERRORS.md + tumpukan teknologi: 20 menit

Kesimpulan

Rincian biaya lengkapnya sebagai berikut:

· Mengulangi penjelasan konteks per minggu: 375 dolar

· Mengembalikan perubahan tidak sah per minggu: 225 dolar

· Menangani masalah karena keputusan terlupa per minggu: 375 dolar

· Total pemborosan setiap pengembang per minggu: 975 dolar.

Jika tim pengembang 5 orang: 4875 dolar per minggu. Setahun 253.500 dolar.

Sedangkan pengaturan CLAUDE.md total hanya butuh 2 jam.

Hanya 4 aturan Karpathy saja, membuat akurasi coding naik dari 65% menjadi 94%.

Satu file teks biasa, 21 aturan, dua jam kerja.

Pengembang yang menyelesaikan pengaturan ini, sebenarnya menggunakan Claude yang lebih andal: bisa mengingat keputusan, mengendalikan cakupan tugas, meminta konfirmasi sebelum operasi merusak, juga tidak merekomendasikan framework yang akan merusak arsitektur yang ada.

Sedangkan yang belum mengatur, masih menghabiskan 975 dolar per minggu untuk mengulangi penjelasan diri sendiri.

Catatan: Mulailah dari 4 aturan Karpathy. Cukup 4 aturan ini. Sekarang tempelkan ke file baru bernama CLAUDE.md di direktori utama proyek, hanya butuh 2 menit. Lalu tambahkan secara bertahap setiap minggu berdasarkan celah yang Anda temukan.

Sebelum tenggelam dalam arus informasi, simpan dulu. Jika menurut Anda berguna, bisa juga bagikan ke seseorang yang benar-benar membutuhkannya.