Bağlam Yönetimi

50 turlu oturumunuz aniden anlamsız çıktılar üretmeye başlıyor. Claude bozulmadı — bağlam penceresi sınırına ulaştı ve yeni mesajlara yer açmak için eski mesajları sıkıştırmaya başladı. Kalıcı olduğunu düşündüğünüz bağlam, birkaç cümleye özetlendi.

Opus 4.6 ve Sonnet 4.6, 1M token’lık bağlam penceresine sahiptir. Bu devasa görünüyor — ta ki sistem isteminizin, CLAUDE.md dosyalarınızın, MCP araç tanımlarınızın, konuşma geçmişinizin ve genişletilmiş düşünmenin aynı pencere için yarıştığını fark edene kadar. Bağlam yönetimi, neyin kalacağına, neyin sıkıştırılacağına ve her turda ne kadar ödeyeceğinize karar vermekle ilgilidir.

Efor Seviyeleri

--effort bayrağı, Claude’un yanıt vermeden önce ne kadar derinlemesine düşüneceğini kontrol eder. Düşük efor, daha az düşünme token’ı ve daha hızlı yanıtlar anlamına gelir, ancak karmaşık görevler için daha az kapsamlı analiz yapılır.

Her efor seviyesinin gerçekte ne yaptığı:

Çoğu iş için eforu high (varsayılan) olarak bırakın. Hızlı aramalar için low’a düşürün. İnce bir hatayı ayıklarken ve Claude’un daha fazla düşünmesini istediğinizde max’a yükseltin. low ile high arasındaki fark basit sorular için önemsizdir, ancak karmaşık muhakeme için belirgindir.

Eforu CLI bayrağı, ortam değişkeni veya CLAUDE.md dosyanız aracılığıyla ayarlayabilirsiniz:

# CLI bayrağı
claude -p "Refactor auth.py" --effort medium

# Ortam değişkeni
export CLAUDE_EFFORT=medium

# Veya CLAUDE.md içinde
# Settings
effort: medium

Maliyet duyarlı CI pipeline’ları için, eforu MAX_THINKING_TOKENS ile birleştirerek sert bir tavan içinde tam kalitede muhakeme elde edin:

MAX_THINKING_TOKENS=8000 claude -p "Refactor auth.py" --effort high

Bu, yüksek kaliteli muhakeme sağlar ancak aşırı düşünme token’ı harcamasını önler. Opus fiyatlandırmasında ($75/M çıktı token’ı), sınırsız karmaşık bir istem 20K+ düşünme token’ı harcayabilir — sadece düşünme için tek bir yanıtta $1.50.

Bağlam Tüketicileri

Claude’un bağlam penceresindeki her bilgi parçası token maliyeti taşır. Canlı bir dökümü görmek için etkileşimli bir oturum içinde /context komutunu kullanın.

MCP araç tanımları özel dikkat gerektirir. Her araç tanımı 200-500 token tüketir. Birden fazla MCP sunucusu arasında 80+ araç olduğunda, çalışmaya başlamadan önce 40K-50K token kaybedebilirsiniz. /context ile denetleyin, kullanılmayan sunucuları .claude/settings.json içinde devre dışı bırakın ve araç şemalarını başlangıçta değil talep üzerine yüklemek için ToolSearch ertelenmiş yüklemeyi kullanın:

# MCP araçları bağlamın %5'ini aştığında ertelenmiş yüklemeyi tetikle
ENABLE_TOOL_SEARCH=auto:5 claude

/compact Komutu

Bağlamınız doluyorken, /compact komutu konuşmayı özetler ve tam geçmişi sıkıştırılmış bir versiyonla değiştirir. Otomatik sıkıştırmayı beklemeye göre temel avantajı kontroldür: neyin korunacağını siz belirlersiniz.

Ayrıca, manuel veya otomatik her sıkıştırma gerçekleştiğinde otomatik olarak uygulanmaları için sıkıştırma talimatlarını doğrudan CLAUDE.md dosyanıza gömebilirsiniz:

# Compact instructions
When you are using compact, please focus on test output and code changes

Bağlam şişkinliğini yönetmenin üç yolu, her biri farklı bir durum için:

Otomatik Sıkıştırma

Otomatik sıkıştırma, bağlam penceresi kullanımının yaklaşık %80-90’ına ulaşıldığında tetiklenir. Tetiklendiğinde, Claude tüm konuşmayı özetler, tam geçmişi o özetle değiştirir, CLAUDE.md’yi diskten yeniden okur ve araç sonuçlarını temel unsurlarına yoğunlaştırır. Neyin önceliklendirildiğini siz kontrol etmezsiniz — model karar verir.

Otomatik sıkıştırmanın sorunu, reaktif olmasıdır. Tetiklendiğinde, incelikli erken detaylar zaten kurtarılamayacak şekilde sıkıştırılmış olabilir. 3. turdan bir tasarım kararı gerekçesi, 40. tura kadar tek bir cümle haline gelebilir. Proaktif strateji, otomatik tetikleyiciye bırakmak yerine neyin hayatta kalacağına siz karar vermeniz için yaklaşık %60 kullanımda açık odak talimatlarıyla /compact komutunu manuel olarak çalıştırmaktır.

Birçok dosya okumayı veya ayrıntılı çıktı üretmeyi gerektiren görevler için, Task aracını kullanarak bir alt ajana devredin. Alt ajanlar kendi bağlam pencerelerinde çalışır, kapsamlı analiz yaparken ana konuşmayı yalın tutar.

Oturumlar Ne Zaman Ölür

Oturumlar, karmaşıklığa bağlı olarak ~10 tur veya ~100K kümülatif token’dan sonra bozulmaya başlar. Belirtiler: tekrarlayan yanıtlar, unutulan bağlam, daha yavaş gecikme. Bunları gördüğünüzde, temel kararları korumak ve çalışma durumunu sıfırlamak için /compact çalıştırın veya yalnızca temel bağlamı taşımanız gerekiyorsa claude --resume ile yeni bir oturum başlatın.

Cache Ekonomisi

Claude Code, sistem istemlerini ve CLAUDE.md içeriğini otomatik olarak cache’ler. Tam maliyet analizi için Bölüm 4’e bakın. Cache’lemenin uzun oturumlara nasıl uygulandığı:

Bir oturumdaki ilk çağrı, sistem istemini (~14K token) temel fiyatın 1.25-2.0 katına cache’e yazar. 5 dakika içindeki her sonraki çağrı, cache’lenmiş içeriği temel fiyatın 0.1 katına okur. 5 dakika hareketsizlikten sonra, geçici cache süresi dolar ve bir sonraki çağrı tam yazma maliyetini tekrar öder.

100 turlu bir Opus oturumu için tasarruflar çarpıcıdır: cache’siz, $15/M’de 15K girdi token’lık 100 tur yaklaşık $22.50’a mal olur. Cache’li, 1 yazma artı 99 okuma yaklaşık $2.51’e gelir — girdi token’larında %89 azalma. Gerçek dünya toplam oturum maliyetleri $50-100’dan $10-19’a düşer.

Bu iki yük, 30 saniye arayla çalıştırılan aynı istemlerdi (“What is 2+2?”). effort low çalıştırması effort high’dan 3.8 kat daha pahalıya mal oldu — ancak efor seviyesi yüzünden değil. Tüm maliyet farkı cache durumundan kaynaklanıyor. İlk çağrıda cache kaçırma (9104 oluşturma token’ı) yaşanırken, ikincisi sıcak bir cache’e isabet etti (14253 okuma token’ı). Sıcak cache’li sonraki çalıştırmalarda, efor ne olursa olsun maliyetler yakınsar. Basit istemler için, efor seviyesi ne yanıtı ne de maliyeti değiştirir.

Bağlam Yönetimi Kılavuzu

Uzun oturumlarda bağlamı sağlıklı tutmak için pratik bir tempo:

%60 kullanımda proaktif /compact. %80-90’daki otomatik sıkıştırmayı beklemeyin. O noktada, incelikli erken bağlam (tasarım gerekçeleri, reddedilen yaklaşımlar, değişken adlandırma kararları) zaten bozulmuş olabilir. Açık odak talimatlarıyla /compact çalıştırın: /compact Focus on the API contract changes and migration decisions.

MCP ek yük denetimi. Her MCP sunucusu, boşta olsa bile her tura 200-500 token’lık araç tanımı ekler. 20 sunucu ile bu, tur başına 4.000-10.000 token’lık ek yük demektir ve etkin bağlamınızı sessizce küçültür. Kontrol etmek için periyodik olarak /context çalıştırın. Aktif olarak kullanmadığınız sunucuları devre dışı bırakın.

Monorepo CLAUDE.md bölme. Tek bir 47K kelimelik CLAUDE.md, performansı önemli ölçüde düşürür. Alt dizine özgü dosyalara bölün — 47K’dan çoklu dosyalar arasında 9K kelimeye bölme, yanıt kalitesini artırır ve başlangıç ek yükünü azaltır.

Alt ajanlara devret. Birçok dosya okumayı veya ayrıntılı çıktı üretmeyi gerektiren görevler için Agent aracını kullanın. Alt ajanlar kendi bağlam pencerelerinde çalışır, kapsamlı analiz yaparken ana konuşmayı yalın tutar. Ana bağlama tam çalışma durumu değil, sonuç özeti döner.

/clear uyarısı. /clear komutu, tüm oturum geçmişini kurtarma mekanizması olmadan kalıcı olarak siler. Bir özet koruyan /compact’ın aksine, /clear her şeyi siler ve yalnızca CLAUDE.md’yi yeniden okur. Yalnızca tamamen yeni bir göreve başlarken kullanın.