CLAUDE.md: Andrej Karpathy'nin 4 Kuralı ve Kurulumu (Türkçe Rehber)

CLAUDE.md: Karpathy'nin 4 kuralı

OpenAI'ın kurucu ortaklarından Andrej Karpathy, yapay zekânın kod yazarken hep aynı hataları yaptığını yazdı. Bu gözlemler Claude Code'un her oturumda okuduğu 65 satırlık bir dosyaya dönüştü. Dört kuralın Türkçe açıklaması, kurulum komutu ve PDF rehber bu sayfada.

01Kod yazmadan önce düşün

02Önce sadelik

03Cerrah gibi değiştir

04Hedefe göre çalış

Karpathy ne yazdı?

Hataların artık basit yazım hataları olmadığını, “aceleci bir stajyerin” yapacağı türden kavramsal hatalar olduğunu anlattı: senin yerine yanlış varsayım yapmak, netleştirme istememek, kodu şişirmek, işle ilgisi olmayan kodu değiştirmek. Ertesi gün geliştirici Jiayuan Zhang bu gözlemleri CLAUDE.md dosyasına çevirdi.

Gönderinin tamamı →

Kod yazmadan önce düşün

Kural 1 · Think Before Coding

Claude işe başlamadan önce varsayımlarını açıkça söyler. Emin değilse sorar. İsteğin birden fazla yorumu varsa sessizce birini seçmez, seçenekleri önüne koyar. Daha basit bir yol görürse söyler, gerekirse itiraz eder.

Karpathy ne dedimodeller “senin yerine yanlış varsayımlar yapıyor ve kontrol etmeden devam ediyor”.

Don't assume. Don't hide confusion. Surface tradeoffs.

Önce sadelik

Kural 2 · Simplicity First

İstenenin ötesinde özellik, tek kullanımlık kod için soyutlama, kimsenin istemediği “esneklik” yok. Ölçüt net: 200 satır yazdıysan ve 50 satırda olabiliyorsa, baştan yaz.

Karpathy ne dedi1000 satırlık şişkin bir yapı kuruyor; “bunu böyle yapamaz mısın?” deyince hemen 100 satıra indiriyor.

Minimum code that solves the problem. Nothing speculative.

Cerrah gibi değiştir

Kural 3 · Surgical Changes

Mevcut kodu düzenlerken yanındaki kodu, yorumları ya da biçimi “iyileştirmeye” kalkmaz, bozuk olmayanı yeniden yazmaz, projenin stiline uyar. Değişen her satır doğrudan senin isteğine bağlanabilmeli.

Karpathy ne dedimodeller “görevle ilgisi olmasa bile beğenmedikleri yorumları ve kodu değiştiriyor”.

Touch only what you must. Clean up only your own mess.

Hedefe göre çalış

Kural 4 · Goal-Driven Execution

Görevi doğrulanabilir bir hedefe çevirir: “hatayı düzelt” yerine “hatayı yeniden üreten bir test yaz, sonra geçir”. Çok adımlı işlerde her adımın yanına nasıl kontrol edileceğini yazar ve doğrulamadan bitti demez.

Karpathy ne dedi“Ne yapacağını söyleme, başarı ölçütünü ver ve izle.”

Define success criteria. Loop until verified.

Kurulum 1 dakika

Dosyayı indir

Projenin ana klasöründe terminali aç ve aşağıdaki komutu çalıştır. Ya da dosyayı GitHub'dan (multica-ai/andrej-karpathy-skills) elle indir.

Claude Code'u aç

Aynı klasörde claude yaz. Claude Code proje klasöründeki CLAUDE.md'yi her oturumun başında okur.

Kontrol et

Claude Code içinde /memory yaz; listede ./CLAUDE.md görünmeli.

› curl -O https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md
› claude

Sık sorulan sorular

Bu dosyayı Karpathy mi yazdı?

Hayır. Kurallar Andrej Karpathy'nin 26 Ocak 2026'daki X gönderisindeki gözlemlerden türetildi; dosyayı ertesi gün geliştirici Jiayuan Zhang yazdı. Depo GitHub'da multica-ai/andrej-karpathy-skills.

Zaten bir CLAUDE.md dosyam var, ne yapmalıyım?

Üzerine yazma. Dört kuralı kendi dosyanın sonuna “Davranış kuralları” başlığıyla ekle; projeye özel kuralların (komutlar, klasör yapısı, stil) üstte kalsın.

Bu dosya Claude'un tüm hatalarını çözer mi?

Hayır. Karpathy aynı gönderide CLAUDE.md'ye yazılan birkaç basit talimatın bu hataları tamamen ortadan kaldırmadığını söylüyor. Dosya Claude'u daha dikkatli yapar; önemli kodu yine de gözden geçirmek gerekir.

Kuralları Türkçeye çevirmem gerekir mi?

Gerekmez. Claude İngilizce talimatı anlar ve sana Türkçe cevap verir. İstersen kendi Türkçe notlarını ayrı bir başlık altında ekleyebilirsin.

CLAUDE.md: Karpathy'nin 4 kuralı