Bağlam penceresi (context window) nedir?

Kısaca

Bağlam penceresi, bir dil modelinin tek bir istekte görebildiği en fazla metin miktarıdır ve token ile ölçülür. Sistem talimatları, araç tanımları, konuşma geçmişi, okunan dosyalar ve komut çıktıları bu pencereye sığmak zorundadır.

Kodlama ajanında bağlamı ne doldurur?

Bir ajanın her isteği, sabit bir taban ve giderek büyüyen bir geçmişten oluşur.

Sistem prompt’u ve araç tanımları; MCP sunucularının araçları dahil.
CLAUDE.md, AGENTS.md gibi proje talimat dosyaları.
Konuşma geçmişi: senin mesajların ve ajanın yanıtları.
Okunan dosyalar ve komut çıktıları; çoğu zaman en büyük kalem budur.

Pencere dolunca ne olur?

Model her turda bağlamın tamamını yeniden okur. Pencere dolmaya yaklaşınca ajanlar konuşmayı özetleyip eski ayrıntıları atar; Claude Code’da buna sıkıştırma (compaction) denir ve /compact komutuyla elle de yapılır. Özet işe yarar ama bazı ayrıntılar kaybolur. /clear ise konuşmayı tamamen sıfırlar.

Büyük pencere her şeyi çözmez

Güncel modellerin pencereleri yüz binlerce token’a ulaşıyor. Yine de bağlam uzadıkça her tur daha pahalı ve yavaş olur, model de uzun bağlamın içindeki ayrıntıları kaçırabilir. Bağlamı küçük ve ilgili tutmak, büyük pencereye güvenmekten genelde daha iyi sonuç verir.

Bağlamı verimli kullanmak

Birkaç alışkanlık bağlamı uzun süre temiz tutar.

Bir görev bitince yeni bir konuşma başlat.
Kullanmadığın MCP sunucularını kapat.
Ajana dosyanın tamamını değil, ilgili bölümünü okut.
Uzun araştırmaları alt ajanlara ver; ana konuşmaya yalnızca özet dönsün.

AgentVera’da bağlam penceresi

AgentVera bağlamı görünür kılar ve küçültmek için birkaç yol sunar.

Ajan panelinde canlı bağlam boyutu görünür; /compact’ı elle ya da belirlediğin eşikte otomatik çalıştırırsın.
Bağlam profilleri: Yalın profil Claude Code’un ilk isteğini yaklaşık 34,4 bin token’dan 13,3 bine indirir.
Akıllı araçlar, bağlamda zaten olan ve değişmemiş bir dosyanın yeniden okunmasını engeller; büyük dosyalarda önce dosyanın taslağını verir.
Proje haritası, ajanın ilgili kodu dosya dosya okumadan bulmasını sağlar.

Sık sorulanlar

Bağlam penceresi dolunca ne olur?

Ajan konuşmayı özetleyip devam eder ya da daha fazla ilerleyemez. Claude Code otomatik olarak sıkıştırır; eski ayrıntıların bir kısmı özette kaybolabilir.

Bağlam penceresi ile kullanım limiti aynı şey mi?

Hayır. Bağlam penceresi tek istekte görülebilen metin miktarıdır. Kullanım limitleri ise belirli bir sürede yapabileceğin toplam kullanımı sınırlar.

/compact ile /clear arasındaki fark nedir?

/compact konuşmayı özetler ve özetle devam eder. /clear konuşmayı tamamen siler, ajan sıfırdan başlar.

Daha büyük bağlam penceresi daha iyi sonuç verir mi?

Her zaman değil. Daha fazla metin sığar, ama gereksiz bağlam maliyeti artırır ve modelin dikkatini dağıtabilir.