Gelar asli: Karupathy's 4 CLAUDE.md Aturan memotong film Claude dari 41% sampai 11%
Diterjemahkan oleh : @Mnilax
Foto oleh Peggy Block Beats

Censes editor: Pada Januari 2026, parasut Andrej Karpathy pada kode penulisan Claude menyebabkan dokumen yang tampak kecil tetapi sangat kritis dalam alur kerja pemrograman AI: CLAUDE.md. Ia kemudian mengorganisir isu-isu ini menjadi empat aturan tingkah laku, mencoba membatasi kesalahan yang biasanya dibuat Claude ketika mengode: hipotesis diam, over-engineering, cedera terhadap kode yang tidak berhubungan, dan kurangnya kriteria keberhasilan yang jelas。

Beberapa bulan kemudian, Claude Code tidak lagi hanya "biarkan model menulis kode." Sebagai Agen multi-langkah, pemicu rantai hok, pemuatan keterampilan dan kolaborasi pustaka multi-kode menjadi normal, model kegagalan baru mulai muncul: model berada di luar kendali dalam misi panjang, tes lulus tanpa logika otentik, migrasi dilakukan tetapi diam-diam melalui kesalahan, dan gaya kode yang berbeda disalahgunakan。

Penulis makalah ini telah menguji 30 perpustakaan kode dalam waktu enam minggu dan menambahkan delapan aturan baru untuk peraturan asli Karpati 4 dalam upaya untuk menutupi masalah baru pemrograman AI dari penyempurnaan tunggal ke kolaborasi Agen。

Berikut ini adalah teks asli:

Telat pada Januari 2026, Andrej Karpathy mengirimkan tweet string, meludahi cara Claude menulis kode. Dia menunjuk tiga isu khas: asumsi palsu dalam ketiadaan penjelasan, kompleksitas berlebihan, dan kerusakan yang tidak terkait pada kode yang seharusnya tidak diubah。

Aquista Forrest Chang melihat string tweet ini, mengatur keluhan-keluhan tersebut menjadi empat aturan tingkah laku, memasukkan berkas CLAUDE.md yang terpisah dan menerbitkannya dalam GitHub. Pada hari pertama proyek, 5.828 Stars diakuisisi, dikumpulkan 60.000 kali dalam dua minggu, dan hari ini ada 120.000 Stars, gudang kode file tunggal tercepat tumbuh di 2026。

Dan kemudian, dalam enam minggu, aku mengujinya di 30 perpustakaan kode。

Aturan ini memang berlaku. Pada masa lalu, sekitar 40 persen kemungkinan kesalahan jatuh menjadi kurang dari 3 persen tugas yang sesuai dengan aturan ini. Namun masalahnya adalah bahwa templat ini awalnya dirancang untuk memecahkan kesalahan pada bulan Januari ketika Claude menulis kode。

Pada Mei 2026, masalah ekologi yang dihadapi Claude Code berbeda: konflik antara Agen, pemicu rantai Hook, konflik skill-loading, dan gangguan aliran kerja multi-langkah。

Jadi saya menambahkan lebih lanjut delapan aturan. Mengapa setiap aturan yang layak untuk bergabung dan di mana template Karpati yang asli akan diam-diam diabaikan di empat tempat。

Jika Anda ingin melewatkan penjelasan, menyalinnya langsung dan meninggalkan berkas lengkap di akhir teks。

Mengapa ini penting

Claude Code's CLUDE.md adalah dokumen yang paling diremehkan dalam lemari besi teknologi pemrograman AI. Sebagian besar pengembang-pembangun magaso biasanya membuat tiga macam kesalahan:

pertama, ambil sebagai tempat sampah, masukkan semua kebiasaanmu ke dalamnya, lalu kembangkan hingga lebih dari 4000 token, dan jatuhkan tingkat kepatuhan hingga 30%。

kedua, anda tidak harus melakukannya sama sekali. ini akan mengakibatkan limbah token lima kali lipat dan kurangnya konsistensi antara sesi。

Ketiga, setelah menyalin sebuah templat, itu tidak penting lagi. Ini mungkin bekerja selama dua minggu, tetapi dengan perubahan di perpustakaan kode, itu akan gagal tanpa pengetahuan Anda。

Dokumen resmi antropi sangat jelas: CLAUDE.md pada dasarnya hanya merekomendasikan. Claude akan memiliki sekitar 80% waktu untuk mengikutinya. Setelah lebih dari 200 baris, tingkat kepatuhan dikurangi secara signifikan, karena aturan penting dibanjiri dengan kebisingan。

Templat Karpatia SAMA memecahkan masalah: satu dokumen, 65 baris, 4 aturan. Ini adalah benchmark minimum。

Tapi langit-langit bisa lebih tinggi. Andica setelah menambahkan delapan aturan berikut ini, tidak hanya mencakup masalah penulisan kode yang Karpati mengeluhkan pada Januari 2026, tetapi juga masalah organisasi Agen yang muncul hanya pada Mei 2026 — masalah yang tidak ada ketika templat asli ditulis。

Peraturan Asli 4

Jika Anda belum melihat gudang Forrest Chang, lihat versi dasar ini:

Pikirkan sebelum kode。

Jangan membuat asumsi. Untuk mengilustrasikan hipotesismu, membongkar perdagangannya. Pertanyaan sebelum spekulasi. Jika ada pilihan yang lebih sederhana, keberatan diajukan atas inisiatif mereka sendiri。

Aturan 2: Prioritas sederhana。
Guna kode minimum yang menyelesaikan masalah. Jangan menambahkan fungsi imajinasi. Jangan desain lapisan abstrak untuk kode satu kali. Jika seorang insinyur senior berpikir itu terlalu kompleks, itu harus disederhanakan。

Aturan 3: modifikasi bedah。
Hanya mereka yang harus diubah. Jangan "optimumkan" kode tetangga, catatan atau format. Jangan menciptakan kembali sesuatu yang tidak rusak. Pertahankan gaya saat ini。

Aturan 4: implementasi berorientasi objektif。
Definisikan kriteria untuk keberhasilan, dan kemudian loops dari waktu ke waktu sampai validasi selesai. Jangan beritahu Claude apa yang harus dilakukan setiap langkah, tapi katakan padanya apa yang seharusnya menjadi seperti untuk berhasil, dan membuatnya satu iteratif。

Dan empat aturan yang saya lihat dalam percakapan tak diawasi Claude Code adalah sekitar 40 persen dari pola kegagalan. Sisa 60% dari masalah tersembunyi di daerah kosong di bawah ini。

Dan mengapa

Setiap peraturan berasal dari saat nyata: empat aturan asli Karpati tidak lagi mencukupi. Aku akan mulai dengan TKP, maka aku akan memberikan aturan yang sesuai。

Aturan 1: Jangan biarkan model melakukan pekerjaan non-linguistik

Claude dapat digunakan untuk memproses: klasifikasi, penyusunan, ringkasan, mengekstrak informasi dari teks yang tidak terstruktur. Jangan gunakan pemrosesan Claude: rute, tes ulang, pengolahan kode status, konversi pasti. Jika kode status telah menjawab pertanyaan, biarkan kode normal menjawab pertanyaan。

Aturan-aturan yang tak bisa diluruskan oleh Camat. Model kemudian mulai menentukan beberapa isu yang seharusnya telah dialamatkan oleh kode kepastian: apakah akan mencoba lagi panggilan API, bagaimana mendapatkan pesan, kapan harus mengupgradenya. Hasilnya, penilaiannya bervariasi dari minggu ke minggu. Apa yang Anda dapatkan adalah mudah menguap jika-else per token 0.003。

Ini adalah saat: ada kode yang memanggil Claude untuk "menilai apakah akan mencoba lagi ketika 503 dihadapi." Ini dimulai dengan baik, berlangsung selama dua minggu, dan kemudian tiba-tiba menjadi tidak stabil, karena model mulai menggunakan tubuh permintaan sebagai konteksnya. Strategi percobaan ulang menjadi acak, karena prompt itu sendiri acak。

aturan 6: menetapkan anggaran token yang keras tanpa pengecualian

anggaran misi individu: 4.000 token. anggaran sesi tunggal: 30.000 token. jika mandat dekat dengan langit-langit anggaran, situasi saat ini dirangkum dan kemudian dimulai kembali. jangan memaksa. ini akan lebih baik untuk jelas mengungkapkan masalah overspendmmer anggaran daripada overspendmmer。

KLADE.md, tanpa batasan anggaran, setara dengan cek kosong. Setiap siklus dapat kehabisan kendali dan dibuang dalam konteks 50.000 token. Model tidak berhenti sendiri。

Itu adalah momennya: sesi debug berlangsung 90 menit. Model tersebut telah menelusuri ulang pesan-pesan yang salah seputar 8KB yang sama dan secara bertahap melupakan pilihan restorasi mana yang telah ia coba. Pada akhirnya, mulai menghasilkan 40 ide yang telah saya tolak sebelumnya. Jika ada anggaran token, prosesnya harus dihentikan dalam 12 menit。

Aturan 7: Pendedahan konflik, bukan kompromi rata-rata

Jangan mencampur kedua model yang ada di perpustakaan kode jika mereka saling bertentangan. Pilih salah satu model ini, memberikan prioritas untuk memperbarui atau lebih model yang diuji, membenarkan mereka dan menandai pembersihan berikutnya dari yang lain. Kode Øaverage" yang mencoba untuk memenuhi kedua set aturan sekaligus adalah yang terburuk。

Dan ketika kedua bagian koding berada dalam konflik, Claude akan mencoba untuk menyenangkan kedua belah pihak, dan hasilnya adalah kode yang tidak koheren。

Itu adalah momen ketika ada dua mode pemprosesan-kesalahan dalam satu perpustakaan kode, satu async/await-surplus coba/catch dan lain-lain perbatasan global yang salah. Claude menulis kode baru yang menggunakan kedua set. Akibatnya, kesalahan dilakukan dua kali. Aku butuh 30 menit untuk mencari tahu mengapa kesalahan itu ditelan dua kali。

Pertama, bacalah

BAHASA Baca konten ekspor dokumen, penelepon langsung, dan setiap fungsi alat bersama yang jelas relevan sebelum menambahkan kode ke dokumen. Jika Anda tidak mengerti mengapa kode yang ada begitu terorganisir, tanya dulu, jangan menambahkan apapun langsung ke dalamnya. Tampaknya tidak relevan bagi saya" adalah frasa yang paling berbahaya di perpustakaan kode。

Modifikasi Øsourgery milik IGN Karpathy" menyuruh Claude untuk tidak mengubah kode yang berdekatan. Namun tidak memberitahu Claude: memahami kode yang berdekatan terlebih dahulu. Tanpa ini, Claude akan menulis kode baru yang bertentangan dengan kode yang ada di luar 30 baris。

Itulah momennya: Claude menambahkan fungsi yang identik dengan fungsi yang ada karena tidak membaca fungsi aslinya terlebih dahulu. Kedua fungsi itu melakukan hal yang sama. Namun karena susunan laporan, fungsi baru meliputi fungsi lama, yang telah ada selama enam bulan sebagai satu-satunya kriteria sebenarnya。

Aturan 9: Pengujian bukanlah pilihan, tetapi pengujian bukanlah akhir dari dirinya sendiri

Setiap tes harus diberi kode "mengapa perilaku ini penting" dan bukan hanya "apa yang dilakukannya." Tes seperti `getUser'.tobe (`John') 'tidak berguna jika fungsi benar-benar menerima ID berkode keras. Jika Anda tidak dapat menulis tes yang akan gagal ketika logika bisnis berubah, fungsi itu sendiri salah。

Eksekusi yang berorientasi-target " menunjukkan bahwa pengujian dapat menjadi kriteria sukses. Namun dalam praktiknya, Claude menggunakan kata "test pass" sebagai satu-satunya tujuannya, sehingga ia menulis beberapa kode yang dapat lulus tes subsurface, tetapi itu akan menghancurkan segala sesuatu yang lain。

Itu adalah saat: Claude menulis 12 tes untuk fungsi autentikasi, semua lulus. Namun logika sertifikasi di lingkungan produksi rusak. Tes-tes tersebut hanya memeriksa bahwa fungsi "kembali ke sesuatu," tidak apakah itu kembali ke hal yang benar. Fungsi PU diuji karena mengembalikan sebuah konstanta。

Aturan 10: Operasi yang berjalan untuk waktu yang lama membutuhkan titik pemeriksaan

Dalam setiap tugas multi-langkah, ringkasan dari apa yang telah dilakukan, apa yang telah diuji dan apa yang masih harus dilakukan. Jangan turun dari negara bagian Anda tidak bisa mengulangi kepada saya. Jika Anda menemukan diri Anda hilang, berhenti dan beristirahat negara saat ini。

Interaksi baku dari template Karpati adalah satu-off. Namun pekerjaan Claude Code yang asli sering kali multi-langkah: lebih dari 20 berkas, membangun fungsionalitas dalam satu sesi, atas debugging komisi berganda. Jika tidak ada pos pemeriksaan dan satu langkah yang salah, semua kemajuan di depan mungkin hilang。

Itu adalah saat: 6 langkah misi konfigurasi ulang berjalan salah di langkah ke-4. Pada saat saya tahu, Claude telah melanjutkan langkah 5 dan 6 di atas negara yang salah. Jumlah total waktu yang dihabiskan untuk membongkar perbaikan masih lama. Jika ada titik pemeriksaan, langkah 4 akan mengungkapkan masalah。

Peraturan 1: Perjanjian sebelumnya atas inovasi

Jika perpustakaan kode menggunakan kasus ular, Anda lebih suka koper unta: gunakan kasus ular. Jika perpustakaan kode menggunakan komputer berbasis kelas, dan Anda lebih suka menggantung: gunakan komputer berbasis kelas. Pandangan yang berbeda adalah diskusi lain. Kekonsistenan mengambil alih preferensi individu di dalam coding house. Jika Anda benar-benar berpikir bahwa kesepakatan itu berbahaya, jelaskan. Jangan membuka jalan terpisah dalam keheningan。

Claude suka memperkenalkan dirinya di perpustakaan kode yang didirikan dengan baik. Bahkan jika ditulis "lebih baik," memperkenalkan model kedua itu sendiri akan lebih buruk daripada model tunggal manapun。

Itu adalah saat ketika Claude memperkenalkan Hooks dalam repositori React berdasarkan komponen kelas. Ini benar-benar bisa berjalan. Namun pada saat yang sama, ia menghancurkan model pengujian asli dari perpustakaan kode karena tes tersebut bergantung pada komputer Did Mount. Butuh setengah hari untuk menghapusnya dan menulis ulang。

Aturan 12: Untuk terlihat, jangan sampai gagal diam - diam

Jika Anda tidak bisa memastikan sesuatu dilakukan, katakan dengan jelas. Jika 30 catatan dilompat diam-diam, tidak dapat dikatakan bahwa migrasi selesai. Jika Anda melewatkan tes apapun, Anda tidak dapat mengatakan "tes lulus." Jika kau belum memverifikasi batas-batas yang kuminta, kau tak bisa bilang "berfungsi." Eksposur ke ketidakpastian, bukan menyembunyikannya。

Kegagalan termahal Claude, sering kali yang terlihat seperti sukses. Fungsi "dapat berjalan", tetapi mengembalikan data yang salah; migrasi "selesai" tetapi melewatkan 30 catatan; dan tes "dilewati"hanya karena afirmasi itu sendiri salah。

Ini adalah saat ketika Claude mengatakan migrasi database adalah "berjaya". Tapi kenyataannya, itu hilang diam-diam catatan 14 persen yang memicu konflik mengikat. Melewatkan direkam dalam log tanpa terkena secara eksplisit. Sebelas hari kemudian, ketika data laporan mulai meledak, kami menemukan masalahnya。

Hasil data jar

Selama enam minggu, saya melacak kelompok yang sama dari 50 misi perwakilan, yang meliputi 30 perpustakaan kode dan menguji tiga konfigurasi。

Tingkat kesalahan niaga berarti bahwa misi perlu dikoreksi atau ditulis ulang agar sesuai dengan maksud aslinya. Errors termasuk: asumsi kesalahan diam, over-engineering, kerusakan tidak terganggu, kegagalan diam, pelanggaran perjanjian, kompromi konflik, dan pos pemeriksaan hilang。

Tingkat kepatuhan mengacu pada kemungkinan bahwa ketika sebuah aturan diterapkan, aplikasi Claude ' s akan jelas。

Hasil yang benar-benar menarik bukan hanya bahwa tingkat kesalahan menurun dari 41% menjadi 3%. Lebih penting lagi, perpanjangan aturan 4 untuk memerintah 12 hampir tidak meningkatkan beban kepatuhan, dengan tingkat kepatuhan menurun dari 78 persen menjadi 76 persen, tetapi tingkat kesalahan menurun 8 persen. Model - model yang tidak dialamatkan oleh 4 aturan asli, dan tidak bersaing untuk anggaran perhatian yang sama。

Di mana akan gagal diam-diam

Bahkan tanpa aturan baru, 4 aturan asli tidak cukup di setidaknya 4 tempat。

Pertama, menjalankan tugas Agen untuk waktu yang lama。
Aturan-aturan yang dikemukakan oleh Camagi terutama untuk Claude pada saat dia menulis kode. Tapi apa yang terjadi ketika Claude menjalankan jalur pipa multilangkah? Templat aslinya tidak memiliki aturan anggaran, tidak ada aturan poin cek dan tidak ada "menunjukkan kegagalan" aturan. Jadi Pipeline akan perlahan hanyut。

Kedua, konsistensi perpustakaan multi-kode。
Hanya ada satu gaya secara baku. Namun dalam monorepo 12-service, Claude harus memilih gaya mana yang cocok. Aturan asli tidak memberitahu cara memilih. Jadi itu dipilih secara acak, atau mencampur beberapa gaya。

Ketiga, kualitas tes。
\"Pelaksanaan berorientasi-Target\" akan melihat \"tes lulus\" sebagai sukses, tanpa mengatakan bahwa tes itu sendiri harus berarti. Akibatnya, Claude menulis beberapa tes yang hampir tidak diverifikasi, tetapi mereka membuatnya berpikir dia yakin。

Keempat, perbedaan antara lingkungan produksi dan fase prototipe。
Aturan yang sama akan mencegah over-rekayasa kode produksi, tetapi juga dapat memperlambat pengembangan prototipe. Karena fase prototipe kadang-kadang membutuhkan 100 baris pencacah eksploratif, pertama mencari arah. Keprioritasan Hafasis Karpatipathydisederhanakan" terlalu mudah dipicu oleh kode awal。

Kedelapan aturan baru ini tidak dimaksudkan untuk menggantikan empat aturan asli Karpati, tetapi mengisi kesenjangan mereka: Templat asli sesuai dengan sebuah adegan penulisan kode auto-lengkap pada Januari 2026; pada Mei 2026, Claude Code telah memasuki sebuah Agen-driven, multi-langkah, multi-kode repositori kolaboratif lingkungan, yang memiliki masalah yang berbeda。

Apa yang tidak berhasil

Saya juga telah mencoba beberapa pilihan lain sebelum menyelesaikan 12 aturan。

Ditambah peraturan yang kulihat di Reddit / X。
Sebagian besar dari mereka, baik mengulang empat aturan asli Karpati dalam istilah yang berbeda atau adalah bidang-aturan khusus yang tidak dapat digeneralisasi, seperti "selalu menggunakan kelas Tailling". Mereka semua dihapus。

- Lebih dari 12。
Saya diuji sampai 18. Setelah melebihi 14 artikel, tingkat kepatuhan turun dari 76% menjadi 52%. [ Gambar di hlm. Lebih dari itu, Claude akan mulai mencocokkan pola dengan Ærules di sini" daripada aturan yang sebenarnya berdasarkan aturan。

Aturan-aturan yang mengandalkan keberadaan alat-alat tertentu。
sebagai contoh, "selalu menggunakan eslint", aturan yang lapses ketika tidak ada eslint yang dipasang dalam proyek. aku kemudian mengubahnya menjadi ungkapan yang tidak bergantung pada alat-alat tertentu, seperti "use eslint" daripada "mengikuti gaya yang ditegakkan di perpustakaan kode."。

Gunakan contoh dalam CLAUDE.md daripada aturan。
Contoh adalah lebih konteks daripada aturan. Konteks di mana ketiga contoh yang dikonsumsi hampir setara dengan 10 aturan, dan Claude dapat dengan mudah mengatasi contoh-contoh. Aturan-aturan yang abstrak dan contoh-contoh yang spesifik. Oleh karena itu, aturan harus digunakan。

Hati-hati, berpikir dengan hati-hati, dan lebih fokus。
Ini adalah suara. Tingkat kepatuhan untuk arahan tersebut jatuh ke sekitar 30 persen karena mereka tidak dapat diuji. Lalu aku menggantinya dengan aturan perintah yang lebih spesifik, seperti asumsi yang berbeda"。

Beritahu Claude untuk bertindak seperti insinyur senior。
Ini tidak bekerja. Claude merasa seperti seorang insinyur senior. Pertanyaan yang sebenarnya bukan apakah itu percaya, tapi apakah itu diterapkan dengan cara itu. Aturan komando dapat mempersempit celah ini, dan bukan tips identitas。

Penguasa Penuh 12

Berikut ini adalah versi lengkap yang dapat digunakan untuk menempel secara langsung。

Tak dapat menampilkan ini di luar dokumen flybook

Simpan sebagai CLAUDE.md dalam direktori akar gudang. Di bawah aturan ini, menambahkan aturan terpisah untuk item seperti tumpukan teknologi, perintah uji, pola kesalahan, dll. Jangan melebihi 200 baris secara keseluruhan. Setelah itu, akan ada penurunan kepatuhan。

Bagaimana Menginstal

Dua langkah sudah cukup:

Ada empat aturan dasar Karpati di CLAUDE.md-mu
curling https://raw.githubusercontent.com/forrestchange/andrej-karpati-skills/main/CLAUDE.md > > CLAUDE.md

[2] Coba lihat aturan 5-12 di bawah

Simpan fail dalam direktori root repositori. Ini adalah > > yang penting untuk menambah CLAUDE.md yang ada, daripada melampaui aturan eksklusif yang telah Anda tulis。

Model mental mental

CLUDE.md bukan daftar keinginan, tetapi kontrak konduksi untuk memblokir pola spesifik kegagalan yang telah Anda amati。

Setiap aturan harus menjawab pertanyaan: Apa yang dapat mencegahnya

Aturan keempat Karpatia adalah untuk berjaga-jaga terhadap pola kegagalan yang ia lihat pada Januari 2026: asumsi diam, over-engineering, vandalisme, kriteria keberhasilan lemah. Mereka adalah yayasan, jangan lewatkan。

Saya menambahkan aturan baru delapan untuk berjaga-jaga terhadap munculnya pola kegagalan baru setelah Mei 2026: loop Agent yang tidak dibudget, misi multi-langkah tanpa pos pemeriksaan, tes yang tampaknya telah diuji tetapi yang tidak benar-benar mendeteksi logika kritis, dan pertanyaan kegagalan diam kemasan ke dalam keberhasilan diam. Mereka tambahan patch。

tentu saja, efeknya berbeda - beda. jika anda tidak menjalankan beberapa langkah, aturan 10 kurang penting bagi anda. jika kode perpustakaan anda hanya satu gaya seragam dan telah ditegakkan oleh int, aturan 11 adalah berlebihan. setelah membaca kedua belas artikel itu, jagalah aturan yang benar - benar menyesatkan dan menghapus yang lain。

Sebuah versi enam-berkuasa CLUDE.md, disesuaikan dengan pola kegagalan sejati, outnumbers versi dua belas-aturan dari enam yang tidak pernah Anda gunakan。

Kata-kata palsu

Tweet dari Kekarathy pada Januari 2026 pada dasarnya adalah keluhan. Forrest Chang mengubahnya menjadi empat aturan. Akhirnya, 120.000 pengembang memberikan hasilnya kepada Star. Dan sebagian besar dari mereka masih hanya menggunakan empat aturan hari ini。

Model telah maju dan ekologi telah berubah. Agen Multistep, pemicu rantai kait, beban keterampilan, kolaborasi pustaka multi-kode - Tidak satupun dari ini ada ketika Karpathy menulis tweet itu. Aturan asli 4 tidak mengatasi masalah tersebut. Mereka tidak salah, tapi tidak lengkap。

Hukuman baru. 6 minggu, lebih dari 30 kode perpustakaan. Laju kesalahan menurun dari 41% menjadi 3%。

Artikel ini akan dikumpulkan malam ini untuk menempelkan 12 aturan ini ke dalam CLAUDE.md Anda. Jika itu membantu Anda berjalan seminggu kurang Claude membungkuk, selamat datang ke depan。

[Terkekeh]Bahasa Asli]