Claude Code token tasarrufu, uzun konuşmalarda maliyeti ve limit tüketimini doğrudan etkiler. Çoğu kişi tasarrufu prompt’u kısaltmakta arar; oysa asıl yük, sen daha tek kelime yazmadan her isteğe eklenen temel bağlamdır. Bu yazıda bu tabanın nereden geldiğini, nasıl ölçtüğümüzü ve %61’e varan küçülmeyi hangi ayarlarla sağladığımızı anlatıyorum.
Token nereye gidiyor?
Bir kodlama ajanına her mesaj gönderdiğinde model yalnızca senin yazdığını görmez. İstekte şunlar da bulunur:
- Sistem talimatı
- Araç tanımları (Bash, Read, Edit, Write, Glob, Grep ve diğerleri)
- Kullanıcı düzeyindeki eklentiler, hook’lar ve skill’ler
- Bağlı MCP sunucularının araç tanımları
- Projenin talimat dosyaları (CLAUDE.md, AGENTS.md)
- O ana kadarki konuşma
İlk beşi her turda yeniden okunur. Konuşma uzadıkça son madde de büyür. Yani küçük bir taban bile yüz turluk bir oturumda katlanarak büyür.
Ölçüm: ilk istekte ne kadar bağlam var?
Yeni bir oturumun ilk isteğinde modele giden bağlamı Claude Code 2.1 ve Codex 0.155 ile ölçtük:
| Profil | Claude Code | Codex |
|---|---|---|
| Standart | ≈34,4 bin | ≈13,3 bin |
| Dengeli | ≈23,7 bin (−%31) | — |
| Yalın | ≈13,3 bin (−%61) | ≈9,7 bin (−%27) |
Dengeli profil araç setini Bash, Read, Edit, Write, Glob ve Grep ile sınırlar. Yalın profil buna ek olarak kullanıcı düzeyindeki eklentileri, hook’ları, skill’leri ve harici MCP sunucularını yüklemez. Codex’te yalın profil uygulamaları ve web aramasını kapatır.
İşe yaramayan ayarlar
Ölçerken bazı bayrakların tek başına ilk isteği küçültmediğini gördük:
--strict-mcp-config--exclude-dynamic-system-prompt-sections--disable-slash-commands
Claude Code bu parçaları zaten gerektiğinde yüklüyor. Asıl kazanç araç setini daraltmaktan ve kullanıcı düzeyindeki eklenti, hook ve skill’leri yüklememekten geliyor.
İki seçeneği de bilerek kullanmadık: --safe-mode projenin CLAUDE.md dosyasını da kapatıyor, --bare ise yalnızca API anahtarıyla çalışıyor. İkisi de günlük kullanım için fazla kısıtlayıcı.
Claude Code token tasarrufu için pratik adımlar
1. Görevin gerektirdiği kadar araç ver
Dokümantasyon güncelleyen ya da tek dosyada refactor yapan bir ajan tarayıcıya, görsel araçlara veya bir düzine MCP sunucusuna ihtiyaç duymaz. Bu tür işler için dengeli ya da yalın profille başlat.
2. MCP sunucularını seçerek bağla
Her MCP sunucusu araç tanımlarıyla bağlama yük ekler. Bir sunucuyu bütün ajanlara değil, gerçekten kullanacak ajanlara ver. AgentVera’nın MCP yöneticisi bağlantı testinde her aracın yaklaşık token maliyetini gösterir; şişkin bir sunucuyu bağlama girmeden fark edersin.
3. Bağlam boyutunu izle
Tasarrufun ilk adımı görmektir. AgentVera her ajanın panelinde canlı bağlam boyutunu gösterir. Bir konuşmanın ne zaman pahalılaştığını tahmin etmek yerine sayıya bakarsın.
4. Uzayan konuşmaları sıkıştır
/compact konuşmanın geçmişini özetler ve sonraki her turu küçültür. Elle çalıştırabilir ya da AgentVera’da bir eşik belirleyip otomatik sıkıştırma açabilirsin. Bağlam o eşiği geçince ajan sıkıştırılır.
5. Ajanlar arası aktarımı sınırla
Bir ajanın çıktısını diğerine akışla aktarırken tamamını göndermek gerekmez. Akışlardaki Dönüştür düğümü yanıtı kısaltabilir, ilk ya da son N satırı veya son kod bloğunu alabilir. Böylece hedef ajanın bağlamı gereksiz metinle dolmaz.
6. Prompt’u ucuz bir modelle düzelt
Taslağını göndermeden önce daha anlaşılır hale getirmek istiyorsan bunu pahalı ana modelle yapmana gerek yok. AgentVera’daki Revize et, araçları kapalı ve oturum kaydı tutmayan bir claude -p --model sonnet çağrısı yapar. Dosya içerikleri gönderilmez; yalnızca taslak, ajan adı, rolü ve proje adı gider.
Profil seçimi için karar tablosu
| İş | Önerilen profil | Neden |
|---|---|---|
| Tarayıcıyla test, MCP’li entegrasyon | Standart | Araçların hepsine ihtiyaç var |
| Günlük özellik geliştirme | Dengeli | Temel dosya ve kabuk araçları yeterli |
| Dokümantasyon, küçük refactor | Yalın | En küçük taban, en ucuz turlar |
| Uzun araştırma oturumu | Dengeli + eşikte /compact | Bağlam büyümesini sınırlar |
Ölçümleri kendi kurulumunda doğrula
Sayılar senin eklentilerine, skill’lerine ve MCP sunucularına göre değişir. Kendi tabanını görmek için yeni bir oturum aç, tek kısa bir mesaj gönder ve ilk istekteki bağlam boyutuna bak. Ardından aynı şeyi daha dar bir profille dene. Fark, bütün oturum boyunca her turda ödediğin miktardır.
Bir oturumda farkı hesaplamak
Yüzdeler soyut kalabilir; bir oturum üzerinden düşünelim. Diyelim ki bir ajanla 40 turluk bir çalışma yapıyorsun. Konuşma geçmişi bir yana, her turda temel bağlam yeniden okunur.
| Profil | İlk istekteki taban | 40 turda yalnızca taban |
|---|---|---|
| Standart | ≈34,4 bin | ≈1,38 milyon |
| Dengeli | ≈23,7 bin | ≈948 bin |
| Yalın | ≈13,3 bin | ≈532 bin |
Bu tablo yalnızca tabanı gösterir; gerçek kullanım konuşma geçmişi, araç çıktıları ve modelin yanıtları eklendikçe daha yüksektir. Sağlayıcıların önbellekleme gibi mekanizmaları da faturalandırmayı etkileyebilir. Yine de tablo şunu açıkça gösterir: taban küçüldükçe her turun maliyeti küçülür ve fark oturum uzadıkça büyür.
Hangi işi hangi profille yapmalı?
Profil seçimi bir kez yapılıp unutulacak bir ayar değil. Ajanın rolüne göre değişir:
- Araştırma yapan ajan: Çok dosya okur, tarayıcıya ya da belge MCP’lerine ihtiyaç duyabilir. Standart profil ve eşikte otomatik sıkıştırma iyi bir başlangıçtır.
- Uygulama yapan ajan: Çoğunlukla dosya okuyup yazar ve kabuk komutu çalıştırır. Dengeli profil yeterlidir.
- Test ya da dokümantasyon ajanı: Dar bir alanda çalışır. Yalın profil burada en çok tasarrufu sağlar.
Paralel çalışırken bu farklar toplanır. Üç ajanın hepsini standart profille açmak yerine rollerine göre profil vermek, aynı limiti daha uzun süre kullanmanı sağlar.
Eşikte otomatik /compact nasıl ayarlanır?
Elle sıkıştırma unutulmaya müsaittir. Otomatik sıkıştırmanın mantığı basit: ajanın bağlamı belirlediğin eşiği geçince /compact çalışır. Eşiği seçerken şunu düşün:
- Çok düşük eşik: Ajan sık sık özetlenir ve önceki ayrıntıları kaybedebilir.
- Çok yüksek eşik: Sıkıştırma geç gelir; o ana kadar her tur pahalıdır.
Pratikte, uzun araştırma oturumlarında daha erken; kısa uygulama oturumlarında daha geç bir eşik iyi çalışır. AgentVera’da bağlam boyutu panelde canlı göründüğü için eşiği gözlemleyerek ayarlayabilirsin.
Sık yapılan hatalar
- Her ajana her MCP’yi vermek. Kullanılmayan araç tanımları her turda okunur.
- Konuşmayı hiç sıkıştırmamak. Yüzlerce turluk bir oturum, eski ve artık gereksiz ayrıntıları taşımaya devam eder.
- Çıktıyı olduğu gibi aktarmak. Uzun bir yanıtın tamamını başka bir ajana göndermek ikinci ajanın bağlamını da şişirir.
- Tasarrufu yalnızca prompt’ta aramak. Prompt genelde toplamın küçük bir parçasıdır.
Sonuç
Claude Code token tasarrufunun büyük kısmı, her turda tekrar okunan tabandan gelir. Araç setini göreve göre daraltmak, MCP’leri seçerek bağlamak ve konuşmayı zamanında sıkıştırmak, aynı işi daha az bağlamla yapmanı sağlar. Ölçtüğümüz kurulumda bu, ilk istekte %61’lik bir küçülme demekti.
AgentVera bağlam profillerini, canlı bağlam göstergesini ve eşikte otomatik /compact’ı ajan başına ayarlamanı sağlar. Ayrıntılar için token tasarrufu sayfasına ve Claude Code sayfasına bakabilir, ücretsiz planla başlayabilirsin.