Claude Code Token Kullanımı Nasıl Düşürülür?
CLI tabanlı otonom ajanlarla çalışırken bütçenizi tüketmemek için 7 kritik bağlam ve maliyet optimizasyonu taktiği.
Anthropic'in terminal tabanlı yapay zeka kodlama asistanı Claude Code, geliştiricilerin üretkenliğini katbekat artıran muazzam bir otonom ajandır. Ancak Claude Code arka planda araç çağrıları yapar, dosyaları okur, derleme çıktılarını inceler ve her döngüde tüm bu konuşma geçmişini modele tekrar gönderir.
Tedbir alınmadığında küçük bir hata ayıklama oturumu bile yüz binlerce girdi token'ı (input token) tüketebilir ve beklenmedik faturalarla karşılaşmanıza neden olabilir. İşte Claude Code'da token kullanımını %60 ila %80 oranında düşürmenin en etkili yöntemleri:
"Ajan tabanlı yapay zekalarda en pahalı işlem, modelin yanıt üretmesi değil; her turda modelin önüne yığılan yüz binlerce satırlık geçmiş bağlamın (context) tekrar tekrar okunmasıdır."
1. Projenize Kapsamlı Bir `.claudeignore` Dosyası Ekleyin
Claude Code, projenizde arama yaparken veya dosya listelerken gereksiz devasa klasörleri tarayabilir. Projenizin kök dizinine mutlaka bir .claudeignore dosyası oluşturun:
# Paket ve derleme dizinleri
node_modules/
dist/
build/
.next/
vendor/
# Versiyon kontrolü ve kilit dosyaları
.git/
package-lock.json
pnpm-lock.yaml
yarn.lock
# Test raporları ve loglar
coverage/
*.log
*.sqlite
*.min.js
*.map
Yalnızca package-lock.json dosyasını yoksaymak bile tek bir araç çağrısında 50.000'den fazla gereksiz token tüketimini engeller!
2. Uzayan Oturumlarda Düzenli Olarak `/compact` Komutunu Çalıştırın
Bir hatayı ararken terminal çıktıları, test sonuçları ve önceki dosya okumaları konuşma geçmişinde birikir. Her yeni sorunuzda bu devasa yığın tekrar Anthropic API'sine gönderilir:
- Birkaç denemeden sonra terminale
/compactyazın. - Claude Code, oturumdaki tüm teknik çıkarımları ve dosya değişikliklerini kısa ve hap bir özet haline getirir; eski ham çıktıları bellekten siler.
- Bu sayede sonraki isteklerinizde context penceresi hafifler ve token harcaması anında dip yapar.
3. Bütün Dosyayı Açtırmak Yerine Hedefli Komutlar Verin
Ajanınıza "Bu hatayı düzelt" demek yerine, hatanın nerede olduğunu bildiğiniz durumlarda doğrudan konuma yönlendirin:
- Yanlış: "auth sistemindeki hatayı bulup çöz." (Ajan 10 farklı dosyayı baştan sona okur).
- Doğru: "src/utils/token.js içindeki verifyToken fonksiyonuna odaklan, sadece 45-70. satırlar arasındaki hatayı incele."
4. Anthropic Prompt Caching Mantığını Avantaja Çevirin
Claude Code, Anthropic'in Prompt Caching (İstem Önbellekleme) altyapısını otomatik olarak kullanır. Sistem promptları ve projenin başlangıç bağlamı önbelleğe alınır ve sonraki sorgularda %90 indirimli fiyattan faturalandırılır.
Önemli Kural: Önbelleğin süresi 5 dakikadır. Eğer bir soru sorduktan sonra 10 dakika beklerseniz önbellek zaman aşımına uğrar ve bir sonraki sorunuzda projenin tüm bağlamı tekrar "tam ücretle" okunur. Yoğun çalıştığınız bloklarda seri çalışmak token maliyetinizi ciddi şekilde düşürür.
5. Yeni Bir Göreve Geçtiğinizde Oturumu Sıfırlayın (`/clear`)
Bir özelliği başarıyla kodlayıp test ettikten sonra, tamamen farklı bir sayfayı kodlamaya geçerken eski oturumu devam ettirmeyin. Terminale /clear yazarak veya yeni bir terminal sekmesinde claude başlatarak tertemiz bir bağlamla işe başlayın.
6. `CLAUDE.md` Dosyasını Kısa ve Öz Tutun
Proje kök dizinindeki CLAUDE.md dosyası her bir sorgunun başına eklenir. Buraya onlarca sayfalık dökümantasyon yapıştırmak yerine, yalnızca kritik kuralları (derleme komutu, kodlama stili, test çalıştırma yöntemi) 30-40 satırı geçmeyecek şekilde maddeler halinde yazın.
Sıkça Sorulan Sorular
Büyük bir test suitini terminalde çalıştırıp yüzlerce satırlık hata çıktısı ürettiğinde veya kütüphanelerin minified bundle dosyalarını okumaya çalıştığında saniyeler içinde on binlerce token harcanır. .claudeignore kullanımı bu yüzden hayatidir.
Evet, Claude 3.5/3.7 Sonnet, Claude 3 Opus'a kıyasla token başına yaklaşık 5 kat daha ucuzdur ve kodlama yeteneklerinde pek çok benchmarkta Opus'tan daha hızlı ve başarılıdır. Günlük geliştirmelerde varsayılan olarak Sonnet tercih edilmelidir.