Orijinal Metin Başlığı: Karpathy'nin CLAUDE.md Dosyası GitHub'da 82.000 beğeniyle 1. sıraya yükseldi. Çoğu geliştirici henüz okumadı.

Orijinal Metin Yazarı: Dep

Ed.'s Notu: Birçok insan Claude Code'u kullanırken, en büyük sorunun modelin yeterince güçlü olmaması değil, her seferinde sıfırdan başlaması olduğunu fark etti.

Claude'a proje geçmişi, teknoloji yığını, kod standartı, hangi bölümlerin değiştirilmemesi gerektiği, önceden denenmiş çözümler hakkında tekrar tekrar bilgi vermeniz gerekir. Bu bilgiler sabitlenmediği sürece, Claude tahminleme üzerinden çalışır ve sonuç olarak yanlış dosyaların değiştirilmesi, gerekmediği halde yeniden yapılan kodlar, hatta mevcut projeye uygun olmayan araçlar önerilmesi gibi durumlarla karşılaşabilirsiniz.

Bu belirtilerdeki CLAUDE.md, Claude Code için bir kullanım kılavuzu olarak hizmet eder. Bu dosyayı sadece projenizin kök dizinine koymanız yeterlidir, Claude her başladığında otomatik olarak okur. Bu dosya Claude'a önceden nasıl cevap vereceğini, nasıl kod yazacağını, ne zaman önce soru sorması gerektiğini, hangi işlemleri kendi başına yapamayacağını, proje hangi teknoloji yığınıyla çalışıyor, ve geçmişte hangi önemli kararların alındığını bildirir.

Basitçe söylemek gerekirse, CLAUDE.md'nin amacı: tekrarlayan açıklamaları azaltmak, modelin sınırlarını belirlemek, AI programlamayı daha istikrarlı ve kontrol edilebilir hale getirmektir.

Claude Code kullanıyorsanız, önce Karpathy'nin özetlediği 4 kurala başlayabilirsiniz: Emin değilseniz sorun, en basit çözümü dene, ilgili olmayan kodlara dokunma, belirsizlikleri açıkça belirt. Bu kuralları başlangıçta CLAUDE.md'ye yazın, ardından kendi projenize göre aşamalı olarak eklemeye başlayarak kullanım deneyimini belirgin şekilde geliştirebilirsiniz.

Aşağıda orijinal metin yer almaktadır:

GitHub Trending'de CLAUDE.md adlı bir dosya zirveye oturdu.

82.000 beğeni, 7800 çatal.

Bu olay Andrej Karpathy tarafından başlatıldı. Daha önce Tesla'nın AI başkanlığını yapan ve aynı zamanda OpenAI'ın kurucu üyelerinden biri olan Karpathy, Claude Code'u işlevsiz kılacak 4 davranış tespit etti ve bunları bir dosyaya yazdı.

Sonrasında bir geliştirici bu 4 kuralı genişleterek ve bu dosyayı açıkça yayınlayarak konuyu hızla popülerleştirdi.

Nedeni oldukça açıktır: Doğruluk oranı %65'ten %94'e yükseldi.

Ancak günlük olarak Claude Code'u kullanan geliştiricilerin çoğu, aslında bu ayarı hiç yapmamıştır. Her oturumda sıfırdan başlarlar: aynı bağlamı tekrar açıklarlar, gereksiz kapsam değişikliklerini temizlerler, kimse istemediği yeniden yapılandırmaları geri alırlar.

Aşağıda tam belge yer almaktadır.

Çoğu Geliştiricinin Atladığı Ayar

Claude Code'u açtığınızda her zaman hiçbir şey bilmiyormuş gibi gelir.

Teknoloji yığını hakkında bilgisi olmaz, kod standartlarınızı bilmemektedir, projenizin arka planını bilmez, daha önce ne denediğinizi bilmez ve üç önceki oturumda kesin olarak ne yapmayı reddettiğinizi bilmez.

Bu yüzden sadece tahmin edebilir. Ve bir kez tahmin etmeye başladığında, sizin istemediğiniz kodları yeniden yapılandırabilir, mevcut mimariyi bozacak şekilde çerçeveleri önerir, doğrulanmadan dosyaları siler ve hatta daha önce verdiğiniz kararları altüst edebilir.

CLAUDE.md, kök dizinde bulunan bir düz metin dosyasıdır. Claude Code, her oturuma başladığında otomatik olarak onu okur.

Bir kere ayarlayın, tekrar tekrar açıklama yapmanıza gerek kalmayın ve üç tür maliyetli hatayı düzeltebileceksiniz.

Varsayılan Ayar: Her Hafta Kendinizi Tekrar Açıklamanızın Maliyeti 375 Dolar

Normal bir geliştirici, yaklaşık olarak her gün Claude'a bağlamı yeniden açıklamak için 30 dakika harcamaktadır.

Teknoloji yığını, kod standartları, proje geçmişi, denenen yöntemler - bu bilgileri tek seferde yazmaz ve Claude her seferinde otomatik olarak okumazsanız, bu bilgiler farklı oturumlar arasında korunmaz.

Saatlik ücretiniz 150 dolar olarak hesaplanıyorsa:

· Günlük 30 dakika, yani 75 dolar;

· Haftalık olarak 375 dolar.

· Eğer 5 kişilik bir ekipse, haftalık 1875 dolarlık gizli maliyet ortaya çıkar.

Aşağıdaki 7 kural, CLAUDE.md dosyasının en üstüne yerleştirilmelidir.

→ Gereksiz Konuşmaları Kaldır

Cevap verirken "Güzel soru", "Tabii ki yapabilirsiniz", "Sorun değil" veya benzeri giriş cümleleri kullanmayın. Doğrudan cevabı verin. Selamlaşmayın, soruyu tekrarlamayın.

→ Cevabı Görevin Uzunluğuna Göre Ayarlayın

Cevap uzunluğu görevin karmaşıklığıyla uyumlu olmalıdır. Basit sorulara doğrudan ve kısa cevap verin; karmaşık görevler için eksiksiz ve detaylı açıklamalar yapın. Metni doldurmak için soruyu tekrarlama veya sonuç cümlelerini tekrarlamastratejisini kullanmayın.

→ İşe Başlamadan Önce Çözüm Sunun

Önemli bir göreve başlamadan önce, işlemem için 2-3 geçerli yol sunun, ben seçtikten sonra devam edin.

→ Belirsizlik Zarara Neden Olacaksa, Belirsizliği Kabul Edin

Herhangi bir gerçek, veri, tarih veya teknik bilgide belirsizseniz, alıntı yapmadan önce açıkça belirtin. Bilgi boşluklarını doldurmak için görünüşte mantıklı bilgi kullanmayın. Emin olmadığınız konularda direkt belirsiz olduğunuzu söyleyin.

→ Kimim, Ne Bildiğim

Benim Hakkımda: [Ad] / Rol: [Pozisyonunuz] / Arka Plan: [Alanınız].

Uzmanlık Alanım: [Uzmanlık Alanınız].

Hâlâ Öğrenmekte Olduğum Konular: [Bilgi Eksiklikleriniz].

Lütfen bu bilgilere göre her cevabın derinliğini ayarlayın. Zaten bildiğim konuları aşırı açıklamaktan kaçının ve ihtiyacım olan bağlamı atlamayın.

→ Mevcut Proje Bağlamı

Üzerinde Çalıştığım: [Proje Adı] / Hedef: [Belirli Sonuç] / Hedef Kitlesi: [Kim Kullanacak] / Kullanılan Teknoloji Yığını: [İlgili Kısıtlamalar] / Kaçınılması Gerekenler: [Liste].

Lütfen bu bağlamı her görevde uygulayın. Eğer bir gereksinim bağlama uymuyorsa, uygulamadan önce beni uyarın.

→ Kendi İfade Tarzınızı Belirleyin

Yazım tarzım: [İfade Tarifiniz].

Cümle Uzunluğu: [Tercihiniz].

Sık Kullandığım Kelimeler: [Örnekler].

Asla Kullanmayacağım Kelimeler: [Örnekler].

Format: [Mektup ya da Yapılandırılmış].

Sizin adınıza herhangi bir içerik yazarken, kesinlikle bu stile sıkı sıkıya uyun ve kendi ifade tarzınızı kullanmayın.

Günlük olarak bağlamı tekrar açıklama süresi: 30 dakika

Geliştirici Saatlik Ücretine Göre Hesaplama: Günlük 75 ABD Doları

Haftalık: Her Bir Geliştirici için 375 ABD Doları

5 Kişilik Ekip: Haftalık 1875 ABD Doları

Bu Bölüm CLAUDE.md Ayarları Zamanı: Toplam 45 Dakika

Yanlışlıkla Yapılmaması Gerekenler: CLAUDE.md'yi sıfırdan yazmayın. Önce aşağıdaki bu adımı kullanın, ardından çıktıyı düzenleyin:

Benim hakkımda, projem hakkında ve nasıl çalışmayı umduğum hakkında size söylediklerime dayanarak, benim için eksiksiz bir CLAUDE.md dosyası yazın. İçerik şunları içermelidir: Ben kimim, teknik geçmişim, iletişim tercihlerim ve her oturumda uyulması gereken varsayılan davranışlar. Ayrıntılı, saf metin, maksimum 500 kelime.

Davranış Kısıtlaması: "Saatlik 150 ABD Doları" Yetkilendirmenizin Dışındaki Değişiklikler

Claude'a bir işlevi düzeltmesini söylediniz.

Sonuç olarak, üç dosyayı yeniden yapılandırdı, değişkenleri yeniden adlandırdı, içe aktarmaları yeniden düzenledi ve sizin zaman ayırarak yazdığınız yorumları yeniden yazdı.

Ve tüm bunlar sizin onayınız olmadan oldu.

Bu gereksiz değişiklikleri gözden geçirip geri almak için 1 saat, yani 150 ABD Doları gerekebilir. Haftada üç kez olursa, 450 ABD Doları yapar. 5 kişilik ekip için haftalık toplam ise 2250 ABD Dolarıdır, yetkilendirilmemiş değişiklikleri temizlemek için.

Aşağıdaki 7 kural, CLAUDE.md'nin Davranış Kısıtlaması bölümüne konmalıdır.

→ Kapsamı Sıkı Bir Şekilde Kontrol Et

Sadece mevcut görevle doğrudan ilgili olan dosyaları, işlevleri ve kod satırlarını değiştirin. Açıkça değiştirmenizi istemediğim içeriği yeniden yapılandırmayın, yeniden adlandırmayın, yeniden düzenlemeyin, biçimlendirmeyin veya "optimize etmeyin".

Eğer başka bir yerde düzeltme yapılması gerektiğini düşünüyorsanız, lütfen sona bir notla belirtin. Ona dokunmayın, asla.

→ Büyük Değişikliklerden Önce Danışın

Benim tarafımdan oluşturulan içeriği önemli ölçüde değiştirmeden önce, bölüm yeniden yazmak, paragraf silmek, yapıyı yeniden düzenlemek, hitap şeklini değiştirmek gibi, durun ve tam olarak neyi değiştirmeyi planladığınızı ve neden değiştirmeyi planladığınızı açıklayın. Onayımı aldıktan sonra devam edin.

→ Herhangi Bir Zararlı İşlem Önceden Onay Gerektirir

Herhangi bir dosyanın silinmesi, mevcut kodun üzerine yazılması, veritabanı kaydının silinmesi veya bağımlılığın kaldırılması öncesinde durun, etkilenecek öğeleri açıkça belirtin ve benim açık bir onayımı talep edin. Sadece bu ileti içinde "Evet" dediğimde devam edebilirsiniz.

"Daha önce bahsettiğiniz" onay anlamına gelmez.

→ Üretim Ortamı İşlemleri Zorunlu Olarak Durmalı

Aşağıdaki işlemler, şu anki oturumda açıkça onay almazsa yapılamaz, istisna yoktur:

· Herhangi bir ortama dağıtım veya yayınlama;

· Göçü çalıştırma veya veritabanı yapı değişikliği;

· Herhangi bir harici API çağrısı gönderme;

· Geri dönüşü olmayan yan etkilere sahip herhangi bir komutu yürütme.

· Bu ileti içinde net bir şekilde "Evet" dediğimde.

→ Her Zaman Yapılan Değişiklikleri Göster

Herhangi bir kodlama görevi tamamlandıktan sonra, sona erdirme şunları içermelidir:

Değiştirilmiş dosyalar: Değiştirilmiş tüm dosyalar listelenmelidir;

Değiştirilen içerik: Her dosya için bir cümlelik açıklama gereklidir;

Bilerek değiştirilmemiş dosyalar;

Sonraki adımlar.

→ Açık Onay Almadan Beni Temsil Etmeyin

Şu anki ileti içinde net onayım olmadan, beni temsil ederek hiçbir içerik gönderemez, yayınlayamaz, paylaşamaz veya düzenleyemezsiniz. Bu e-posta, takvim daveti, belge paylaşımı veya şu anki konuşma dışında gerçekleşen herhangi bir işlemi içerir. Net bir şekilde "Evet" dediğimde.

→ Kod Yazmadan Önce Düşünün

Mimari kararlar, karmaşık sorunlar için hata ayıklama veya basit olmayan özellik geliştirme gibi görevlerde, adım adım sorunu çözümlemeli ve kod yazmalısınız. Mantıklı sürecinizi gösterin, belirsizlikleri belirtin ve ardından uygulamaya geçin.

Haftalık gereksiz kapsam değişikliği geri alımı: 150 ABD Doları

Haftalık manuel diff kontrolü: 75 ABD Doları

Her geliştirici davranışından kaynaklanan kayıp: Haftalık 225 ABD Doları

5 kişilik ekip: Haftalık 1125 ABD Doları

CLAUDE.md Davranış Bölümü Ayarlama Süresi: 30 dakika

Hafıza ve Teknoloji Yığını: Claude Code'un Gerçekten Güvenilir Olmasını Sağlayın

Claude, farklı oturumlar arasında her şeyi unutacaktır.

Her kararı verdikten sonra, başarısız olduğun her seçenek, altı ay önce neden Prisma'yı seçtiğine ve Drizzle yerine, ve belirli bir müşteri gereksiniminden gelen bir kısıtlamanın nedeni — hepsi unutulacak.

Sonra, daha önce reddettiğin seçenekleri tekrar sunacak.

Bu bölüm, Claude'e mevcut "gerçek hafıza"ya en yakın mekanizmayı sağlamakla kalmayacak, aynı zamanda teknoloji yığınınızı kilitleyerek, mevcut mimariyi bozacak araçların önerilmesini engelleyecektir.

→ MEMORY.md Karar Günlüğü

MEMORY.md adında bir dosyayı projede tutun. Önemli bir karar verildiğinde, bir kayıt ekleyin:

·Ne karar verildi;

·Neden bu karar verildi;

·Ne hariç tutuldu ve neden hariç tutuldu.

Her oturum başlamadan önce MEMORY.md'yi okuyun. Hatırlatma olmadan, kaydedilen kararlarla çelişen bir şey yapmayın.

→ Oturum Sonu Özeti

Ben "oturum sonu," "bitirme" veya "burada durabiliriz" dediğimde, bir oturum özeti yazmak için MEMORY.md'ye şunları ekleyin:

·Bu oturumda ne ele alındı;

·Hangi konular tamamlandı;

·Hala devam eden konular;

·Hangi kararlar alındı;

·Sonraki oturumun öncelikleri.

→ ERRORS.md Başarısızlık Günlüğü

ERRORS.md adında bir dosyayı tutun. Bir seçenek iki kez denendikten ve hala başarılı olunamadıktan sonra, kaydedin:

·Ne işe yaramadı;

·Nihayet ne işe yaradı;

·Sonraki sefer nelere dikkat etmek gerekti.

Benzer bir göreve bir çözüm önermeden önce ERRORS.md'yi kontrol edin.

→ Kalıcı Gerçekler Listesi

Aşağıdaki gerçekler bu projede her zaman geçerlidir ve her oturuma istisnasız olarak uygulanmalıdır:

[Your Immutable Constraints, Architecture Decisions, and Rules]

If a task conflicts with these facts, please point it out before execution.

→ Lock-in Technology Stack

The technology stack for this project is as follows, always use these tools. Do not recommend alternative solutions unless explicitly requested by me:

Language: [e.g., TypeScript]

Framework: [e.g., Next.js 14]

Package Manager: [e.g., pnpm]

Database: [e.g., PostgreSQL with Prisma]

Testing: [e.g., Vitest]

Styling: [e.g., Tailwind CSS]

If a tool seems inappropriate, you may point it out. However, unless I explicitly state otherwise, the defined technology stack must be used.

→ Tough Decision Enable Extension Thinking

For issues involving system architecture, performance trade-offs, database design, or long-term technical decisions, please use extension thinking mode.

Analyze the problem step by step, propose trade-offs that I may not have considered, point out assumptions that may not hold true at scale, and then provide your recommendation.

→ The 4 Cardinal Rules That Turn Red

Karpathy summarized 4 behaviors that would cause Claude Code to fail. A developer distilled them into the following 4 rules. As a result, coding accuracy increased from 65% to 94%.

Ask First, Don't Assume.
If there is any ambiguity, ask before writing the first line of code. Do not make silent assumptions about intent, architecture, or requirements.

Do the Simplest Thing First.
Always implement the simplest solution that works. Do not introduce unrequested abstraction layers or flexibility.

Don't Touch Unrelated Code.
If a file or function is not directly related to the current task, do not modify it. Even if you think it can be optimized, do not touch it.

Explicitly Mark Uncertainty.
If you are not certain about a solution or technical detail, state it before proceeding. Showing confidence without certainty causes more damage than admitting a knowledge gap.

· Unutma kararları ve yanlış önerilerden kaynaklanan haftalık kurtarma maliyeti: Her geliştirici için 300 ABD Doları

· Yanlış teknoloji yığını önerisi ve uyumsuz araçlar: Haftalık 75 ABD Doları

· Her geliştiricinin hafıza ile ilgili israfı: Haftalık 375 ABD Doları

· 5 kişilik ekip: Haftalık 1875 ABD Doları

· MEMORY.md + ERRORS.md + Teknoloji Yığını Ayarlama Süresi: 20 dakika

Sonuç

Tam maliyet hesabı aşağıdaki gibidir:

· Haftalık bağlamın tekrar açıklanması: 375 ABD Doları

· Yetkilendirilmemiş değişikliklerin geri alınması: Haftalık 225 ABD Doları

· Unutulan kararların neden olduğu sorunların haftalık işlenmesi: 375 ABD Doları

· Her geliştiricinin haftalık toplam israfı: 975 ABD Doları

Eğer 5 kişilik bir geliştirici ekibi ise: Haftalık 4875 ABD Doları. Yılda 253.500 ABD Doları.

Ancak CLAUDE.md'nin kurulumu sadece 2 saat sürmektedir.

Sadece Karpathy'nin 4 kuralı, kodlama doğruluğunu %65'ten %94'e yükseltti.

Bir metin dosyası, 21 kural, iki saatlik çalışma süresi.

Bu kurulumu yapan geliştirici aslında daha güvenilir bir Claude kullanıyor: Kararları hatırlayabilir, görev kapsamını kontrol edebilir, yıkıcı bir işlem öncesinde onay isteyebilir ve mevcut mimariyi bozacak bir çerçeve önermez.

Henüz kurulum yapılmamış kişiler ise hala kendilerini haftalık 975 ABD Doları harcıyorlar.

Not: Karpathy'nin 4 kuralından başlayın. Yalnızca bu 4 kuralı gerektirir. Şimdi bunları projenizin kök dizinine, CLAUDE.md adında yeni bir dosyaya yapıştırın, yalnızca 2 dakika sürer. Sonrasında her hafta bulduğunuz eksiklikleri adım adım ekleyin.

Bilgi akışı altında kaybolmadan önce bunları yer imlerine ekleyin. Faydalı bulursanız, gerçekten ihtiyacı olan birine paylaşabilirsiniz.

[Orijinal Makale Bağlantısı]

BlockBeats Resmi Topluluğuna Katılın:

Telegram Abonelik Grubu: https://t.me/theblockbeats

Telegram Sohbet Grubu: https://t.me/BlockBeats_App

Twitter Resmi Hesabı: https://twitter.com/BlockBeatsAsia