---
title: "Bağlam yönetimi"
description: "Daha iyi sonuçlar için bağlamı etkili yönetme"
---
---
Etkili bağlam yönetimi, Verdent uygulamasının doğru bilgiye doğru zamanda sahip olmasını sağlarken, bağlam aşırı yüklenmesinden kaynaklanan performans düşüşünü önler.
### Neler öğreneceksiniz
- Bağlam pencerelerini ve sınırlarını anlama
- Optimum bağlam için dosyaları stratejik olarak seçme
- Bağlam aşırı yüklenmesini tanıma ve buna yanıt verme
- Daha iyi performans için bağlamı ne zaman sıfırlamalı
- Çalışma alanı düzeninin bağlamı nasıl etkilediği
---
## Bağlam pencerelerini anlama
Verdent for VS Code uygulamasının bağlam penceresi boyutu, kullanılan modele bağlıdır.
Çoğu model standart `200K` bağlam pencereleri kullanır:
- **Claude 4.5 Sonnet** - Karmaşık görevler için dengeli
- **Claude 4.5 Haiku** - Hızlı ve verimli
- **GPT-5** - Akıl yürütme için mükemmel (Beta)
- **GPT-5-Codex** - Kodlama için optimize edilmiş (Beta)
**Kapasite:**
- ~`200,000` token toplam bellek kapasitesi
- Çoğu geliştirme görevi ve orta boyutlu proje için yeterli
**Neler dahil:**
- Konuşmadaki tüm mesajlar
- Bağlama yüklenen dosya içerikleri
- Araç çıktıları ve yanıtlar
- Sistem istemleri ve talimatlar
- MCP sunucu tanımları
**Performans:**
- Sınırlara yaklaşıldığında önemli ölçüde düşer
- Bağlam aşırı yüklenme belirtilerine dikkat edin (daha yavaş yanıtlar, daha az doğru çıktılar)
- Optimum performans için bağlamı daha sık sıfırlayın
Claude Sonnet 4.5, açıkça seçildiğinde veya giriş `200K` token'ı aştığında genişletilmiş bağlam (`1M` token) sunar.
**Kapasite:**
- `1,000,000` token toplam bellek
- Standart modellerden 5 kat daha büyük
**Avantajlar:**
- Tüm büyük kod tabanlarını parçalara ayırmadan yüklemek için mükemmel
- Büyük projeler için çoğu bağlam yönetimi endişesini ortadan kaldırır
- Bağlam sınırlarına ulaşmadan önce daha uzun süre çalışın
- Daha az oturum sıfırlamasına ihtiyaç duyulur
**Ne zaman kullanılır:**
- `1000+` dosyalı büyük kod tabanları
- Tüm projeler genelinde karmaşık çok dosyalı yeniden düzenleme
- Birden çok ilgili görevi kapsayan uzun geliştirme oturumları
- Bağlam yönetimi yükünü en aza indirmek istediğinizde
---
## Stratejik dosya seçimi
Bağlam kullanımını optimize etmek ve sınırlara ulaşmaktan kaçınmak için dosya seçiminde stratejik olun.
Daha az dosyayla başlayın ve yalnızca gerektiğinde daha fazlasını ekleyin; Verdent konuşma sırasında her zaman ek dosyaları okuyabilir.
### Açık dahil etme için @-mention kullanın
```
@filename.js
```
Verdent ilgili dosyaları otomatik yükler, ancak `@-mentions` tam bağlamı garanti eder. Seçici olun; yalnızca mevcut görevle doğrudan ilgili dosyaları dahil edin.
### Bağlam kullanımını izleyin
- Oturumlar uzadıkça performans düşüşüne dikkat edin
- Konuşma uzunluğu ve dosya sayısının farkında olun
- Mümkün olduğunda gereksiz dosyaları bağlamdan çıkarın
### Bağlam aşırı yüklenmesinden kaçının
- Büyük görevleri, görev başına daha az dosyayla daha küçük parçalara bölün
- Yalnızca ilgili dosyalara odaklanın; tüm kod tabanını bir kerede yüklemeyin
- Kullanılmayan entegrasyonları devre dışı bırakmak için MCP sunucu yönetimini kullanın
### En iyi uygulamalar
- Yalnızca değiştirilmesi veya başvurulması gereken dosyaları dahil edin
- Örnek dosyaları yüklemek yerine mevcut kalıplara başvurun
- Büyük kod tabanları için her seferinde bir modül üzerinde çalışın
- Birçok dosya yüklemek yerine proje belgelerini (`AGENTS.md`) kullanın
- Bellek yoğun görevler için bağlam penceresinin son beşte birinden kaçının
### Genişletilmiş bağlam (1M token) için
Dosya seçimi çok daha az kritik hale gelir; genellikle tüm proje depolarını sınırlara ulaşmadan yükleyebilirsiniz.
---
## Bağlam aşırı yüklenmesini tanıma
**Belirtiler:**
- Daha az doğru veya eksik yanıtlar
- Konuşmanın başlarındaki önemli ayrıntıların kaçırılması
- Uzun oturumlarda tutarlılığı korumada zorluk
- Son değişiklikler veya bağlam hakkında kafa karışıklığı
**Somut örnekler:**
- Oturumun başında zaten reddettiğiniz çözümleri önerir
- `20` mesaj önce belirlediğiniz kodlama kurallarını göz ardı eder
- Konuşmanın başında yapılan değişikliklerle çakışan kod üretir
- Daha önce tartışılan proje mimarinizle eşleşmeyen uygulamalar önerir
**Birincil sinyal:** Verdent yanıtları daha az doğru veya tutarsız hale gelir
**Belirtiler:**
- Belirgin şekilde daha yavaş yanıt süreleri
- Yanıtlar başlamadan önce daha uzun işleme gecikmeleri
- Mesajlar arasında artan gecikme
**Somut örnekler:**
- Normalde `5-10` saniye süren yanıtlar artık `30+` saniye sürüyor
- Bir mesaj gönderdikten sonra yazıyor göstergesi görünmeden önce görünür gecikme
- Akış halindeki yanıtlar her zamankinden çok daha yavaş başlar
- Araç yürütme (dosya okumaları, aramalar) belirgin şekilde daha uzun sürer
**Birincil sinyal:** Yanıtlar her zamankinden önemli ölçüde daha uzun sürer
**Belirtiler:**
- Zaten sağlanan bilgileri açıklama istekleri
- Daha önce belirlenen kalıpları veya kuralları unutma
- Daha önce tartışılan dosyalara veya koda başvuramama
- Proje yapısı hakkında gereksiz sorular
**Somut örnekler:**
- `30` mesaj önce React kullandığınızı belirttiğinizde "Hangi çerçeveyi kullanıyorsunuz?" diye sorar
- Zaten birden çok kez `@-mentioned` dosya yollarını ister
- Oturumun başında belirlediğiniz adlandırma kuralını hatırlamaz
- Gerekçeleriyle birlikte zaten reddettiğiniz kavramları veya yaklaşımları yeniden açıklar
**Birincil sinyal:** Verdent zaten tartışılan şeyleri sorar
**Belirtiler:**
- `200K` token sınırının son beşte birine yaklaşma (~`160K+` token kullanıldı)
- Birçok dosya okuması ve araç çıktısı içeren uzun konuşmalar
- Ağır araç tanımlarıyla birden çok MCP sunucusunun etkinleştirilmesi
- Büyük dosyaların bağlama tekrar tekrar yüklenmesi
**Somut örnekler:**
- Oturum `100+` mesajla `2+` saattir çalışıyor
- Konuşma boyunca `@-mentions` ile `20+` dosya yüklediniz
- Birden çok büyük dosya (her biri `>1000` satır) bağlamda
- Kapsamlı araç tanımlarıyla `5+` MCP sunucusu etkinleştirilmiş
- Konuşma birçok grep/arama sonucu ve dosya okuması içeriyor
**Birincil sinyal:** Kapsamlı dosya/araç kullanımıyla çok uzun oturumlar
**Ne zaman harekete geçmeli:** Performans düşüşü birincil sinyalinizdir. Verdent yanıtları daha az doğru, daha yavaş veya tutarsız hale gelirse, yeni bir oturum başlatın veya bağlam yönetimi stratejileri kullanın.
Verdent yanıtları belirsiz veya tekrarlayıcı hale gelirse, bağlam aşırı yüklenmesi yaşanıyor olabilir. Tam performansı geri yüklemek için konuşmayı sıfırlayın.
**Not:** `1M` token bağlamıyla (Claude Sonnet 4.5), bu sorunlar çok daha az yaygındır.
---
## Bağlamı ne zaman sıfırlamalı
- Belirgin şekilde daha yavaş yanıt süreleri
- Daha az doğru veya tutarsız yanıtlar
- Verdent önceki bağlamı veya kalıpları unutuyor
- Bağlam penceresi sınırlarına yaklaşma (düşüş belirtilerine dikkat edin)
**Eylem:** Kalite düştüğünde yeni oturum başlatın
- İlgisiz özellikler veya modüller arasında geçiş yapma
- Bir yapılacak işi tamamlayıp bir sonrakine geçme
- Bellek yoğun görevlerden sonra (büyük yeniden düzenlemeler, mimari çalışma)
- Araştırma aşamasından uygulama aşamasına geçme
**Eylem:** Yeni ana görev için yeni oturum
- Tamamlanan özellikleri sürüm denetimine commit ettikten sonra
- Geliştirme iş akışındaki mantıksal kontrol noktaları arasında
- Test-doğrulama-commit döngülerini takiben
**Eylem:** Commit → test → yeni oturum
- Büyük yeni özellikler başlatmadan önce
- Konuşma geçmişi çok uzadığında
- Çok dosyalı değişiklikleri tamamladıktan sonra
- Farklı çalışma türleri arasında (hata ayıklama → özellik geliştirme)
**Eylem:** Bağlam düşmeden önce proaktif olarak yeni oturum başlatın
**En iyi uygulama iş akışı:** Atomik iş birimini tamamla → test et → commit et → bağlamı temizle → bir sonraki görev için yeniden başla.
**Not:** Bağlamı sıfırlamak için yeni bir oturum başlatın. `1M` token bağlamlarında temizleme çok daha az sıklıkta gerekir.
---
## Çalışma alanı düzeninin etkisi
Çalışma alanı düzeni, bağlamın ne kadar verimli kullanıldığını ve Verdent kod tabanınızda ne kadar kolay gezinebileceğini doğrudan etkiler.
**Daha küçük, odaklı dosyalar:**
- Birçok küçük dosya, az sayıda büyük dosyaya göre bağlamı daha verimli kullanır
- Yalnızca ilgili modülleri yüklemek daha kolay
- Bağlamda nelerin olduğu üzerinde daha ince ayrıntılı denetim
- Tüm büyük dosyaları yükleme ihtiyacını azaltır
**Net dizin yapısı:**
- Mantıksal düzen, Verdent ilgili dosyaları bulmasına yardımcı olur
- Özellik tabanlı veya modül tabanlı düzen, bağlam hedeflemeyi iyileştirir
- İlgisiz kodu yükleme ihtiyacını azaltır
**`Documentation in AGENTS.md:`**
- Proje belgeleri, birçok örnek dosyayı yükleme ihtiyacının yerini alır
- Mimari kalıplar bir kez açıklanır, tekrar tekrar başvurulur
- Kodlama standartları merkezi olarak belgelenir
- Keşif amaçlı dosya okumalarından kaynaklanan bağlam yükünü azaltır
**Avantajlar:**
- Tüm kod tabanını yüklemeden izole modüller üzerinde çalışın
- Net sınırlar odaklı oturumları mümkün kılar
- İşi parçalara ayırma, modül sınırları boyunca doğal hale gelir
**Sorunlar:**
- Monolitik dosyalar, tüm büyük bağlamları yüklemeye zorlar
- Belirsiz yapı, mimariyi anlamak için birçok dosyayı yüklemeyi gerektirir
- Aynı dosyalardaki karışık endişeler, ilgisiz koda bağlam harcar
**Etki:**
- Sık bağlam sınırı sorunları
- İlgisiz koda harcanan token'lar
- İşi belirli modüllere izole etmede zorluk
- Daha sık oturum sıfırlama ihtiyacı
**Yaygın anti-kalıplar:**
- Birden çok endişeli tek `5000+` satırlık dosyalar
- Kökte `100+` dosyalı düz dizin yapısı
- Özellikler/modüller arasında net ayrım yok
- Merkezi belge eksikliği
**Yeniden düzenleme yaklaşımları:**
- Büyük dosyaları daha küçük, odaklı modüllere bölün
- Dosya türüne göre değil, özelliğe veya alana göre düzenleyin
- Net bir dizin hiyerarşisi oluşturun
- Paylaşılan kodu ayrı modüllere ayıklayın
**Belgeleme:**
- Mimari kalıplarla `AGENTS.md` oluşturun
- Kodlama standartlarını merkezi olarak belgeleyin
- Modül başına `README` dosyaları tutun
- Tasarım kararlarını belgelenmiş halde tutun
**Bağlam etkisi:** Standart `200K` token bağlamları için, düzenli çalışma alanları sınırlara sık veya nadir ulaşma arasındaki farkı yaratır. `1M` token bağlamları için düzen daha az önemlidir ancak yine de verimliliği artırır.
---
## Bağlam optimizasyon stratejileri
Etkili bağlam optimizasyonu, izleme, stratejik planlama ve teknik yapılandırmayı bir araya getirir.
**Performans belirtilerine dikkat edin:**
- Oturumlar boyunca yanıt kalitesini ve hızını izleyin
- Yanıtların ne zaman yavaşladığını veya daha az doğru hale geldiğini fark edin
- Konuşma uzunluğunu ve dosya sayısını elle takip edin
- Yeni oturum başlatma konusunda proaktif olun
**Neyi izlemeli:**
- Yanıt doğruluğu ve tutarlılığı
- İlk yanıt süresi (yazıyor göstergesi gecikmesi)
- Genel yanıt tamamlanma süresi
- Önceki konuşma ayrıntılarının hatırlanması
**Alt aracı yönetimi:**
- Gerekmediğinde kullanılmayan özel alt aracıları devre dışı bırakın
- Etkinleştirilen her alt aracı, sistem yüküne tanımlar ekler
- Yalnızca aktif olarak kullanılan alt aracıları etkin tutun
- Belirli görevler için gerektiğinde yeniden etkinleştirin
**Eylem eşiği:** `2-3` düşüş sinyallerini fark ettiğinizde, yeni bir oturum başlatma zamanıdır.
Bağlam sağlığının öncü göstergesi olarak yanıt kalitesini izleyin; düşen yanıtlar sıfırlama zamanının geldiğini gösterir.
**Parçalara ayırma yaklaşımı:**
- Büyük görevleri daha küçük parçalara bölün
- İlgili işleri odaklı oturumlarda tamamlayın
- Uzun konuşmalarda farklı görev türlerini karıştırmaktan kaçının
- Bellek yoğun çalışma için bağlam penceresinin son beşte birinden kaçının
**Oturum yönetimi:**
- Ana görevler arasında yeni oturum başlatın
- Commit'lerden sonra bağlamı temizleyin: test → doğrula → commit → yeni oturum
- Çok adımlı planlama için yapılacaklar listesi kullanın
- Yapılacak öğeleri ayrı odaklı oturumlarda işleyin
**En iyi uygulama kalıbı:**
1. Görevi Plan Mode'da planlayın
2. Odaklı uygulamayı yeni bir oturumda yürütün
3. Değişiklikleri test edin ve doğrulayın
4. Sürüm denetimine commit edin
5. Bir sonraki görev için yeni oturum başlatın
**Görev izolasyonu:** Hata ayıklamayı özellik geliştirmeden, araştırmayı uygulamadan ayrı tutun.
**Stratejik dahil etme:**
- `@-mentions` yalnızca gerektiğinde açık dosya dahil etme için kullanın
- Birçok dosya yüklemek yerine `AGENTS.md` belgelerinden yararlanın
- Büyük projeler için her seferinde bir modül üzerinde çalışın
- Büyük dosyaları daha küçük, odaklı bileşenlere bölün
**Dosya seçim ilkeleri:**
- Yalnızca değiştirme veya doğrudan başvuru gerektiren dosyaları dahil edin
- Örnek dosya yüklemesi yerine belgeleri tercih edin
- Artık gerekmediğinde dosyaları bağlamdan çıkarın
- Dosyaları önceden değil, tam zamanında yükleyin
**Büyük dosya işleme:**
- `500` satırın üzerindeki dosyaları bölmeyi düşünün
- Yardımcı programları ve yardımcıları ayrı dosyalara ayıklayın
- Net modül sınırları kullanın
- Dosya ilişkilerini `AGENTS.md` içinde belgeleyin
**Optimizasyon iş akışı:**
Performansı izle → Oturum şişmesini belirle → Kullanılmayan alt aracıları devre dışı bırak → Proaktif olarak yeni oturum başlat → Görev kalitesine odaklan
**Günlük uygulama:**
- Her ana özelliğe yeni bağlamla başlayın
- Sık commit yapın ve commit'ler arasında sıfırlayın
- Oturumları tek bir hedefe odaklı tutun
- Doğal kesme noktalarında bağlam kullanımını gözden geçirin
**`For Extended Context (1M tokens):`** Claude Sonnet 4.5'in daha büyük bağlam penceresiyle, optimizasyon daha az kritik hale gelir; agresif bağlam yönetimi yerine görev kalitesine odaklanın. Ancak iyi uygulamalar yine de verimliliği ve düzeni artırır.
---
## SSS
Standart modeller (Claude 4.5 Sonnet, Haiku, GPT-5, GPT-5-Codex, MiniMax-M2) çoğu görev için yeterli `200K` token bağlam penceresine sahiptir. Claude Sonnet 4.5, `1000+` dosyalı büyük kod tabanları, karmaşık çok dosyalı yeniden düzenleme veya uzun geliştirme oturumları için genişletilmiş `1M` token bağlam (5 kat daha büyük) sunar. `1M` bağlam, giriş `200K` token'ı aştığında otomatik olarak etkinleşir veya açıkça seçilebilir.
Bağlamı sıfırlamak için elle yeni bir oturum başlatmanız gerekir; Verdent bağlamı otomatik olarak temizlemez. En iyi uygulama: atomik bir iş birimini tamamladıktan, test ettikten ve sürüm denetimine commit ettikten sonra sıfırlayın. `1M` token bağlamları için sıfırlama çok daha az sıklıkta gerekir.
Sabit bir dosya sınırı yoktur; dosya boyutlarına ve toplam token sayısına bağlıdır. `200K` bağlamları için `20+` büyük dosya (her biri `>1000` satır) yüklemekten kaçının. Mevcut görevinizle doğrudan ilgili dosyalara odaklanın. `@-mentions` öğesini seçici kullanın ve birçok örnek dosya yüklemek yerine `AGENTS.md` belgelerinden yararlanın. `1M` bağlamıyla dosya seçimi çok daha az kritik hale gelir.
Oturumunuzdaki her şey: konuşmadaki tüm mesajlar, bağlama yüklenen dosya içerikleri, araç çıktıları (grep/arama sonuçları, dosya okumaları), sistem istemleri ve talimatlar ve MCP sunucu tanımları. Bunların her biri toplam bağlam kapasitenizden token tüketir.
Hayır; bağlamı sıfırlamak yalnızca konuşma geçmişini ve yüklenen dosyaları bellekten temizler. Gerçek kod değişiklikleriniz, commit'leriniz ve dosya değişiklikleriniz korunur. Güvenlik için bağlamı sıfırlamadan önce işinizi her zaman sürüm denetimine commit edin. Sıfırla → yeni oturum başlat → bir sonraki görevde çalışmaya devam et.
---
## Ayrıca bkz.
Etkili istemler yazmak için en iyi uygulamalar
Yürütme modlarını ve kaynak etkilerini anlama
Token kullanımını, kredileri ve performansı izleyin