Partnered With:

Claude Code Bağlamının Doğru İşlenişi: Oturumların Uzun Süreli Olmasından ve Modelin Daha da "Saf" Hale Gelmesinden Kaçının

Bu makaleyi okumak için 18 Dakika

Sıkıştırmadan geriye doğru gitmeye ve alt öğe ajanına kadar, Claude Code'un uzun süreli sohbetlerde daima yüksek kaliteli çıktı sağlamasını sağlayan bu teknikleri öğrenin.

Orijinal Başlık: Claude Kodu Kullanımı: Oturum Yönetimi ve 1M Bağlam
Orijinal Yazar: Thariq, Claude Kodu Takım Üyesi
Orijinal Çeviri: Elmas, Yapay Zeka Araştırmacısı

Ritim BlockBeats Notu: Yapay Zeka programlama araçlarının sürekli olarak "pencere genişletme" eğiliminde olduğu bugünlerde, birçok kullanıcı daha büyük bir bağlamın deneyimi doğal olarak iyileştireceğini yanlışlıkla düşünmektedir. Ancak Claude Kodu araştırmacısından gelen bu birinci el hesaplaşma, gerçek kaliteyi belirleyenin asla pencere boyutu kendisi değil, onu nasıl yönettiğiniz olduğunu gösteriyor.

/kullanım dizininden bu güncellemeye, "devam et, geri al, sıkıştır, temizle, alt uzman" gibi bu mikro işlemlerin ayrıntılı incelenmesine kadar, makale genellikle göz ardı edilen bir yetenek olan bağlam yönetim yeteneğini açığa çıkarıyor. Bu hem bir mühendislik sorunu hem de bir bilişsel sorundur: Ne zaman geçmişi saklamalı, ne zaman bilinçli olarak unutmamalı, görevi ne zaman ayırmalı, bir oyunu ne zaman tekrar başlatmalı. Bu seçimler, yapay zekânın "işbirliği" mi yoksa "yük" mü olduğunu doğrudan belirler. Aşağıda orijinal içerik yer almaktadır:

Bugün, /kullanım komutu için tamamen yeni bir güncelleme yayınladık, bu da sizi Claude Kodu'daki kullanımınız hakkında daha net bir şekilde bilgilendirmenize yardımcı olmayı amaçlıyor. Bu kararın arkasındaki şey, yakın zamanda kullanıcılarla yaptığımız birçok derinlemesine görüşmedir.

Bu görüşmelerde, oturumu yönetme alışkanlıklarının oldukça çeşitlendiğini defalarca duyduk. Özellikle son zamanlarda Claude Kodu'nun bağlam penceresini (Context Window) 1 milyon'a yükseltmesiyle, bu fark daha da belirgin hale geldi.

Siz, terminalde sadece bir veya iki oturumu açık tutma alışkanlığına mı sahipsiniz? Yoksa her ipucu girdiğinizde yeni bir oturum mu başlatıyorsunuz? Genellikle sıkıştırma (Compact), geri alma (Rewind) veya alt uzmanlar (Subagents) gibi işlevleri ne zaman kullanıyorsunuz? Ve kötü bir sıkıştırmaya ne sebep oldu?

Bunun aslında derin bir anlamı var. Bu küçük gibi görünen ayrıntılar, Claude Kodu kullanım deneyiminizi büyük ölçüde etkiliyor. Ve tüm bunların merkezinde, bağlam pencerenizi nasıl yönettiğiniz yatıyor.

Hızlı Bilgi: Bağlam, Bağlam Sıkıştırması ve Bağlam Zayıflaması

Denirken, 「Bağlam Penceresi」, modelin bir sonraki yanıtı üretirken aynı anda "görebileceği" tüm bilgileri temsil eder. Bu, sistem yönergelerinizi, şu ana kadar olan sohbet geçmişinizi, her aracın çağrısını ve çıktılarını hatta okuduğu her bir dosyayı içerir. Şu anda, Claude Code'un 1 milyon kelime parçasına kadar olan dev bir bağlam penceresi vardır.

Ancak, bağlam kullanmanın bir maliyeti vardır, genellikle buna bağlam bozulması diyoruz. Bağlam uzadıkça, modelin performansı genellikle kötüleşir çünkü dikkati daha fazla parçaya dağılmıştır. Eski ve artık ilgisiz olan içerikler, modelin şu anda yürütmekte olduğu görevi engellemeye başlar.

Bağlam penceresinin sert bir kapasite sınırı vardır. Dolayısıyla, pencereyi doldurmak üzere olduğunuzda, yaptığınız işi kısa bir açıklamaya özetlemeli ve bu açıklamayı alarak yeni bir bağlam penceresinde çalışmaya devam etmelisiniz.

Buna bağlam sıkıştırma adını veriyoruz. Tabii ki, bu sıkıştırma sürecini istediğiniz zaman manuel olarak da tetikleyebilirsiniz.

Düşünün, Claude'un size bir şey yapmasını istediniz ve o işi zaten tamamladı. Şimdi, bağlamınızda bazı bilgiler birikmiş olabilir (örneğin araç çağrısı, aracın çıktı sonuçları, verdiğiniz talimatlar).

Sonraki adım ne olmalı? Kendinizi bu kadar çok seçeneğiniz olduğuna şaşırtabilirsiniz:

· Devam Et (Continue)—Aynı oturumda doğrudan bir sonraki iletiyi gönderme

· Geri Al (/rewind veya Esc tuşuna iki kez basma) —Zamanı geri sarma, önceki bir iletiye geri dönüp oradan yeniden deneme yapma

· Temizle (Clear)—Yeni bir oturum açar, genellikle önceki sohbetten çıkarılan kısa bir özetle gelir

· Kısalt (Compact)—Mevcut sohbeti özetleyip, bu özet üzerinden devam etme

· Alt Ajanlar (Subagents)—Bir sonraki aşamayı kendi temiz bağlamına sahip başka bir AI ajanına (AI Agent) devret ve sadece nihai çalışma sonucunu geri al

Doğrudan "Devam Et" en doğal tepki gibi görünse de, diğer dört seçeneğin ayarlanması, bağlamınızı daha iyi yönetmenize yardımcı olmak içindir.

Yeni Bir Oturum Açmalı mı?

Uzun soluklu eski bir oturumu sürdürmek mi yoksa yeni bir başlangıç yapmak mı gerektiğini ne zaman belirlemelisiniz? Deneyimimizden gelen kural şudur: Yeni bir görev başlattığınızda, yeni bir oturum başlatmalısınız.

100.000 birimlik bağlam penceresi, şimdi daha uzun ve karmaşık görevleri son derece güvenilir bir şekilde tamamlayabileceğiniz anlamına gelir. Örneğin, Claude'ün sıfırdan bir tam yığın uygulama oluşturmasını istemek.

Ancak bazen ilişkilendirilmiş görevler yaparsınız. Bu durumda, önceki bağlamın bir kısmını korumanız gerekir, ancak hepsini değil. Örneğin, yeni bir özellik yazdınız ve şimdi onun için bir kullanım kılavuzu yazmanız gerekiyor. Elbette yeni bir oturum başlatabilirsiniz, ancak bu durumda Claude, yazdığınız tüm kod dosyalarını yeniden okumak zorunda kalacaktır—bu sadece daha yavaş değil, aynı zamanda daha maliyetlidir.

“Düzeltme” Yerine “Geri Al” Kullanın

Eğer “Mükemmel Bağlam Yönetimi Yeteneğini” temsil eden iyi bir alışkanlık seçmemi isteselerdi, kesinlikle “Geri Al (Rewind)”'ı iyi kullanma derdim.

Claude Kodu'nda, Çift Dokunuşla Esc Tuşuna (veya /rewind komutunu çalıştırarak) herhangi bir önceki iletiye geri dönebilir ve oradan ipucunu yeniden iletebilirsiniz. O noktadan sonraki tüm konuşmalar, bağlamdan tamamen silinecektir.

Yapay Zekâ'nın hatasını düzeltirken, "geriye gitme" genellikle daha akıllıca bir yaklaşımdır. Örneğin: Claude beş dosya okudu, bir yöntem denedi ve başarısız oldu. Doğal tepkiniz muhtemelen ileti kutusuna şunu yazmaktır: "Bu yöntem işe yaramadı, X yöntemini deneyin." Ancak daha akıllıca olanı, o beş dosyayı okuduğu noktaya geri gitmek ve yeni öğrendiğiniz dersle ona şunu tekrar söylemektir: "A yöntemini kullanma, foo modülü bunu desteklemiyor—doğrudan B yöntemini dene."

Claude'un öğrendiklerini özetleyerek bir "devralma mesajı" oluşturmasını sağlayan "buradan özetle (summarize from here)" işlevini bile kullanabilirsiniz. Bu, sanki o yeni tuzaklara düşmüş "gelecek sürüm Claude", geçmişte henüz harekete geçmemiş kendinize bir not bırakmış gibi hissettirir.

İçerik Sıkıştırma vs. Yeni Oturum

Bir oturum giderek uzadığında, ona "hafifletme" yapmanın iki yolu vardır: /compacı kullanma (sıkıştırma) veya /clear (temizleme ve baştan başlama). Bu iki işlem benzer gibi görünse de aslında çok farklı sonuçlar doğurur.

Sıkıştırma (Compact), modelin şimdiye kadar olan konuşmayı özetlemesine ve bu özeti uzun geçmiş kayıtların yerine koymasına olanak tanır. Bu süreç "kayıplı"dır, yani "hangi içeriğin önemli olduğu" kararını Claude'a devretmiş olursunuz.

Çok şey yazmanıza gerek yok ve Claude, size göre önemli deneyimler veya dosya kayıtlarını sakladığında, düşündüğünüzden daha detaylı olabilir. Ayrıca sıkıştırmanın yönünü belirleyerek kontrolü ele alabilirsiniz (örneğin: /compact, kimlik doğrulama modülünün yeniden yapılandırılmasına odaklanarak, test hata ayıklama hakkındaki içeriği atlar).

Bunun yerine /clear kullanmayı seçerseniz, temel noktaları kendi yazmanız gerekir (\"Kimlik doğrulama ara katmanını yeniden yapılandırıyoruz, mevcut kısıtlama şartı X'dir, ilgili önemli dosyalar A ve B'dir ve yöntem Y'yi dışladık\" gibi), ardından son derece temiz bir durumda yeniden başlarsınız. Bu biraz zahmetli olabilir, ancak ortaya çıkan yeni bağlamın tamamı, gerçekten ilgili olduğunu düşündüğünüz özü içerir.

Hangi \"sıkıştırma\" işlerini tersine döndürür?

Eğer uzun süreli oturumlara sıklıkla sahipseniz, muhtemelen \"sıkıştırma\" etkisinin son derece kötü olduğu durumlarla karşılaşmışsınızdır. Gördüğümüz kadarıyla, bu tür bir \"başarısızlık\" genellikle belirli bir anda meydana gelir: Büyük Dil Modeli (LLM) bir sonraki adımınızı tahmin edemez durumdayken.

Örneğin, uzun bir kod hata ayıklama sürecinden sonra, sistem otomatik olarak sıkıştırmayı tetikledi ve önceki sorun giderme adımlarını özetledi. Sonra hemen \"Şimdi, bar.ts dosyasında gördüğümüz diğer bir uyarıyı da düzeltelim.\" dediniz.

Ancak, önceki oturumun tamamı hata ayıklamaya odaklandığı için, düzeltilmemiş uyarının artık önemsiz bilgi olarak ele alınmış olma ihtimali yüksektir ve özetlenirken doğrudan atılmış olabilir.

Bu oldukça sinir bozucu bir sorundur. Çünkü bağlam azalması nedeniyle, model sıkıştırmayı yaparken genellikle \"zeka\" en düşük seviyededir. Neyse ki, artık 1 milyonluk bir bağlam kapasitesine sahip olduğunuza göre, önceden /küçültme komutunu vererek, \"bir sonraki adımda ne yapmak istediğim\" açıklamasını aktif olarak ekleyebilirsiniz.

Alt Akıllı Nokta ve Tamamen Yeni Bağlam Penceresi

Alt akıllı nokta aynı zamanda bağlam yönetimi için harika bir araçtır. Belirli bir görevin çok miktarda \"işte bitti\" (daha sonra kullanılmayacak) ara sonuçları üreteceğini önceden biliyorsanız, bu yöntem çok etkilidir.

Claude, bir alt akıllı nokta türettiğinde, bu küçük arkadaş tamamen yeni bir bağlam penceresi alır. İçinde istediği kadar işlem yapabilir. İşlem tamamlandığında, sonucu özetler ve sadece nihai raporu \"ana\" Claude'a geri verir.

Alt akıllı noktayı kullanıp kullanmamamız gerektiğimizi belirleyen \"temel soru\" şudur: Bu araçların çalışmasının detaylı çıktılarını daha sonra görmeye ihtiyacım var mı, yoksa sadece nihai bir sonuç istiyor muyum?

Claude Code, arka planda alt akıllı ajanı otomatik olarak çağırabilir, ancak bazen onu çok açık bir şekilde yönlendirebilirsiniz. Örneğin, ona şunu söyleyebilirsiniz:

· "Bir alt akıllı ajanı gönder, aşağıdaki spesifikasyon belgesine göre yaptığımız işin doğru olup olmadığını doğrulasın"

· "Bir alt akıllı ajanı gönder, başka bir kod deposunu bir gözden geçirsin, kimlik doğrulama sürecini nasıl gerçekleştirdiğini özetlesin ve sonra sen de aynısını burada uygula"

· "Bir alt akıllı ajanı gönder, benim Git değişiklik kayıtlarıma dayanarak bu yeni özelliğe açıklama belgesi yazsın"

Genel olarak, Claude bir dönüşü tamamladığında ve siz yeni bir ileti göndermeye hazırlanırken, bir karar verme kavşağında durursunuz.

Gelecekte, umarız Claude yeterince akıllı hale gelir ve her şeyle kendisi ilgilenir. Ancak şu anda, bu kararları ustalıkla yönetmek, Claude'ın yüksek kaliteli sonuçlar üretmesine rehberlik etmenin bir zorunlu adımıdır.