Claude Code Her Arka Plan Ajanının Transkriptini Düzenli Olarak Modeline Gönderiyor: 3 Kelimelik Durum Satırı İçin %15-20 Token Tüketimini Kapatma Rehberi

Flamerix AI tarafından MIT lisansı altında paylaşılan bu çalışma, Claude Code (Linux üzerinde 2.1.257–2.1.312 sürümlerinde test edilmiştir) kullanıcılarının farkında olmadan yaşadığı büyük bir token ve hız limiti (rate-limit) kaybını ele alıyor. İkili dosya (binary) değiştirilmeden, yalnızca BUN_OPTIONS=--preload mekanizması kullanılarak agent_summary özelliği devre dışı bırakılabiliyor. Ancak olası bir güncelleme bu ayarı sessizce geri alabileceği için doğrulama adımlarını takip etmek kritik önem taşıyor.

Özet (TL;DR) ve Hızlı Kurulum#

Sorunu anında çözmek ve ön yükleme (preload) betiğini devreye almak için aşağıdaki komutları çalıştırabilirsiniz:

curl -fsSL https://gist.githubusercontent.com/flamerix-ai/c3905705cc4205e5de3011fa2e74efce/raw/no-agent-summary.js -o ~/.local/share/no-agent-summary.js
claude daemon stop --any
BUN_OPTIONS="${BUN_OPTIONS:+$BUN_OPTIONS }--preload $HOME/.local/share/no-agent-summary.js" claude

Bu işlemi her Claude Code süreci için kalıcı hale getirmek adına kurulum (Install) yapılandırmalarını sistem ortam değişkenlerinize ekleyebilirsiniz.

Sorun (The Problem)#

Claude Code, çalışan her arka plan ajanı (background agent) için yaklaşık her 30 saniyede bir, o ajanın tüm konuşma geçmişini (transcript) ajanın kendi modeline (genellikle Opus) gönderir ve modelden "en son eylemini 3-5 kelimeyle açıkla" (describe your most recent action in 3-5 words) isteğinde bulunur.

Dönen yanıt yalnızca ajanlar panelindeki durum satırını günceller; ne ana modele ne de sizin sohbetinize ulaşır. Bu özelliği kapatacak yerleşik bir ayar bulunmamaktadır ve Ağustos 2026'da yayınlanan 2.1.232 sürümünden bu yana varsayılan olarak açıktır.

Bu anomali, Claude Code'un OpenTelemetry çıktılarında DRIM tarafından tespit edilmiştir. claude_code.api_request olayları query_source değerine göre gruplandığında, agent_summary kaynaklı çağrıların ana sohbetin kendisinden bile daha maliyetli olduğu görülmüştür (query_source = agent_summary metriklerinin müdahale öncesi 1 hafta ve müdahale sonrası 2 günlük karşılaştırması):

• Tüm Claude Code harcamasındaki payı: Müdahale öncesi %16,4 (ana sohbet: %15,7) iken, müdahale sonrası %0.
• Tüm API isteklerindeki payı: Müdahale öncesi %19,7 (yaklaşık her 5 istekten 1'i) iken, müdahale sonrası %0.
• Bu harcamanın Opus üzerindeki oranı: Müdahale öncesi %96, müdahale sonrası —.
• Çıktı token'ı başına girdi token'ı oranı: Müdahale öncesi ≈ 9.000 : 1, müdahale sonrası —.

Buradaki harcama (cost_usd), doğrudan kesilen bir faturayı değil Claude Code'un istek başına kendi maliyet tahminini ifade eder. Abonelik kullanan geliştiriciler için asıl kayıp hız limiti (rate-limit) kapasitesidir. Ayrıca #86879 numaralı kayıt altında dört bağımsız ölçümde de %18–26 arasında benzer tüketim oranları belgelenmiştir.

Çözüm Nasıl Çalışır? (The Fix) ve Pratik Çıkarımlar#

Çözümün merkezindeki no-agent-summary.js, yaklaşık 80 satırlık bir Bun preload betiğidir ve çalışma zamanında gereksiz özetleme isteklerini ana uygulama koduna dokunmadan engeller.

Yazılım geliştirme ve Agent Monitoring / LLM Observability açısından bu vaka bize çok önemli dersler sunar:

• Gözlemlenebilirlik (Observability) Şarttır: OpenTelemetry metrikleri ve query_source bazlı kırılımlar incelenmeseydi, 3 kelimelik bir UI bileşeninin ana sohbetten daha fazla kaynak tükettiği fark edilemezdi.
• Model Seçimi ve Maliyet Optimizasyonu: 9.000:1 girdi/çıktı oranına sahip basit bir durum özeti için en güçlü model olan Opus'u tetiklemek ciddi bir mimari anti-pattern'dir; bu tür görevlerde küçük modeller veya yerel durum takibi kullanılmalıdır.