Gelar asli: KLAUDE.md Karpati mencapai #1 di GitHub dengan 82.000 bintang.

Foto oleh Dep

Penyunting pers: Ketika banyak orang menggunakan Claude Code, masalah terbesar adalah tidak bahwa model tidak cukup kuat, tetapi mereka mulai dari awal setiap waktu。

Anda perlu menceritakannya berulang kali tentang latar belakang proyek, kubah teknologi, spesifikasi kode, di mana ia tidak dapat bergerak dan program mana yang telah ia coba. Selama informasi ini tidak tetap, Claude bergantung pada tebakan, yang mungkin mengakibatkan perubahan dokumen yang tidak dapat diperbaiki, merekonstruksi kode yang tidak memerlukan rekayasa ulang dan bahkan menyarankan alat yang tidak cocok untuk proyek saat ini。

CLUDE.md, yang disajikan di sini, adalah manual untuk Claude Code. Semua yang harus Anda lakukan adalah memasukkannya ke dalam root directory, dan Claude secara otomatis membacanya setiap kali dimulai. Ini dapat memberitahu Claude di muka bagaimana menjawab, bagaimana cara menulis kode, kapan bertanya pertama, operasi apa yang tidak dapat dieksekusi tanpa izin, teknologi apa yang digunakan dalam proyek dan apa keputusan penting yang telah dibuat di masa lalu。

Singkatnya, peran CLAUDE.md adalah untuk mengurangi interpretasi berulang, membatasi model melintasi perbatasan dan membuat pemrograman AI lebih stabil dan dikelola。

Jika Anda menggunakan Claude Code, Anda dapat memulai dengan 4 aturan yang dirangkum oleh Karpathy: tanya dulu, buat solusi yang paling sederhana, jangan sentuh kode yang tidak relevan, nyatakan ketidakpastian. Pemberlakuan barang-barang ini dalam CLAUDE.md dan penambahan bertahap mereka untuk proyek mereka sendiri secara signifikan akan meningkatkan pengalaman penggunaan mereka。

Berikut ini adalah teks asli:

Dokumen yang disebut CLAUDE.md berada di puncak GitHub Trending。

8.2 juta bintang, 7.800 garpu。

Ini dimulai di Andrej Karpati. Dia adalah direktur Tesla AI dan salah satu anggota pendiri OpenAI. Dia menyimpulkan empat jenis perilaku yang akan menodai Claude Code dan menempatkan mereka dalam sebuah dokumen。

Kemudian, seorang pengembang terus memperluas keempat peraturan tersebut dan merilis dokumen tersebut ke publik. Ternyata warnanya merah。

Alasannya adalah langsung: tingkat ketepatan kode telah meningkat dari 65% menjadi 94%。

Namun sebagian besar pengembang yang menggunakan Claude Code setiap hari tidak pernah benar-benar melakukan hal ini. Setiap sesi mereka dimulai dari awal: konteks yang sama dijelaskan kembali, perubahan ruang lingkup yang tidak perlu dibersihkan, dan rerun rekonstruksi yang tidak diundang digulung kembali。

Dokumen lengkap berikut。

Settings Settings dirindukan oleh sebagian besar pengembang

Setiap kali Anda membuka Claude Code, itu lalai mengetahui apa-apa。

Ini tidak tahu teknologi Anda, itu tidak tahu kode kode Anda, itu tidak tahu latar belakang proyek Anda, itu tidak tahu apa yang telah Anda coba, dan itu tidak tahu apa yang Anda jelas memutuskan untuk tidak melakukan sebelum tiga sesi。

Jadi hanya bisa menebak. Dan setelah mulai menebak, itu mungkin menciptakan ulang kode Anda tidak memintanya untuk bergerak, dan rekomendasi akan merongrong kerangka arsitektur yang ada, menghapus dokumen tanpa konfirmasi, atau bahkan membalikkan keputusan yang Anda ambil sebelumnya。

CLUDE.md adalah berkas teks biasa yang ditempatkan di bawah direktori akar. Claude Code secara otomatis membacanya di awal setiap sesi。

Sebuah setup satu kali tidak harus dijelaskan berulang kali dan dapat memperbaiki tiga jenis kesalahan biaya。

Anda menghabiskan $375 seminggu, ulangi saja

Pengembang oridinary membutuhkan waktu sekitar 30 menit sehari untuk menafsirkan ulang konteks ke Claude。

Kubah teknologi, kode kode kode, latar belakang proyek, metode yang telah Anda coba -- kecuali jika Anda menuliskan informasi ini sekali dan membuat Claude membacanya secara otomatis, mereka tidak menjaga antar sesi。

Jika dihitung pada pengembang 's gaji per jam dari $ 150:

30 menit per hari, 75 dolar

375 dolar per minggu。

Jika itu adalah tim lima, itu akan menjadi $ 1875 per minggu。

Peraturan berikut 7 harus ditempatkan di bagian atas dokumen CLAUDE.md。

Oh, pergilah

Jawabannya tidak dimulai dengan pertanyaan "baik" atau masalah " atau semacam kasur. Berikan saja jawabannya. Jangan dingin, jangan ulangi pertanyaannya。

→ Panjang tanggapan menurut tugas

Panjang panjang tanggapan harus sesuai dengan kompleksitas tugas. Pertanyaan sederhana dijawab secara langsung, singkat; mandat kompleks memberikan deskripsi lengkap dan terperinci. Jangan mengisi ruang dengan pengulangan pertanyaan atau pengulangan kesimpulan。

• Sebelum bertindak

Sebelum memulai tugas penting, beri aku 2-3 jalur yang layak, dan kemudian lanjutkan sampai aku memilih。

Sebelum ketidakpastian menyebabkan kehilangan, akui ketidakpastian

Jika Anda tidak pasti tentang fakta, data, tanggal atau informasi teknis, silakan nyatakan sebelum mengutip. Jangan mengisi celah pengetahuan dengan informasi yang tampaknya masuk akal. Bila kau tidak bisa, katakan saja kau tidak yakin。

Siapa aku? Apa yang kutahu

Bagi saya: [nama] / Peranan: [peran] / Latar Belakang: [area]。

Aku ahli dalam hal ini:。

Aku masih belajar。

Tolong atur kedalaman setiap respon untuk informasi ini. Jangan terlalu banyak menjelaskan apa yang sudah kuketahui, dan jangan lewatkan latar belakang yang kubutuhkan。

Konteks Proyek Saat Ini

Saya melakukan: [Nama proyek] / Objektif: [hasil khusus] / Penonton: [siapa yang akan menggunakan] / Latar belakang gudang teknis: [kekangan relevan] / Perlu menghindari: [daftar]。

Silakan terapkan konteks ini untuk setiap tugas. Jika suatu persyaratan tidak sesuai dengan konteks, sila tunjukkan sebelum implementasi。

♪ Kunci ekspresimu ♪

Gaya penulisan saya adalah: [Keterangan ekspresi Anda]。

Panjang kalimat: [butuh rujukan]。

Dulu aku menggunakan kata-kata: [contoh]。

Saya tidak akan pernah menggunakan kata-kata: [contoh]。

Format:。

Ketika Anda menulis apa-apa atas nama saya, Anda harus ketat cocok dengan gaya itu dan tidak menggunakan ekspresi Anda sendiri secara default。

Waktu untuk mengulangi konteks: 30 menit

Berdasarkan pada developer 's per jam gaji $ 150: $75/hari

Weekly: $375 per pengembang

5-orang tim: $1875 per minggu

Pengaturan CLUDE.md: total 45 menit

Galat perlu dihindari: Jangan tulis CLAUDE.md dari awal. Use program ini pertama, kemudian sunting output:

Berdasarkan apa yang saya katakan tentang diri saya, proyek saya, dan bagaimana saya ingin bekerja, silakan tuliskan CLUDE.md lengkap. Ini termasuk siapa saya, latar belakang teknis saya, preferensi komunikasi saya, dan perilaku baku yang harus diikuti setiap sesi. Khusus, teks biasa, 500 kata diperlukan。

Penahanan perilaku: perubahan-perubahan yang tidak Anda izinkan, $ 150 per jam

Kau membiarkan Claude memperbaiki fungsi。

akibatnya, ia menciptakan kembali tiga dokumen, mengubah nama variabel, mengatur ulang laporan, dan menulis ulang catatan yang anda ambil waktu anda untuk menulis。

Dan semua ini tidak dikonfirmasi oleh Anda。

Mungkin butuh satu jam, atau 150 dolar, untuk meninjau kembali perubahan yang tidak perlu ini. 3 kali seminggu, itu $450. Untuk tim lima, $ 250 seminggu untuk membersihkan perubahan yang tidak sah。

Aturan berikut 7 harus disisipkan dalam bagian pengikatan dari tindakan CLAUDE.md。

Kontrol bedah

Hanya perubahan file, fungsi dan kode baris yang berhubungan langsung dengan tugas saat ini. Jangan recreate, rename, reorganisasi, reformulasi, atau "optimasi" apapun yang saya tidak secara eksplisit meminta Anda untuk berubah。

Jika Anda menemukan tempat lain layak diperbaiki, gunakan catatan terakhir. Jangan bergerak, jangan pernah。

Tanyalah sebelum membuat perubahan besar

Sebelum membuat perubahan besar pada apa yang telah saya buat, termasuk menulis ulang bab, menghapus paragraf, restrukturisasi struktur, mengubah nada, dll, penting untuk menghentikan dan menyatakan apa yang ingin Anda ubah dan mengapa. Aku akan melanjutkan sampai aku yakin。

Setiap operasi destruktif harus dikonfirmasi sebelumnya

Sebelum dokumen apapun dihapus, kode-kode yang sudah ada ditutup, catatan database dihapus, atau kebergantungan dihapus, perlu dihentikan, untuk mencantumkan apa yang secara khusus mempengaruhi dan meminta konfirmasi yang jelas. Anda dapat melanjutkan hanya jika saya mengatakan ya dalam berita saat ini。

Kau sudah mengatakannya sebelumnya, bukan konfirmasi。

Operasi lingkungan produksi DNA harus dihentikan

Hal berikut harus dipastikan dengan jelas dalam sesi saat ini, tanpa kecuali:

Penguraian atau pemindahan ke lingkungan manapun

Operasional migrasi atau perubahan struktur basis data

KIRIM SETIAP PANGGILAN API EKSTERNAL

Tak ada perintah dengan efek samping yang tak bisa dikembalikan。

Aku harus mengatakan "ya"jelas dalam berita terkini。

♪ Selalu menunjukkan apa yang berubah ♪

Setelah menyelesaikan setiap tugas pengodean, akhir harus mencakup:

Dokumen dimodifikasi: Daftar semua dokumen dipindahkan

Semakan: Setiap dokumen dijelaskan dalam satu kalimat

Dokumen Dokumen sengaja tidak diubah

Menindaklanjuti masalah。

{\bord0\shad0\alfaH3D Jangan bertindak atas namaku tanpa konfirmasi yang jelas

Tak ada yang bisa dikirim, diterbitkan, dibagikan atau diatur atas nama saya tanpa konfirmasi ekspres saya dalam pesan saat ini. Transkrip surat, undangan kalender, berbagi dokumen, atau operasi apapun yang terjadi di luar dialog saat ini. Aku harus mengatakan ya dengan jelas dalam berita terkini。

Nah, berpikir sebelum Anda menulis kode

Untuk tugas-tugas yang melibatkan pengambilan keputusan terstruktur, masalah kompleks debugging, atau pengembangan fungsional non-sederhana, satu langkah per satu, kemudian penulisan kode. Wadine menunjukkan penalaran Anda, menunjukkan ketidakpastian, dan kemudian menerapkannya。

Perubahan jangkauan tak perlu pada minggu rollback: $150

diff manual diff pemeriksaan mingguan: $75

Perilaku busuk per pengembang: 225 / minggu

Tim 5 orang: $1125/ minggu

LUDE.md perilaku paruh waktu: 30 menit

Memori dan gudang teknologi: Membuat Claude Code benar-benar dapat diandalkan

Claude akan melupakan segalanya antara sesi。

Setiap keputusan yang telah Anda buat, setiap formula yang telah Anda gagal, mengapa Anda memilih Prisma enam bulan yang lalu daripada Drizzle, dan mengapa kendala tertentu berasal dari kebutuhan klien tertentu — itu dilupakan。

Dan kemudian itu akan mengeluarkan kembali formula Anda sudah mengesampingkan。

Bagian ini setara dengan menyediakan Claude dengan mekanisme terdekat untuk "memori nyata" saat ini, sementara mengunci lemari besi teknologi Anda untuk menghindarinya terus menyarankan alat-alat yang dapat melemahkan struktur yang ada。

Catatan Keputusan

Ketahanan file bernama MEMORY.md dalam proyek. Setiap kali keputusan penting dibuat, rekor baru ditambahkan:

Keputusan tentang apa

• Mengapa demikian

- Kecuali apa, mengapa。

Memory.md Baca Memory.md pada awal setiap sesi. Tidak ada konflik dengan keputusan yang dicatat yang diizinkan tanpa peringatan。

Ringkasan Sesi

Saat saya mengatakan "session end" " wrapping up" atau "mari berhenti di sini", silakan tulis ringkasan sesi ke Memory.md, termasuk:

Apa yang telah ditangani saat ini

• Apa yang telah dicapai

Apa yang masih terjadi

Keputusan diambil

Prioritas untuk sesi berikutnya。

→ERRORS.md Gagal Log

Tetap mempertahankan file yang disebut EROS.md. Ketika sebuah program mencoba lebih dari dua kali untuk tetap tidak berhasil, tercatat bahwa:

Apa yang tidak bekerja

• Apa yang terakhir berhasil

Apa yang perlu diperhatikan lain kali。

ORSS.md sebelum mengusulkan program untuk tugas serupa。

• Daftar fakta kekal

Fakta-fakta berikut tetap valid untuk proyek ini dan harus diterapkan untuk setiap sesi tanpa pengecualian:

[Kekangan permanen Anda, keputusan struktural dan aturan]

Jika mandat tertentu bertentangan dengan fakta-fakta ini, silakan tunjukkan sebelum implementasi。

♪ Kunci lemari besi teknologi ♪

Proyek proyek ' s gudang teknologi adalah sebagai berikut dan alat-alat digunakan secara konsisten. Kecuali aku secara eksplisit meminta, tidak ada alternatif yang disarankan:

Bahasa-bahasa: [e.g. TypeScript]

Frame: [mis. Next.js 14]

pengurus paket: [e.g. pnpm]

Pangkalan Data: [e.g. PostgreSQL with Prisma]

Uji: [mis. Vital]

Gaya: [E.g. Taylor CSS]

Jika sebuah alat tampaknya tidak sesuai, alat itu dapat ditunjukkan. Kecuali kuperjelas, gudang teknologi yang sudah ditentukan harus digunakan。

{\\a6\\fs17\\fnCentury Gothic}♪♪Pemicu pengambilan keputusan yang keras memicu pemikiran yang diperpanjang

Untuk isu-isu yang berkaitan dengan arsitektur sistem, trade-off kinerja, desain basis data, atau pengambilan keputusan teknis jangka panjang, menggunakan model pemikiran yang diperluas。

Analisis langkah demi langkah dari masalah, dengan perdagangan-off bahwa saya mungkin belum memperhitungkan, dan dengan asumsi yang mungkin tidak valid dalam hal peningkatan ukuran, akan memberikan saran Anda。

Itu empat aturan merah

Keharyapatihan Dia menyimpulkan empat jenis perilaku yang akan membuat Claude Code gagal. Salah satu pengembang memurnikannya menjadi empat baris aturan di bawah ini. Jadi tingkat akurasi yang dikodekan berubah dari 65% menjadi 94%。

Pertama, jangan berasumsi。
Jika ada ketidakpastian, tanyakan sebelum menuliskan baris pertama. Jangan membuat anggapan bisu tentang niat, struktur atau kebutuhan。

Pertama, yang sederhana。
Cara paling sederhana untuk bekerja selalu tercapai. Jangan tambahkan lapisan abstrak atau kelenturan yang tidak diperlukan secara eksplisit。

Jangan sentuh kode yang tidak relevan。
Anda tidak perlu mengubah dokumen atau fungsi jika tidak berhubungan langsung dengan tugas yang sedang dipilih. Bahkan jika Anda berpikir itu bisa dioptimalkan, jangan bergerak。

Pasti ada ketidakpastian。
Jika Anda tidak yakin tentang program tertentu atau rincian teknis, silakan tunjukkan sebelum melanjutkan. Ketiadaan kepastian tetapi ekspresi keyakinan lebih merusak daripada pengakuan kesenjangan pengetahuan。

Biaya Pemulihan per minggu karena keputusan yang terlupakan dan rekomendasi yang salah: $300 per pengembang

Kesalahan teknologi kesalahan teknologi induktif dan alat tidak kompatibel: $75 per minggu

Pemborosan memori per pengembang: $375 / minggu

Tim 5-person: $1875/week

• MASORY.md + ERORSS.md + Waktu Technical staking: 20 menit

Kesimpulan

Pertanggungjawaban biaya yang lengkap adalah sebagai berikut:

Konteks mingguan berulang: $375

Mingguan roll-back tanpa perubahan yang sah: $225

:Berurusan dengan masalah yang timbul dari keputusan yang terlupakan per minggu: $375

Sampah total per developer per minggu: $ 975。

Jika 5 orang tim pengembangan: $4875 per minggu. 2553.500 dolar per tahun。

Dan pengaturan CLUDE.md mengambil total dua jam。

empat aturan dari Karpati sendiri meningkatkan akurasi yang disandikan dari 65% menjadi 94%。

Dokumen teks biasa, 21 aturan, dua jam kerja。

Pengembang-pembangun yang menyelesaikan set-up ini sebenarnya menggunakan Claude yang lebih handal: dapat mengingat pengambilan keputusan, jangkauan misi kontrol, meminta konfirmasi sebelum operasi destruktif, dan tidak menyarankan kerangka kerja yang akan meruntuhkan struktur yang ada。

Dan mereka yang belum dijodohkan masih menghabiskan $ 975 seminggu untuk menjelaskan diri mereka sendiri。

Catatan: Mulailah dengan aturan 4 dari Karpati. Hanya empat ini. Paste mereka sekarang ke file baru berikutnya dalam root directory, disebut CLADE.md, selama dua menit. Kemudian itu akan diisi kembali secara mingguan berdasarkan kesenjangan yang telah Anda identifikasi。

Pengumpulnya sebelum dibanjiri dengan informasi. Jika Anda merasa berguna, Anda dapat berbagi dengan seseorang yang benar-benar membutuhkannya。

[Terkekeh]Bahasa Asli]