Claude Code kullanırken bu sorunları yaşıyor musunuz?
・Claude Code oturumu uzadıkça, cevapların kalitesi bir şekilde düşüyor.
・Komutlar neler? Farklarını pek anlamıyorum.
・Alt ajanları ne zaman kullanacağıma karar veremiyorum.
・Bağlam tam bir karmaşa.
Şu anda, Anthropic çalışanı Thariq'in (@trq212) "Claude Code oturum yönetimi ve 1 milyon token bağlamı" hakkındaki bir gönderisi 540.000 görüntülenmeyle viral oldu 😳
Bu sorunları yaşayan herkes için, içeriği madde madde ve anlaşılır bir şekilde açıklıyorum 👇
Orijinal gönderi burada: https://x.com/trq212/status/2044548257058328723?s=20
■ 𝗯𝗮ğ𝗹𝗮𝗺 𝗽𝗲𝗻𝗰𝗲𝗿𝗲𝘀𝗶𝗻𝗶𝗻 𝘁𝗲𝗺𝗲𝗹𝗹𝗲𝗿𝗶
Öncelikle, bir ön koşul olarak, Claude Code bağlam penceresi 1 milyon token'dır.
Bağlam, aşağıdakilerin tümünü içerir:
・Sistem istemi
・Geçmiş konuşma geçmişi
・Tüm araç çağrıları ve çıktıları
・Yüklenen dosyaların içerikleri
Başka bir deyişle, oturum ne kadar uzun sürerse, bu bağlamda o kadar fazla bilgi birikir.
■ 𝗯𝗮ğ𝗹𝗮𝗺 𝗯𝗼𝘇𝘂𝗹𝗺𝗮𝘀ı (𝗰𝗼𝗻𝘁𝗲𝘅𝘁 𝗿𝗼𝘁) 𝗻𝗲𝗱𝗶𝗿?
Burada önemli bir kavram "bağlam bozulması"dır (context rot).
Bağlam büyüdükçe, modelin dikkati birçok token'a dağılır ve eski veya alakasız bilgiler gürültü haline gelerek mevcut görevi engellemeye başlar.
Thariq'e göre, 1 milyon token'lık modelde bağlam bozulması yaklaşık 300.000 ila 400.000 token civarında gözlemlenmeye başlıyor. Ancak bu, göreve büyük ölçüde bağlı olduğu için katı bir kural değil.
Bağlam penceresinin kesin bir sınırı olduğundan, sınıra yaklaştığınızda önceki çalışmayı özetlemeniz ve yeni bir bağlamda devam etmeniz gerekir. Bu sürece "sıkıştırma" (compaction) denir.
■ Her adım bir "𝗗ö𝗻ü𝗺 𝗡𝗼𝗸𝘁𝗮𝘀ı"dır
Claude Code bir görevi tamamladıktan sonra ne yapmalı? Aslında en önemli karar anı budur.
Thariq beş seçenek sıralıyor:
𝟭. 𝗗𝗲𝘃𝗮𝗺 𝗘𝘁 (𝗖𝗼𝗻𝘁𝗶𝗻𝘂𝗲)
Aynı oturumda bir sonraki mesajı gönderin. En doğal seçenek.
𝟮. /𝗴𝗲𝗿𝗶 𝘀𝗮𝗿 (𝗿𝗲𝘄𝗶𝗻𝗱) (Çift Esc Esc tuşuna basın)
Geçmişteki bir mesaja dönün ve oradan yeniden başlayın. Sonraki mesajlar bağlamdan silinir.
𝟯. /𝘁𝗲𝗺𝗶𝘇𝗹𝗲 (𝗰𝗹𝗲𝗮𝗿) (Yeni Oturum)
Önemli bilgileri kendiniz özetleyin ve yeni bir oturum başlatın.
𝟰. /𝘀𝗶𝗸ış𝘁ı𝗿 (𝗰𝗼𝗺𝗽𝗮𝗰𝘁)
Modelin şu ana kadarki konuşmayı özetlemesini sağlayın ve bu özetin üzerine devam edin.
𝟱. 𝗔𝗹𝘁 𝗔𝗷𝗮𝗻𝗹𝗮𝗿 (𝗦𝘂𝗯𝗮𝗴𝗲𝗻𝘁𝘀)
Bir sonraki iş parçasını, kendi temiz bağlamına sahip bir ajana devredin ve yalnızca sonucu ana oturuma döndürün.
■ Yeni bir oturuma ne zaman başlamalı
1 milyon token'lık bağlam penceresi sayesinde, sıfırdan tam yığın bir uygulama oluşturmak gibi uzun görevler artık daha kararlı bir şekilde yürütülebiliyor.
Ancak, bağlamda yer kaldı diye aynı oturuma devam etmeniz gerektiği anlamına gelmez.
Thariq'in kuralı basit:
🔥 "Yeni bir göreve başlıyorsanız, yeni bir oturum başlatmalısınız."
İstisnalar vardır. Örneğin, bir özelliği uyguladıktan hemen sonra dokümantasyon yazmak. Yeni bir oturum başlatırsanız, Claude Code az önce uyguladığı dosyaları yeniden okumak zorunda kalır, bu da yavaş ve maliyetlidir. "Yüksek zeka" gerektirmeyen dokümantasyon gibi görevler için, bir miktar bağlam kirliliğini kabul edip devam etmek daha verimlidir.
■ 𝗴𝗲𝗿𝗶 𝘀𝗮𝗿𝗺𝗮 (𝗿𝗲𝘄𝗶𝗻𝗱) 𝗲𝗻 𝗮𝘇 𝗱𝗲ğ𝗲𝗿 𝘃𝗲𝗿𝗶𝗹𝗲𝗻 ö𝘇𝗲𝗹𝗹𝗶𝗸𝘁𝗶𝗿
Thariq, iyi bağlam yönetimi için en iyi alışkanlık olarak "geri sarmayı" (rewind) gösteriyor.
Claude Code'da, Esc tuşuna çift tıklayarak (veya /rewind komutunu kullanarak) geçmişteki herhangi bir mesaja dönebilir ve oradan yeniden başlayabilirsiniz. Bu noktadan sonraki mesajlar bağlamdan tamamen kaldırılır.
Belirli bir senaryo düşünelim:
Claude beş dosyayı okudu ve başarısız olan bir yaklaşımı denedi.
❌ Normal tepki: "Bu işe yaramadı. Bunun yerine X'i dene."
→ Başarısız yaklaşımın tüm günlüğü bağlamda kalır.
✅ Daha iyi yol: Dosyaların okunduğu ana geri sarın ve öğrendiklerinizle yeniden yönlendirin.
→ "A yaklaşımını kullanma. Foo modülü bunu sunmuyor. Doğrudan B'ye git."
Bunu yaparak, başarısız deneme yanılma token'ları kaybolur ve temiz bir durumda yeniden deneme yapılabilir.
Ayrıca, "buradan itibaren özetle" özelliğini kullanarak Claude'un kendi öğrendiklerini özetlemesini ve "geçmiş benliğin gelecekteki benliğe notu" oluşturmasını sağlayabilirsiniz.
■ /𝘀𝗶𝗸ış𝘁ı𝗿 (𝗰𝗼𝗺𝗽𝗮𝗰𝘁) 𝘃𝗲 /𝘁𝗲𝗺𝗶𝘇𝗹𝗲 (𝗰𝗹𝗲𝗮𝗿) 𝗮𝗿𝗮𝘀ı𝗻𝗱𝗮𝗸𝗶 𝗸𝗿𝗶𝘁𝗶𝗸 𝗳𝗮𝗿𝗸
Bir oturum uzadığında, yükü azaltmanın iki yolu vardır. Benzer görünürler ancak tamamen farklıdırlar.
【/sıkıştır (compact)】
・Model konuşmayı özetler ve geçmişi bu özetle değiştirir.
・Kayıplıdır — önemli olan Claude'un yargısına bırakılır.
・Hiçbir şey yazmanız gerekmez, ancak Claude bir şeyi kaçırabilir.
・Yönlendirmek için talimatlar verebilirsiniz (ör. /compact auth yeniden düzenlemesine odaklan, test hata ayıklamayı kaldır).
【/temizle (clear)】
・Önemli bilgileri kendiniz yazarsınız ve yeni bir oturum başlatırsınız.
・Şöyle: "Hedef auth middleware, kısıtlamalar X, ilgili dosyalar A ve B, Y yaklaşımı hariç."
・Çaba gerektirir, ancak ortaya çıkan bağlam yalnızca sizin seçtiğiniz bilgilerden oluşur.
Bunlar arasında seçim yapmak, kontrol ve kolaylık arasında bir takastır.
■ 𝗦𝗶𝗸ış𝘁ı𝗿𝗺𝗮 (𝗰𝗼𝗺𝗽𝗮𝗰𝘁) 𝗻𝗲𝗱𝗲𝗻 𝗯𝗮ş𝗮𝗿ı𝘀ı𝘇 𝗼𝗹𝘂𝗿
Uzun oturumlar kullanıldığında, sıkıştırmanın kalitesi son derece düşük olabilir.
Thariq'e göre, kötü bir sıkıştırmanın en büyük nedeni, "modelin çalışmanın yönünü tahmin edememesidir."
Örnek:
Uzun bir hata ayıklama oturumundan sonra, otomatik sıkıştırma tetiklenir ve araştırmayı özetler.
→ Ardından "bar.ts'deki şu uyarıyı da düzelt" derseniz, bu uyarıyla ilgili bilgi, hata ayıklamaya odaklı özetten düşmüş olabilir.
Daha da sorunlu olanı, bağlam bozulması nedeniyle modelin sıkıştırmayı gerçekleştirirken "en düşük zeka durumunda" olması ikilemidir. Başka bir deyişle, en doğru özetin gerektiği anda en düşük kaliteli özet üretilir.
Artık 1 milyon token'lık bir bağlamımız olduğuna göre, en iyi strateji, henüz yeriniz varken /sıkıştır komutunu kendiniz çalıştırmak ve bir sonraki adımda ne yapılacağına dair bir açıklama eklemektir.
■ 𝗔𝗹𝘁 𝗔𝗷𝗮𝗻𝗹𝗮𝗿 (𝗦𝘂𝗯𝗮𝗴𝗲𝗻𝘁𝘀) 𝗻𝗲 𝘇𝗮𝗺𝗮𝗻 𝗸𝘂𝗹𝗹𝗮𝗻ı𝗹𝗺𝗮𝗹ı
Alt ajanlar da bir bağlam yönetimi biçimidir.
Claude Code, Ajan aracıyla bir alt ajan oluşturduğunda, bu alt ajanın kendi temiz bağlam penceresi vardır. Gerektiği kadar iş yapar, sonucu özetler ve ana oturuma döndürür.
Kriter basittir:
👀 "Bu araç çıktısına daha sonra tekrar ihtiyacım olacak mı? Yoksa sadece sonuç yeterli mi?"
Sadece sonuç yeterliyse, bir alt ajana bırakmalısınız.
Claude Code alt ajanları otomatik olarak çağırır, ancak açık talimatlar vermek de etkilidir:
・"Bir alt ajan başlat ve bu spesifikasyon dosyasına göre çalışma sonuçlarını doğrula."
・"Başka bir kod tabanında auth akışının nasıl uygulandığını okumak ve özetlemek için bir alt ajan kullan. Bunu referans alarak burada uygula."
・"Git diff'ten bu özellik için dokümantasyon yazmak üzere bir alt ajan kullan."
Ara çıktıyı ana bağlama getirmeyerek bağlamı temiz tutarsınız.
■ Özet: 5 Bağlam Yönetimi Tekniği
Claude bir adımı tamamladıktan sonra bir sonraki mesajı göndermeden önce her zaman karar vermeniz gerekenler:
- Görev değişti mi? → Yeni bir oturum için /temizle
- Yaklaşım başarısız oldu mu? → Dosya yüklemesinden hemen sonrasına dönmek için /geri sar
- Oturum uzuyor mu? → Yeriniz varken (yön vererek) /sıkıştır
- Çok fazla ara çıktı içeren bir görev mi? → Bir alt ajana devret
- Bağlam ilgili görevler için kullanılabilir mi? → Olduğu gibi devam et
Gelecekte, Claude bu kararlarda yardımcı olacak, ancak şimdilik bu yargıları yapan kullanıcılar Claude Code'un çıktı kalitesini önemli ölçüde artırabilir.
Oturum yönetimi incelikli bir iştir, ancak Claude Code deneyimini temelden değiştiren bir beceridir 🔥
Bu makaleyi faydalı bulanlar için:
𝗖𝗹𝗮𝘂𝗱𝗲 𝗖𝗼𝗱𝗲 𝗦𝘁𝘂𝗱𝗶𝗼 @ 𝗝𝗮𝗽𝗮𝗻 (@ClaudeCode_love), üç Claude Code meraklısı tarafından yönetilen bir hesaptır.
Pratik CLI kullanımı ve otomasyon hakkında günlük olarak paylaşım yapıyoruz.
Şu anda halka açık bir şirketle birlikte bir AI ajanı geliştiriyoruz.
Her zamanki içeriklerimiz 👇
・Claude Code ve Claude kullanarak gerçek ürün geliştirme vakaları
・Claude Code kullanımı / Vibe Coding / geliştirme trendlerini düzenleme
・Yurt dışından Claude Code hakkında en son bilgiler
Geliştirme felsefesinden tasarıma, uygulamaya ve iyileştirmeye kadar, yurt dışı ve birincil kaynakları özetleyerek, yalnızca "yapmayı bitirmek" değil, çalışan ürünler çıkarmanıza yardımcı oluyoruz.
İlgileniyorsanız, takip edin ve bize göz atın! Buna değecek!
