
Claude'u bugüne kadar hep yanlış kullandınız. CLAUDE.md ile her şeyi düzeltin. İşte nasıl yapılacağı. 👇
AI features
- Views
- 2.8M
- Likes
- 408
- Reposts
- 63
- Comments
- 11
- Bookmarks
- 1.4K
TL;DR
Bu rehber, Claude AI'a kalıcı talimatlar ve bağlam sağlamak için CLAUDE.md dosyasının nasıl kullanılacağını açıklar. İletişimi geliştirmek, proje hafızasını korumak ve kodlama doğruluğunu artırmak için 21 özel istem içerir.
Reading the TÜRKÇE translation
CLAUDE.md'yi duyan çoğu kişi aslında ne olduğunu bilmiyor.
Bilenler ise içine ne koyacaklarını tam olarak bilmiyor.
Ve bu boşluk, insanlara her hafta saatler kaybettiriyor. ⏰
İşte gerçek — her yeni Claude oturumu açtığınızda, sıfır hafızayla başlar.
Adınızı bilmez. İşinizi bilmez. Tercihlerinizi veya işlerin nasıl yapılmasını sevdiğinizi bilmez.
Bu yüzden ilk birkaç dakikayı her şeyi sıfırdan yeniden açıklayarak geçirirsiniz. Ya da açıklamazsınız — ve Claude size gerçekte nasıl çalıştığınıza hiç uymayan bir şey verir.
CLAUDE.md bunu kalıcı olarak çözer. 💡
İşte düzgün bir şekilde kurmak için ihtiyacınız olan 21 talimatın tamamı. 👇
Öncelikle — bu sadece bir geliştirici aracı DEĞİL. 🔥
Yazarlar, seslerini kilitlemek için kullanır, böylece Claude asla başka biri gibi konuşmaz. Pazarlamacılar, hedef kitlelerini tanımlamak için kullanır, böylece Claude genel geçer metinler yazmayı bırakır. Araştırmacılar, bilginin nasıl yapılandırılmasını istediklerini belirlemek için kullanır. İşletme sahipleri, Claude'a tüm şirket bağlamını vermek için kullanır, böylece her çıktı gerçekliklerine uyar.
CLAUDE.md olmadan — her oturuma sıfırdan başlarsınız. Kendinizi tekrar edersiniz. Aynı hataları düzeltirsiniz. Tercihlerinizi yüzüncü kez açıklarsınız.
CLAUDE.md, Claude ile ciddi bir işe başlamadan önce kurmanız gereken ilk şeydir. 🎯
2 dakikada nasıl oluşturulur ⚡
Proje klasörünüzü açın ve yeni bir dosya oluşturun. Tam olarak "CLAUDE.md" olarak adlandırın — büyük harfler, boşluksuz.
Herhangi bir metin düzenleyicide açın — Not Defteri, TextEdit, VS Code, hangisini kullanıyorsanız. Talimatlarınızı doğrudan bu dosyaya düz metin olarak yapıştırın.
Sizi en çok zorlayan sorunları çözecek 3 veya 4 talimatla başlayın. Dosyayı kaydedin. Claude, o klasörde her oturum açtığınızda onu otomatik olarak okur.
Kurulum yok. Ekstra adım yok. İlk mesajdan itibaren çalışır. 💡
⚡ BÖLÜM 1: Claude Sizinle Nasıl Konuşur
- Gereksiz dolguyu sonsuza dek öldürün. 🚫
Claude'un varsayılanı, her yanıtı "Harika soru!", "Elbette!", "Kesinlikle!", "Tabii ki!" gibi ifadelerle açmaktır.
Kesinlikle hiçbir şey katmayan ve her gün zamanınızı boşa harcayan ifadeler.
Tek bir talimat bunu kalıcı olarak ortadan kaldırır. Her yanıt doğrudan cevapla başlar. Isınma yok. Yardımseverlik gösterisi yok. Sadece istediğiniz şey — hemen.
"Yanıtlara asla 'Harika soru!', 'Elbette!', 'Kesinlikle!' veya benzeri ısınma ifadeleriyle başlama. Her yanıta gerçek cevapla başla. Önsöz yok. Sadece bilgi."
- Harekete geçmeden önce her zaman seçenekleri göster. 🎯
Claude varsayılan olarak tek bir yaklaşım seçer ve onunla devam eder.
Bir paragrafı yeniden yazmasını istersiniz ve tüm metnin tonunu değiştirir. Bir belgeyi yeniden yapılandırmasını istersiniz ve her şeyi sizin düşünme şeklinizle hiç eşleşmeyen bir şekilde yeniden düzenler.
Şimdi, değiştirmesini istemediğiniz bir şeyi düzeltiyorsunuz. 😤
Bu talimat bunu tamamen düzeltir. Önemli bir görevden önce, Claude size işe yaklaşabileceği 2-3 yol gösterir. Yönü siz seçersiniz. Sonrasında gelen, tam olarak istediğiniz şeydir.
"Herhangi bir önemli görevden önce, bana her zaman önce 2-3 olası yaklaşım göster. Devam etmeden önce benim seçimimi bekle."
- Bilmediğinde dürüst ol. 🔍
Claude, belirsizliği asla kabul etmeden önce size kendinden emin, ayrıntılı, tamamen yanlış bir cevap verecektir.
Boşlukları makul görünen bilgilerle doldurur — tarihler, istatistikler, alıntılar, gerçekler — doğru gibi görünen ama aslında olmayan. Bu bilgiyi kullanırsınız ve sorun daha sonra en önemli anda ortaya çıkar.
Bu talimat bu davranışı kalıcı olarak değiştirir.
"Herhangi bir gerçek, istatistik, tarih veya alıntı hakkında emin değilsen — dahil etmeden önce bunu açıkça belirt. 'Bundan emin değilim' her zaman bir tahmini gerçek olarak sunmaktan iyidir. Boşlukları asla makul görünen bilgilerle doldurma."
- Uzunluğu gerçekten ihtiyaç duyulana göre ayarla. 📏
Claude'a basit bir soru sorun, dört paragraf yazar. Karmaşık bir şey sorun, size eksiksiz görünen ama olmayan bir iskelet verir.
İkisi de kullanışlı değil. Yanıt uzunluğu, görevin gerçekten gerektirdiğiyle eşleşmelidir.
"Yanıt uzunluğunu görev karmaşıklığına göre ayarla. Basit sorular kısa, doğrudan cevaplar alır. Karmaşık görevler tam, ayrıntılı yanıtlar alır. Yanıtları asla az önce söylediğin şeyi tekrarlayan yeniden ifadeler veya kapanış cümleleriyle doldurma."
⚡ BÖLÜM 2: Claude Nasıl Davranır
- Büyük değişiklikler yapmadan önce sor. ✋
Claude'dan bir paragrafı düzeltmesini istersiniz ve tüm belgeyi yeniden yazar. Bir şeyi kısaltmasını istersiniz ve aslında ihtiyacınız olan bölümleri kaldırır.
Her seferinde — kaybetmek istemediğiniz bir şeyi kaybedersiniz.
"Daha önce oluşturduğum içeriği önemli ölçüde değiştirecek herhangi bir değişiklik yapmadan önce — tamamen dur. Tam olarak neyi değiştireceğini ve nedenini açıkla. Devam etmeden önce onayımı bekle. 'Bunun daha iyi olacağını düşünüyorum' onu değiştirmek için izin değildir."
- İstenene odaklan.
Claude'dan bir şeyi düzeltmesini isteyin, o da oradayken beş başka şeyi "iyileştirecektir" — ifadelerinizi ayarlar, yapınızı yeniden düzenler, tamamen memnun olduğunuz cümleleri yeniden ifade eder.
Şimdi, gerçekte neyin değiştiğini bulmak için her şeyi gözden geçirmek zorundasınız.
"Sadece senden özellikle değiştirmeni istediğim şeyi değiştir. Sormadığım hiçbir şeyi yeniden yazma, yeniden ifade etme veya 'iyileştirme' — daha iyi olacağını düşünsen bile. Başka bir yerde iyileştirmeye değer bir şey fark edersen, sonunda bundan bahset. Açıkça sormadıkça ona dokunma."
- Bana her zaman neyi değiştirdiğini söyle. 📋
Claude bir görevi tamamlar ve siz çıktıyı tarayarak daha önce sahip olduğunuzdan neyin farklı olduğunu anlamaya çalışırsınız.
Hangi bölümler değişti? Bir şey kesti mi? Hiç istemediğiniz bir şey ekledi mi?
"Herhangi bir düzenleme veya yazma görevini tamamladıktan sonra, her zaman kısa bir özetle bitir: Ne değiştirildi. Neye dokunulmadı. Dikkatimi gerektiren şeyler. Kısa tut — bu bir durum güncellemesi, tekrar değil."
- Benim adıma asla sormadan işlem yapma.
AI araçları e-postanıza, takviminize, sosyal medya hesaplarınıza, belgelerinize daha fazla bağlandıkça — Claude'un tam olarak istemediğiniz bir eylemi gerçekleştirme riski her yeni entegrasyonla artar.
Bir mesaj göndermek. İçerik yayınlamak. Bir şey planlamak. Bu eylemlerin gerçek sonuçları vardır ve hızlı gerçekleşir.
"Benim adıma asla geçerli mesajda açık onayım olmadan hiçbir şey gönderme, yayınlama, paylaşma veya planlama. 'Bunu yapmak istediğinden bahsetmiştin' onay değildir. Geçerli mesajda evet demeliyim."
⚡ BÖLÜM 3: Sizin Bağlamınız
- Claude'a kim olduğunuzu ve ne bildiğinizi söyleyin.
Claude, bir uzman mı yoksa yeni başlayan biri mi olduğunuzu, bir kurucu mu yoksa serbest çalışan mı olduğunuzu, teknik derinlik mi yoksa sade dil mi isteyen biri olduğunuzu bilmez.
Bu bağlam olmadan — tahmin eder. Ve tahmin ettiği kadar yanılır.
"Benim hakkımda: İsim. Rol. Geçmiş. [İyi bildiğiniz konular] konusunda güçlü. [Daha fazla bağlama ihtiyaç duyduğunuz alanlar] konusunda hala öğreniyorum. Her yanıtın derinliğini bu geçmişe göre ayarla. Zaten bildiğim şeyleri asla fazla açıklama."
- Claude'a üzerinde çalıştığınız şeyin bağlamını verin.
Her oturumda Claude, ne üzerinde çalıştığınız, kimin için olduğu veya gerçekte neyin önemli olduğu hakkında hiçbir fikri olmadan başlar.
Size genel çıktı verir çünkü başka seçeneği yoktur.
"Üzerinde çalıştığım şey: Proje. Hedef. Kitle. Ton. Kaçınılması gerekenler. Bu bağlamı her göreve uygula. Bir şey bu resme uymadığında — devam etmeden önce bunu işaretle."
- Sesinizi ve stilinizi kilitleyin.
Claude'un varsayılan bir yazma stili vardır. Fena değildir. Ama sizinki de değildir.
Claude'u bir şey yazmak için her kullandığınızda — yine de onu kendi sesinize geri döndürmek için düzenlersiniz.
Sesinizi bir kez tanımlayın ve Claude ilk taslaktan itibaren onunla yazsın.
"Yazma stilim — bunu her zaman eşleştir: Ses. Cümle uzunluğu. Kullandığım kelimeler. Asla kullanmadığım kelimeler. Biçim tercihi. Benim adıma bir şey yazarken, bu stili tam olarak eşleştir. Kendi kalıplarına varsayılan olarak geçme."
⚡ BÖLÜM 4: Hafıza ve Süreklilik
- Claude'a bir hafıza dosyası tutmasını söyleyin.
Claude, oturumlar arasında her şeyi unutur. Her konuşma tamamen taze başlar.
Ancak Claude dosya yazabilir — ve dosyalar kalıcıdır.
Bu talimat, Claude'a birlikte verdiğiniz her önemli kararla birlikte bir MEMORY.md dosyası tutmasını söyler — neye karar verildi, neden ve hangi alternatiflerin reddedildiği.
"MEMORY.md adlı bir dosya tut. Herhangi bir önemli karardan sonra — neye karar verildiğini, nedenini ve neyin reddedildiğini belirten bir giriş ekle. Her oturumun başında, hiçbir şey yapmadan önce MEMORY.md'yi oku."
- Oturum sonu özeti — asla ilerleme kaybetmeyin.
Oturumu kapatırsınız. İki gün sonra geri gelirsiniz. Nerede kaldığınızı ve neyi bitirdiğinizi hatırlamak için eski mesajları okumak için 15 dakika harcarsınız.
Bu, Claude'u düzenli kullanan hemen hemen herkesin başına gelen tamamen önlenebilir bir zaman kaybıdır.
"'oturum sonu' veya 'burada duralım' dediğimde — MEMORY.md'ye bir oturum özeti yaz: Üzerinde ne çalıştık. Ne tamamlandı. Ne devam ediyor. Hangi kararlar alındı. Bir sonraki oturumda nereden devam edilecek."
- İşe yaramayanı kaydedin — aynı sorunu iki kez çözmeyi bırakın.
Bir prompt yaklaşımı denersiniz. Kullanılabilir bir şey elde etmek dört deneme alır. Üç hafta sonra benzer bir görevle geri dönersiniz ve Claude aynı kötü önerilerle sıfırdan başlar.
Aynı deneme yanılma. Aynı boşa harcanan zaman. En baştan. Her seferinde.
"ERRORS.md adlı bir dosya tut. Bir yaklaşımın çalışması 2'den fazla deneme aldığında — neyin işe yaramadığını, neyin işe yaradığını ve bir dahaki sefere neyin hatırlanması gerektiğini kaydet. Benzer görevlere yaklaşımlar önermeden önce ERRORS.md'yi kontrol et."
- Claude'a asla değişmeyen gerçeklerin bir listesini verin. 📌
Her projenin kalıcı gerçekleri vardır — geçmiş kararlardan gelen kısıtlamalar, önemli nedenlerle var olan kurallar, belirli görevden bağımsız olarak işiniz hakkında her zaman doğru olan şeyler.
Bu olmadan — Claude, gerçekliğinizle tamamen çelişen şeyler rahatça önerir.
"Bu gerçekler her zaman doğrudur. Bunları istisnasız her oturuma uygula: [Kalıcı gerçekleriniz burada]. Herhangi bir görev bunlardan biriyle çelişiyorsa — devam etmeden önce bunu işaretle."
⚡ BÖLÜM 5: Geliştiriciler İçin
- Kapsam içinde kalın — istenmeyen hiçbir şeye dokunmayın.
Claude'dan bir hatayı düzeltmesini isteyin, o da üç dosyayı yeniden düzenler, değişkenlerinizi yeniden adlandırır, import'larınızı yeniden organize eder ve aylardır kullandığınız kodu "iyileştirir" — tüm bunları sormadan.
Bu değişikliklerden bazıları bir şeyleri bozar. Bazıları günlerce süren ince farklılıklar ortaya çıkarır.
"Sadece mevcut görevle doğrudan ilgili dosyaları, fonksiyonları ve kod satırlarını değiştir. Açıkça değiştirmemi istemediğim hiçbir şeyi yeniden düzenleme, yeniden adlandırma veya 'iyileştirme'. Başka bir yerde düzeltilmeye değer bir şey fark edersen — bundan bahset. Ama ona dokunma. Asla."
- Yıkıcı herhangi bir şeyden önce onay isteyin.
Claude Code, dosyaları siler, fonksiyonların üzerine yazar ve veritabanı tablolarını tereddüt etmeden düşürür — çünkü siz ona söylediniz, ona tam olarak ne söylediğinizi tam olarak fark etmeseniz bile.
Yanlış okunan bir talimat ve saatlerce süren çalışma, geri alınamayacak şekilde tamamen kaybolur.
"Herhangi bir dosyayı silmeden, mevcut kodu üzerine yazmadan, veritabanı kayıtlarını düşürmeden veya kolayca geri alınamayacak herhangi bir değişiklik yapmadan önce — tamamen dur. Tam olarak neyin etkileneceğini listele. Açık onay iste. Sadece geçerli mesajda evet dedikten sonra devam et."
- Sert duruşlar — izinsiz asla gerçekleşmeyen eylemler. 🚨
Prodüksiyona dağıtmak. Canlı bir veritabanında migration çalıştırmak. Harici hizmetlere API çağrıları göndermek.
Bunlar "dikkatli ol" durumları değil. Bunlar tam duruşlardır.
"Aşağıdaki eylemler, yürütülmeden önce oturum içinde açık onay gerektirir — istisnasız: Herhangi bir ortama dağıtmak. Herhangi bir veritabanında migration çalıştırmak. Herhangi bir e-posta veya harici API çağrısı göndermek. Geri döndürülemez harici yan etkileri olan herhangi bir komutu yürütmek."
- Teknoloji yığınınızı kilitleyin. 🔧
Tanımlanmış bir yığın olmadan — Claude, hangi framework'ü en popüler buluyorsa, hangi kütüphaneyi en sık gördüyse ve hangi paket yöneticisine varsayılan olarak geçiyorsa onu önerecektir.
Genellikle sizin kullandığınız, ekibinizin bildiği ve halihazırda inşa ettiğinizle uyumlu olan değil.
"Teknoloji yığını — bunları her zaman kullan, sormadıkça asla alternatif önerme: Dil. Framework. Paket yöneticisi. Veritabanı. Test. Linting. Bir şey yanlış araç gibi görünüyorsa — bunu işaretle. Ama yine de kullan, ben aksini söylemedikçe."
- Tam olarak neyin değiştiğini her zaman göster.
Claude bir kodlama görevini tamamlar ve siz çıktıyı tarayarak neyin farklı olduğunu anlamaya çalışırsınız.
Hangi dosyalar değişti? Başka bir şeye dokundu mu? Bitmemiş bir şey bıraktı mı?
"Herhangi bir kodlama görevini tamamladıktan sonra, her zaman şununla bitir: Değiştirilen dosyalar. Ne değiştirildi — dosya başına bir satır. Bilerek dokunulmayan dosyalar. Gerekli takip. Kısa tut — bu bir durum güncellemesi, tekrar değil."
- Andrej Karpathy'nin CLAUDE.md'sini viral yapan 4 kural.
Andrej Karpathy — Tesla'nın eski AI Direktörü, OpenAI'in kurucu üyesi — Claude Code'un kodlama görevlerinde başarısız olmasına neden olan 4 spesifik davranış belirledi.
Bir geliştirici bunları 4 talimata indirgedi. Bu dosya GitHub Trending'de 1 numara oldu ve kodlama doğruluğunu %65'ten %94'e çıkardı.
İşte onlar:
- Sor, varsayma — bir şey net değilse, tek bir satır kod yazmadan önce sor. Asla sessiz varsayımlarda bulunma.
- Önce en basit çözüm — işe yarayabilecek en basit şeyi her zaman uygula. İstenmeyen soyutlamalar ekleme.
- İlgisiz koda dokunma — bir dosya mevcut görevin doğrudan bir parçası değilse, onu değiştirme. Asla.
- Belirsizliği açıkça işaretle — bir yaklaşım hakkında emin değilsen, devam etmeden önce söyle. Kesinlik olmadan güven, bir boşluğu kabul etmekten daha fazla hasara neden olur.
Alt satır.
CLAUDE.md sadece bir geliştirici aracı değildir.
Claude'u ciddi şekilde kullanan herkesin ilk gerçek oturumundan önce kurması gereken kalıcı bir talimat dosyasıdır.
Talimat 1-4, Claude'un nasıl iletişim kurduğunu düzeltir. Talimat 5-8, yetkilendirmediğiniz şeyleri değiştirmesini durdurur. Talimat 9-11, gerçek işinize uygun çıktı üretmesi için bağlam verir. Talimat 12-15, şu anda var olan gerçek hafızaya en yakın şeyi verir. Talimat 16-21, Claude Code'un öngörülemez bir araç yerine hassas bir araç gibi davranmasını sağlar.
Dosyayı oluşturun. 3 talimat yapıştırın. Devam ettikçe daha fazlasını ekleyin.
Çıktı kalitesindeki fark, ilk oturumdan itibaren anında ve belirgin olacaktır. 🚀
AI ile nasıl çalıştığınızı gerçekten değiştiren daha fazla sistem için takip edin. 💯


