Claude Code'da Token Tüketimini Azaltmanın 9 Pratik Yolu

Claude Code ile ciddi anlamda kodlama çalışmaları yaptığımda edindiğim en önemli ders, token tüketiminin esasen bir fiyatlandırma sorunu değil, çalışma akışının verimliliğiyle doğrudan ilişkili olduğu oldu.

Bir oturumun karmaşıklaşmaya başlamasıyla birlikte performans da düşmeye başlıyor. Gereksiz dosyalar yeniden okunuyor, başarısız girişimler bellekte kalıyor ve artık geçerliliğini yitirmiş günlük kayıtları bağlam olarak depolanmaya devam ediyor. Bu durum, Claude'un dikkatini önemli olmayan detaylara yönlendiriyor ve verimsiz token kullanımına yol açıyor.

İşte bu sorunları çözmek için benimsediğim temel ilke:

Claude'un aktif bağlamını olabildiğince küçük, temiz ve işlevsel tutmak.

Aşağıda, günlük çalışmalarımda uyguladığım ve token tüketimini önemli ölçüde azaltan dokuz etkili yöntemi paylaşıyorum. Bu taktiklerin büyük olasılıkla size de yardımcı olacağını düşünüyorum.

Token Tüketimini Azaltmak İçin İlk Adım: Çıktıları Filtreleme

Claude Code'un çalışma belleğine aktarılan veriler arasında en önemli kaynak istenmeyen çıktıların temizlenmesidir. Tamamıyla ham hata kayıtları, uzun test çıktıları ve gereksiz sistem bilgileri, Claude'un dikkatini dağıtarak gereksiz token harcamasına neden olur.

Bunun yerine, yalnızca kritik bilgilerin yer aldığı özet çıktılar kullanmak çok daha verimlidir. Örneğin, başarısız bir testi, yığın izini ve beklenen/alınan değerleri gösteren komutlar tercih edilmelidir. Bunun için basit komut filtreleme yöntemleri uygulanabilir:

npm test 2>&1 | grep -A 5 -E "FAIL|ERROR|Error|Expected|Received" | head -100

Bu komut, yalnızca hata içeren satırları ve kısa bir bağlamı görüntüler. Böylece Claude, on binlerce satırlık bir çıktının yerine birkaç satırlık önemli veriyle çalışır. Bu yaklaşım, token tüketimini en çok azaltan yöntemlerden biridir, çünkü gereksiz gürültüyü baştan engeller.

Model Seçimini İşe Göre Optimize Etmek

Tüm görevler aynı hesaplama gücüne ihtiyaç duymaz. Özellikle en güçlü model olan Opus'un her görevde kullanılması, gereksiz yere yüksek token maliyetlerine neden olur. Çoğu kodlama görevi için Sonnet yeterli olurken, karmaşık mimari analizler veya zorlu hata ayıklamalar için Opus tercih edilebilir.

İşte benim model seçim stratejim:

• /model sonnet: Genel kodlama görevleri için varsayılan model
• /model opus: Karmaşık mimari kararlar, derinlemesine mantık yürütme veya zorlu hatalar için
• /model haiku: Tekrarlayan görevler, kalıp kodlar veya hızlı araştırmalar için

Alt ajanlar içinse (örneğin, keşif görevleri veya belge incelemeleri) Haiku kullanıyorum. Böylece ana iş parçacığı Sonnet üzerinde kalırken, yardımcı görevler daha hafif bir modele yüklenmiş olur. Bu yaklaşım, hem maliyetleri düşürür hem de token tüketimini optimize eder.

Uzun Oturumlarda /clear ve /compact Komutlarını Akıllıca Kullanmak

Uzun süreli bir oturumda Claude'un belleği, eski girişimler, başarısız teoriler ve güncelliğini yitirmiş kararlarla dolar. Bu durum, Claude'un performansını olumsuz etkileyebilir, çünkü gereksiz bilgiler bağlamda yer kaplar.

Bu sorunu çözmek için iki temel yaklaşım bulunuyor:

Tam Reset İçin /clear ve Aktarım Dosyası

Tam bir bağlam temizliği gerektiğinde /clear komutunu kullanıyorum. Ancak bu işlemi basitçe uygulamak yerine, önce bir aktarım dosyası oluşturuyorum. Bu dosya, mevcut görevin durumu, değiştirilen dosyalar, alınan kararlar ve bir sonraki adım hakkında tüm önemli detayları içeriyor.

Öncelikle, Claude'a .claude/session-handoff.md adında bir dosya oluşturmasını rica ediyorum. Bu dosyada yer alması gerekenler:

• Mevcut hedef
• Değiştirilen dosyalar
• Alınan kararlar
• Başarısız olan testler
• Kök neden analizi
• Bir sonraki adım

Daha sonra:

/clear

ve ardından:

.claude/session-handoff.md dosyasını oku ve devam et

Bu yöntem, ilerlemenin kaybolmasını engellerken, yeni bir oturum için taze bir bağlam sağlıyor.

Orta Seviye Temizlik İçin /compact

Eğer görev devam ediyorsa ve yalnızca hafif bir temizlik gerekiyorsa, /compact komutunu kullanıyorum. Ancak bu komutu körü körüne uygulamak yerine, Claude'a hangi bilgilerin korunması gerektiğini açıkça belirtmek önem taşıyor. Örneğin:

/compact

Korunması gerekenler: Kullanıcı güncellemeleri için optimistik kilitleme, bu oturumda şema değişikliği yapılmayacak

Bu şekilde, /compact komutu yalnızca kritik kararları saklarken, gereksiz verileri temizleyerek belleğin verimli kullanılmasını sağlıyor.

CLAUDE.md Dosyasını Minimalist Tutmak

Birçok kullanıcı, CLAUDE.md dosyasını gereğinden fazla doldurma eğiliminde oluyor. Mimari notlar, dağıtım adımları, PR kuralları, hata ayıklama kılavuzları ve proje geçmişi gibi çeşitli bilgiler bu dosyaya ekleniyor. Oysa bu yaklaşım, her oturumda gereksiz token tüketimine yol açıyor.

Benim önerim, CLAUDE.md'yi olabildiğince hafif tutmak. Dosyada yalnızca aşağıdaki bilgilerin yer alması yeterli olacaktır:

• Paket yöneticisi komutu
• Test komutu
• Derleme komutu
• Depo yapısı
• Temel mimari kısıtlamalar
• Yasak desenler
• Adlandırma kuralları

Diğer tüm bilgiler, skills klasörüne veya ayrı dokümantasyon dosyalarına kaydedilmelidir. Örneğin:

• .claude/skills/db-migration/SKILL.md
• .claude/skills/pr-review/SKILL.md
• .claude/skills/prod-debugging/SKILL.md

Bu yaklaşım, temel bağlamın hafif kalmasını sağlarken, yalnızca ihtiyaç duyulduğunda ilgili bilgilerin yüklenmesine olanak tanır.

Değişiklik Öncesi Planlama Aşamasını Kullanmak

Claude Code, plan modunu destekleyerek, değişiklikler yapılmadan önce bir eylem planı oluşturmayı mümkün kılıyor. Bu mod, gereksiz token harcamalarını önlemenin yanı sıra, yapılan değişikliklerin daha sistematik ve kontrollü olmasını sağlıyor.

Örneğin, büyük bir mimari değişiklik yapmadan önce:

/plan

komutunu kullanarak, yapılacak değişikliklerin bir taslağını oluşturabilir ve bu planı projeye entegre edebilirsiniz. Bu sayede, yalnızca gerekli değişiklikler yapılmış olur ve token tüketimi optimize edilmiş olur.

Sonuç: Token Tüketimini Kontrol Altına Almak

Claude Code kullanırken token tüketimini azaltmanın temelinde, verimsiz bağlam kullanımını engellemek yatıyor. Bu da ancak doğru model seçimi, çıktı filtreleme, akıllıca /clear ve /compact kullanımı ve minimal CLAUDE.md dosyasıyla mümkün oluyor.

Bu stratejileri benimsemek, yalnızca maliyetleri düşürmekle kalmıyor, aynı zamanda Claude'un performansını da önemli ölçüde artırıyor. Gelecekteki projelerinizde bu yöntemleri uygulayarak, hem token tüketiminizi optimize edebilir hem de daha verimli bir kodlama deneyimi yaşayabilirsiniz.