Uzun bir Claude Code oturumunun başından bir saatliğine kalkıp döndüğünüzde daha önce görmediğiniz bir satırla karşılaşabilirsiniz: “Compacted while idle, before the prompt cache expired.” Bu, Anthropic’in Ekim 2026’da yayınladığı ve o günden beri neredeyse her sürümde genişlettiği idle compaction, yani boşta sıkıştırma özelliği. Varsayılan olarak açık; çoğu kişi de onu okumadan önce yaşıyor.
Bu yazıda idle compaction’ın ne yaptığını, ne zaman çalıştığını, nasıl ayarlanıp kapatıldığını ve birkaç ajanı yan yana çalıştırırken neyi değiştirdiğini anlatıyoruz.
Ne değişti, ne zaman?
Tarihler her sürümün npm yayın tarihi, açıklamalar Claude Code değişiklik günlüğünden.
| Sürüm | Tarih | Değişiklik |
|---|---|---|
| 2.1.299 | 14 Ekim 2026 | Terminalde idle compaction: yaklaşık 54 dakika boşta kalan 200K+ tokenlık bir konuşma, bir saatlik prompt önbelleği dolmadan sıkıştırılır. CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS ve idleCompaction ayarı eklendi. |
| 2.1.302 | 16 Ekim 2026 | /config içine özelliği kapatıp açan bir Idle compaction satırı geldi. Sıkıştırmadan sonra çıkan bildirim artık nasıl kapatılacağını da söylüyor. |
| 2.1.314 | 30 Ekim 2026 | VS Code’da ve masaüstü uygulamasının Code sekmesinde idle compaction. Telemetrisi kapalı aboneler için de, bir saatlik önbellek açıkken Bedrock, Vertex, Foundry ve LLM ağ geçitlerinde de çalışıyor. |
| 2.1.318 | 3 Kasım 2026 | Idle compaction’ın konuşmayı özet olmayan bir yanıtla değiştirmesi düzeltildi. |
Idle compaction kullanıyorsanız bu son düzeltme için 2.1.318 ya da sonrasına güncelleyin.
Claude Code siz yokken neden sıkıştırıyor?
Her mesajda konuşmanın tamamı yeniden gönderilir. Bunu ucuz tutan şey prompt önbelleğidir: API daha önce işlediği kısmı tekrar kullanır. Ama önbellek bir süre işlem olmayınca dolar. Dolduktan sonra döndüğünüzde ilk mesajınız bütün geçmişi önbelleksiz girdi olarak baştan işler; 200K+ tokenlık bir konuşmada bu hem yavaş hem pahalıdır.
Sıkıştırma en ucuz, önbellek hâlâ sıcakken yapıldığında olur, çünkü özet isteği geçmişi önbellekten okur. Idle compaction tam bu aralığı kullanır: bir saatlik önbellek dolmadan kısa süre önce Claude Code özeti yazar. Döndüğünüzde sonraki mesajınız bütün konuşmayı yeniden kurmak yerine kısa özetten başlar. Ayrıntılar prompt önbelleği belgesinde.
Idle compaction ne zaman çalışır?
Ayarlar başvurusuna göre bir konuşmanın bunların hepsini karşılaması gerekir:
- Oturum: etkileşimli bir terminal oturumu, VS Code eklentisinin sohbet paneli ya da oturum kendi makinenizde veya SSH üzerinden çalışıyorsa masaüstü uygulamasının Code sekmesi.
- Otomatik sıkıştırma (
autoCompactEnabled) açık. - Prompt önbelleği: konuşma bir saatlik TTL’de.
- Boyut: bağlam eşiğe ulaşmış; varsayılan 200.000 token.
- Boşta kalma süresi: son istekten bu yana yaklaşık bir saat geçmiş ve bilgisayar o zamana kadar uyumamış.
Önbellek koşulu göründüğünden önemli. Claude Code bir saatlik TTL’yi varsayılan olarak yalnızca Claude aboneliğinde, planınızın kullanımı içindeyken ve ana konuşma için ister. API anahtarı ya da bulut sağlayıcıda varsayılan beş dakikadır; promptCacheTtl değerini 1h yapmadıkça idle compaction çalışmaz. Planınızın limitini aşıp ek kullanım kredisine geçtiğinizde de ana konuşma beş dakikaya düşer.
Nasıl kapatılır?
Birini seçin:
- Ayar dosyası:
~/.claude/settings.jsondosyasına"idleCompaction": falseekleyin. Yalnızca bir repoda kapatmak için o projenin ayar dosyasına yazın. /config: Idle compaction satırını değiştirin. Kullanıcı ayarlarınıza kaydedilir ve hemen geçerli olur (v2.1.302 ve sonrası).- Ortam değişkeni:
DISABLE_AUTO_COMPACT=1otomatik sıkıştırmayla birlikte idle compaction’ı da kapatır. Elle/compactçalışmaya devam eder.
{
"idleCompaction": false
}/config bu satırı göstermiyorsa anahtarı büyük ihtimalle başka bir ayar kaynağı belirliyor: yönetilen ayarlar, proje dosyası ya da --settings. Değişikliği orada yapın.
Eşik nasıl ayarlanır?
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS, idle compaction’ın devreye girmesi için konuşmanın ne kadar büyük olması gerektiğini belirler. 100.000’in altındaki değerler 100.000’e yükseltilir.
Burada bilinmesi gereken bir ayrıntı var. 200K bağlam pencereli bir modelde otomatik sıkıştırma konuşma 200.000 tokena ulaşmadan çalışır; yani varsayılan eşikte idle compaction çoğunlukla 1M bağlamlı oturumları etkiler. 200K pencereli konuşmaları da kapsamak için eşiği düşürün:
{
"env": {
"CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS": "150000"
}
}Sıkıştırmadan sonra ne kalır?
Sıkıştırma mesaj geçmişini bir özetle değiştirir, ama her şey kaybolmaz. Proje kökündeki CLAUDE.md ve otomatik bellek diskten yeniden eklenir, plan modundaki plan geri gelir ve Claude Code okuduğu ya da düzenlediği dosyalardan en son değişen beşini yeniden okur. Arka plandaki komutlar ve alt ajanlar çalışmaya devam eder. Giden şey ayrıntıdır: tam araç çıktıları, uzun akıl yürütmeler, bir karara götüren konuşma. Neyin kaldığını Claude Code bağlam yönetimi rehberimizde daha ayrıntılı anlattık.
Kural basit: bir işi bitirdiyseniz idle compaction para kazandırır ve fark etmezsiniz bile. İnce bir işin ortasında bıraktıysanız ve Claude’un her adımı hatırlamasını istiyorsanız o projede kapatın ya da bir saat dolmadan dönün.
Birden fazla ajan çalıştırırken ne demek?
Idle compaction tek bir oturumun başından kalkan tek bir kişi düşünülerek tasarlanmış. Paralel çalışan birkaç ajanda tablo değişiyor:
- Her oturum ayrı değerlendirilir. Farklı klasörlerdeki oturumlar farklı önbellek önekleri kurar; ayrı git worktree’lerindeki ajanlar asla aynı önbelleği paylaşmaz. Eşiği geçip bir saat kadar boşta kalan her biri bağımsız olarak sıkıştırılır.
- Bekleyen ajan, boştaki ajandır. Turunu bitirip incelemenizi ya da bir sorusuna cevabınızı bekleyen ajan boşta sayılır. Öğle arasından sonra dördüncü panele geldiğinizde o ajan çoktan bir özetle çalışıyor olabilir. “Tamam, gönder” için sorun değil; “daha önce elediğin yaklaşıma geri dön” için o kadar iyi değil.
- Alt ajanlar ve takım arkadaşları hedef değil. Varsayılan olarak beş dakikalık önbellek grubundalar. Idle compaction ana konuşmalarınızla ilgili.
- Başsız çalıştırmalar kapsam dışı.
-pçalıştırmaları ve Agent SDK oturumları koşulların dışında kalır; bunlara dayanan gece işleri eskisi gibi davranır. Etkileşimli gece işleri için Claude Code’u gece güvenle çalıştırma rehberine bakın. - Bilgisayar uyanık kalmalı. Makine uyursa bir saat sıkıştırma olmadan geçer ve yine önbelleksiz yeniden okumanın bedelini ödersiniz.
Pratik bir düzen: idle compaction’ı varsayılan olarak açık bırakın, ajanın iş ortasında sizi beklediği bir iki repoda kapatın ve soru soran ajanlara bir saat dolmadan cevap vermeye çalışın.
AgentVera bunun neresinde?
AgentVera’yı biz geliştiriyoruz: Claude Code, Codex ve 16 kodlama ajanını daha yan yana, her birini kendi kurulumunuz ve hesabınızla gerçek bir terminalde çalıştıran macOS, Windows ve Linux masaüstü uygulaması. Bazı parçaları idle compaction ile örtüşüyor:
- Token tasarrufu: otomatik sıkıştırma her ajan için varsayılan olarak 150K token eşiğinde açık, her CLI’ın kendi sıkıştırma komutunu kullanıyor ve her panel canlı bağlam boyutunu gösteriyor. Bir saatten uzun boşta kalmış bir ajana gönderilen mesaj önce büyük konuşmayı sıkıştırıyor; bu, kendi idle compaction’ı olmayan ajanları da kapsıyor.
- Bildirimler: bir ajan işini bitirdiğinde ya da girdi beklediğinde haber alırsınız; böylece daha az ajan bir saati aşarak bekler.
- Token bütçeleri ve kullanım limitleri: ajan başına sınır, durum çubuğunda da her Claude ve Codex hesabının 5 saatlik ve haftalık kullanımı.
Ücretsiz plan 18 ajana kadar, MCP, Git, Docker, SSH ve kod incelemesini içerir. Bu alandaki araçların daha geniş bir karşılaştırması için Claude Code ve Codex’i paralel çalıştırma araçları yazımıza bakın.
Özetle
Idle compaction amacı net, küçük bir varsayılan: uzun bir konuşmayı önbellek hâlâ sıcakken özetlemek ki dönüşünüz önbelleksiz tam bir yeniden okumaya mal olmasın. Etkileşimli bir oturum, bir saatlik önbellek ve yeterince büyük bir bağlam ister. Eşiği CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS ile düşürebilir, "idleCompaction": false ya da /config ile kapatabilirsiniz. Birkaç ajan aynı anda sizi beklerken özetin yeterli olup olmadığına proje proje karar verin ve tam bağlama ihtiyacı olanlara önce cevap verin.
Kaynaklar: Claude Code değişiklik günlüğü, ayarlar başvurusunda idleCompaction, How Claude Code uses prompt caching ve Explore the context window.