Her uzun Claude Code oturumu aynı şekilde biter: saatlerce süren ilerlemenizi kaybeder ve en baştan başlarsınız.
Çözüm daha akıllı bir model değil, Claude Code ekibinin dahili olarak kullandığı ve hakkında hiçbir kılavuz yazmadığı bir sistemdir.
Çoğu geliştiricide bu sistem yok ve varlığından bile haberdar değil.
İşte sistemin tamamı 👇
🧠Detaylara dalmadan önce, AI ve vibe coding hakkında günlük notlarımı Telegram kanalımda paylaşıyorum:https://t.me/zodchixquant
Bağlam mühendisliği aslında ne anlama geliyor
Claude her oturumda binlerce satır okur. Bunun çoğu gürültüdür ve önemli olan %5'lik kısım ikinci saatte kaybolur.
İşte o zaman Claude, hiç yazmadığınız fonksiyonlar icat etmeye ve hiç yapmadığınız hataları düzeltmeye başlar. Çözüm daha büyük bir model değil, oturuma girenleri kontrol etmektir.
Bunlar, Claude Code ekibinin kendi monorepo'larında kullandığı 6 modeldir.
Model 1: Katmanlı CLAUDE.md (Adım 1-3)
Tek bir CLAUDE.md yeterli değildir. Claude Code ekibi, her biri farklı bir amaca yönelik üç katman kullanır.
Adım 1: Proje genelindeki kurallarla Kök CLAUDE.md
Depo köküne bir CLAUDE.md dosyası koyun. 100 satırın altında tutun. Her istemde Claude'un sorduğu dört soruyu yanıtlamalıdır:
1# Proje: [ad]23## Yığın4- Çalışma Zamanı: Node 22, TypeScript 5.55- Çerçeve: Next.js 15, React 196- Veritabanı: Postgres 16, Drizzle ORM7- Test: Vitest, Playwright89## Kurallar10- İçe Aktarmalar: yalnızca `@/` ile mutlak yollar11- Bileşenler: kebab-case dosyalar, PascalCase dışa aktarımlar12- Testler: `[dosya].test.ts` olarak aynı konumda13- Commit'ler: geleneksel commit'ler, ortak yazar altbilgisi yok1415## Dokunma16- `infra/terraform/` (ops tarafından yönetilir)17- `migrations/` (oluşturulur, asla elle düzenlenmez)18- `vendor/` (commit'lenmiş bağımlılıklar)1920## Varsayılanlar21- Bir görevi tamamlanmış saymadan önce `npm test` çalıştır22- Her düzenlemede `tsc --noEmit` ile tip kontrolü yap23- Kaydederken Prettier ile biçimlendir
Adım 2: Modüle özel bağlam için Alt Dizin CLAUDE.md
Kuralların değiştiği herhangi bir klasöre CLAUDE.md ekleyin. Claude, o klasörde çalışırken en yakın CLAUDE.md'yi okur ve kök CLAUDE.md'nin üzerine ekler.
Örnek, src/auth/CLAUDE.md:
1# Auth modülü23Bu modül, oturum yönetimi ve OAuth akışlarının sahibidir.45## Kurallar6- Token'ları asla günlüğe kaydetme, kısaltılmış hallerini bile7- Tüm oturum okumaları `getSession()` üzerinden yapılır, asla ham çerezler değil8- Yeni sağlayıcılar, birleştirilmeden önce güvenlik incelemesi gerektirir910## Önce okunacak dosyalar11- Sözleşme için `session.ts`12- Kayıt modeli için `providers/index.ts`
Adım 3: ~/.claude/CLAUDE.md adresinde Kişisel CLAUDE.md
Bu, genel tercih katmanınızdır. Herhangi bir deponun dışında bulunur, her yerde geçerlidir.
1## Tercihlerim - Çoklu dosya düzenlemelerinde bir şey yapmadan önce ne yapacağını açıkla - İsteğim bir şeyi bozacak gibi görünüyorsa geri çekil - Kalıtım yerine birleştirmeyi tercih et - macOS'ta zsh kullanıyorum
Üç katman birikir: genel tercihler + proje kuralları + modül kuralları. Claude, her istemde bu üçünü de bağlamınıza yeniden yüklemeden okur.
Model 2: Cerrahi dosya referansları (Adım 4-5)
Claude'un hangi dosyaların önemli olduğunu anlamasına izin vermek, bağlamı kullanmanın en yavaş ve en aptalca yoludur.
Adım 4:@dosya otomatik tamamlama referansları
Bir istemde @ yazdığınızda, Claude bulanık bir dosya seçici açar. Dosyaları düz metinle tanımlamak yerine bunu kullanın.
Kötü: "kullanıcı kimlik doğrulama koduna ve oturum yardımcısına bak"
İyi: "şuraya bak:
@src/auth /session.ts ve
@src/auth /providers/google.ts, token yenilemeyi düzelt"
Cerrahi referanslar tam olarak bu dosyaları yükler. Düz metin açıklamaları ise Claude'u aramaya, 4-5 aday dosyayı okumaya ve zamanın yarısında yanlış olanı seçmeye zorlar.
Adım 5: Tüm bir iş akışını kapsamak için /focus
Daha uzun görevler için Claude'un tüm oturumunu belirli klasörlerle sınırlayın:
1/focus src/auth src/api/auth-routes
Artık her arama, grep ve okuma işlemi yalnızca bu iki klasör içinde çalışır.
Odaklanmış görevlerde bağlam kullanımını %60-80 oranında azaltır ve Claude, ihtiyacı olmayan bağlam için "yardımseverce" ilgisiz dosyaları okumayı bırakır.
Sıfırlamak için /focus clear çalıştırın.
Model 3: Sıkıştır-ve-devam-et (Adım 6-8)
Uzun oturumlar bağlam sınırına ulaşır ve çöker. İşin püf noktası uzun oturumlardan kaçınmak değil, onları kontrollü sıkıştırmadan geçirmektir.
Adım 6: Bağlam kullanımını /stats ile izleyin
Periyodik olarak /stats çalıştırın.
Bağlam kullanımı %70'i geçtiğinde tehlike bölgesindesiniz demektir. %85'in üzerine çıktığında Claude, size haber vermeden erken mesajları düşürmeye başlar.
Adım 7: Koruma talimatlarıyla /compact
/compact tek başına konuşmayı özetler. Talimatlarla birlikte Claude'a neleri kelimesi kelimesine koruması gerektiğini söylersiniz:
1/compact şunları koru: mevcut görev planı, auth yeniden düzenlemesiyle ilgili tüm kararlar, adım 3'teki başarısız test çıktısı
Adım 8: Günlere yayılan oturumlar için /resume
Bir görev birden fazla güne yayılıyorsa, her oturumu /compact preserve: ... ile bitirin ve bir sonrakine şununla başlayın:
1claude --resume [oturum-kimliği]
Veya en son oturum için sadece claude --continue. Sıkıştırılmış durum bozulmadan kaldığınız yerden tam olarak devam eder.
Model 4: Önce-planla-okuma (Adım 9-10)
En büyük bağlam sızıntısı, Claude'un dosyaları anlamadan önce düzenlemesidir. Plan modu, önce okumaya, sonra yazmaya zorlar.
Adım 9: Her riskli görevde plan modunu açın
Birden fazla dosyaya dokunan herhangi bir görevden önce plan moduna girmek için Shift+Tab tuşlarına basın.
Plan modunda Claude yalnızca okuyabilir. Ne yapacağını açıklar, dokunmayı planladığı her dosyayı listeler ve önerilen değişiklikleri gösterir. Siz onaylayana kadar hiçbir şey çalışmaz.
Tasarruflar gerçektir: 8 oku, 3 yanlışı düzenle, geri al, yeniden oku, tekrar düzenle yerine bir okuma, bir düzenleme.
Adım 10: Hassas yollar için kancalar aracılığıyla plan modunu kilitleyin
Riskli alanlar için plan modunu zorunlu hale getirin. .claude/settings.json dosyasında:
1{2 "hooks": {3 "PreToolUse": [4 {5 "matcher": "Edit(src/auth/**)|Edit(migrations/**)",6 "hooks": [7 {8 "type": "command",9 "command": "claude-require-plan-mode"10 }11 ]12 }13 ]14 }15}
src/auth/*\ veya migrations/\\* içindeki herhangi bir düzenleme girişimi, bir plan modu gereksinimini tetikler. Claude bunu atlayamaz.
Model 5: Alt ajan bağlam izolasyonu (Adım 11-13)
Alt ajanlar, ana bağlamınızı küçük tutmanın en temiz yoludur. Her alt ajan kendi penceresinde çalışır, böylece üst oturum gürültüyü asla görmez.
Adım 11: Alt ajanları minimum araç yüzeyiyle tasarlayın
Araçları, işin gerektirdiği şeyle sınırlayın.
Bir kod-inceleyicisi Yazma veya Düzenleme gerektirmez.
Bir döküman-güncelleyici Bash gerektirmez. Daha az yüzey, ilgisiz dokümanlar ve araç açıklamalarında daha az bağlam harcanması demektir.
1---2name: kod-inceleyicisi3description: Hatalar ve güvenlik sorunları için kod değişikliklerini incele4tools: Oku, Grep, Glob5model: sonnet6---
Adım 12: Alt ajana yalnızca ihtiyaç duyduğu dosya referanslarını iletin
"Son değişiklikleri incele" demeyin. "Şunları incele: @src/auth/session.ts ve @src/auth/providers/google.ts." deyin.
Alt ajan yalnızca bunları okur, "son"un ne anlama geldiğine dair kendi tahminini değil.
Adım 13: Alt ajanlar için daha ucuz modeller kullanın
Göreve göre ajan başına modeli ayarlayın.
İnceleme ve test görevleri için Sonnet, döküman güncellemeleri ve lint'ler için Haiku, yalnızca derin muhakemenin önemli olduğu mimari veya güvenlik denetimleri için Opus.
Gerekirse genel olarak ayarlayın:
1export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-6"
Daha ucuz alt ajanlar = dolar başına daha fazla alt ajan çağrısı = daha fazla izolasyon = daha küçük ana bağlam.
30 dakikalık bağlam mühendisliği başlangıç seti
10 dakika: yığın, kurallar, dokunulmaması gerekenler listesi ve varsayılanlarla sıkı bir kök CLAUDE.md yazın.
5 dakika: en çok düzenlediğiniz 2-3 modüle alt dizin CLAUDE.md'si ekleyin.
5 dakika: tercihlerinizle birlikte ~/.claude/CLAUDE.md'ye kişisel bir CLAUDE.md koyun.
5 dakika: en sık yaptığınız iş akışı için .claude/skills/ klasöründe bir beceri oluşturun.
5 dakika: Shift+Tab kas hafızasını bağlayın ve her çoklu dosya görevine plan modunda başlayın.
İşte bu kadar!
Bir sonraki oturumunuz, aynı miktarda iş için %50-70 daha az bağlam kullanacak. 5. oturumda bu modeller refleks haline gelir ve sınıra asla takılmazsınız.
Bağlam, Claude'un sizin için yönettiği bir şey değildir. Sizin mühendisliğini yaptığınız bir şeydir.
Artık sisteme sahipsiniz.
Okuduğunuz için teşekkürler!
AI, finans ve vibe coding hakkında günlük notlarımı Telegram kanalımda paylaşıyorum: https://t.me/zodchixquant
