Claude Code'de Auto Compact nedir?

Claude Code, bir kod tabanını okuyabilen, dosyaları düzenleyebilen, komutlar çalıştırabilen ve terminal, IDE, masaüstü uygulaması ve tarayıcı iş akışları genelinde araçlarla entegre olabilen, Anthropic’in ajan tabanlı kodlama asistanıdır. Paylaşılan bir bağlam penceresi içinde çalıştığı için, uzun oturumlar sonunda sohbet geçmişi, dosya çıktıları ve araç iletileriyle dolar. Claude Code bunu, sınıra yaklaştığınızda konuşma geçmişini sıkıştırarak otomatik olarak yönetir; yalnızca sohbet geçmişinde bulunan erken talimatlar ise kaybolabilir.

Bu, 2026’da daha da önemli hale geliyor; çünkü Anthropic, Claude Code’u daha uzun ve daha otonom çalışmaya doğru itmeye devam ediyor. 25 Mart 2026’da Anthropic, “Claude Code auto mode: a safer way to skip permissions” başlıklı yazıyı yayımladı, kullanıcıların izin istemlerinin %93’ünü onayladığını belirtti ve “auto mode”u, manuel onay ile güvensiz izin atlama arasında, sınıflandırıcı temelli bir orta yol olarak tanımladı. 5 Şubat 2026’da Anthropic, daha güçlü kodlama, daha iyi hata ayıklama ve daha uzun ajan oturumlarıyla öne çıkan Claude Opus 4.6’yı da tanıttı. Bu güncellemeler auto compact ile aynı şey değildir, ancak ürün yönünü açıkça gösterir: daha az kesinti, daha uzun oturumlar ve daha güvenilir süreklilik.

CometAPI, şu anda resmi API’den daha düşük bir fiyatla Claude API erişimi sunuyor; örneğin Claude Sonnet 4.6, Claude Opus 4.6 ve Claude 5.

Claude Code’da auto-compact gerçekte ne anlama geliyor

Auto Compact, Claude Code’da (Anthropic’in CLI/masaüstü aracı) ve daha geniş Claude API ekosisteminde yerleşik bir bağlam optimizasyon mekanizmasıdır. Konuşmanız modelin bağlam penceresinin tavanına yaklaştığında—genellikle Claude Opus 4 veya Sonnet 4 gibi amiral gemisi modellerde 200.000 token civarı—otomatik olarak devreye girer. Hook dokümantasyonu açık: PreCompact, bir sıkıştırma işlemi başlamadan önce tetiklenir ve auto eşleyicisi “bağlam penceresi dolduğunda otomatik sıkıştırma” anlamına gelir. Eşleşen PostCompact hook’u, sıkıştırma tamamlandıktan sonra tetiklenir ve oluşturulan compact_summary’yi alır.

Bu önemlidir; çünkü sıkıştırma “hafıza” ile aynı şey değildir. Auto memory, Claude’un kendi not alma sistemiyken, sıkıştırma canlı konuşma durumunu sıkıştıran bir oturum yönetimi mekanizmasıdır. Hafıza dokümanları, CLAUDE.md’nin kalıcı olduğunu, auto memory’nin Claude tarafından yazıldığını ve sıkıştırmanın, modelin çalışmaya devam edebilmesi için oturumun konuşma geçmişinin azaltıldığı an olduğunu açıkça belirtir.

Yeni bir sohbet başlatmaya (ve geçmişi kaybetmeye) zorlamak veya modelin kritik ayrıntıları “unutmasına” izin vermek yerine Auto Compact:

1. Tüm geçmişi analiz eder — korunmaya değer çekirdek unsurları belirler.
2. Kısa bir özet üretir — alınan kararlar, kod mimarisi, çözülen hatalar, dosya durumları ve sonraki adımlar.
3. Eski iletileri değiştirir — bu özetle (API terminolojisinde bir “sıkıştırma bloğu”).
4. Kaldığı yerden sorunsuz devam eder — korunmuş bağlamla.

Önemli Veriler (2026):

• Tetikleme eşiği: Varsayılan ~%95 kapasite (veya %25 kalan). Bazı kullanıcılar, sıkıştırma işleminin kendisi için 20–45 bin token (%22,5 bağlam) ayıran dahili bir tampondan söz ediyor.
• Performans iyileştirmesi: Claude Code v2.0.64’ten beri, sıkıştırma “anlık” hale geldi; dakikalar sürmüyor.
• Token tasarrufu örneği (Claude Agent SDK kıyaslarından): 5 görevli bir iş akışında, iki sıkıştırma ile giriş token’ları 204 bin’den 82 bine düştü (%58,6 azalma).

Auto Compact, /clear (her şeyi siler) veya basit kesme ile aynı değildir. Önemli olanları akıllıca korur—son kod farkları, mimari seçimler, adlandırma kuralları—ve çözümlenmiş hata ayıklama döngülerini ve keşif amaçlı sapmaları yoğun şekilde kısaltır.

Neden Claude Code’da Auto Compact kullanmalısınız?

Uzun kodlama oturumları artık norm. Tek bir özellik uygulaması 50+ tur sürebilir: planlama, hata ayıklama, yeniden düzenleme, test. Sıkıştırma olmadan, token kullanımı doğrusal biçimde artar, yanıt kalitesi düşer ve maliyetler fırlar.

Geliştiriciler için getirisi, daha az yeniden başlatma yorgunluğudur. Özeti manuel olarak yeni bir oturuma kopyalamak yerine, Claude’un oturumu sıkıştırmasına izin verir ve devam edersiniz. Bu özellikle, hata düzeltme, çok dosyalı yeniden düzenlemeler, test odaklı değişikler ve inceleme ağırlıklı iş akışlarında sohbetin çok uzadığı senaryolarda kullanışlıdır. Claude Code oturumları taze bir bağlam penceresiyle başlar, bu yüzden sıkıştırma uzun soluklu çalışmayı pratik kılan temel mekanizmalardan biridir.

Temel Faydalar

• Sınırsız oturum uzunluğu: Sıfırdan başlamadan süresiz devam edin.
• Maliyet ve performans verimliliği: Giriş token’larını dramatik biçimde azaltır. Gerçek dünyada çok aşamalı iş akışlarında %50–60 tasarruf raporlanıyor.
• Daha iyi odak ve istikrar: Modelin halüsinasyon görmesine veya önceki kısıtları unutmasına yol açan “bağlam aşırı yüklenmesini” önler.
• Kurumsal bilgi korunumu: Yüzlerce mesaj sonra bile kilit kararlar bağlamda kalır.
• Ajan iş akışları için sorunsuz: Claude Code’da araçlar, MCP sunucuları veya çoklu ajan düzenekleriyle çalışırken kritiktir.

Auto Compact’a ne zaman güvenmelisiniz?

Görev doğal olarak uzun soluklu olduğunda kullanın: çok dosyalı yeniden düzenlemeler, günlükler ve kaynak kod arasında gidip gelen hata ayıklama, tekrar tekrar doğrulama gerektiren özellik geliştirmeleri veya çok sayıda araç çağrısı gerektiren araştırma. Anthropic dokümantasyonu, bağlam penceresinin alakasız sohbet, dosya içerikleri ve komutlarla dolduğu uzun oturumları açıkça işaret eder ve auto compaction’ın ana kodu ve kararları korurken alan açtığını söyler.

Görev kısa, izole veya talimatların kesin ve kalıcı olarak tutulması gerekiyorsa daha az uygundur. Oturum sıkıştırmasından sonra konuşmanın başındaki talimatların kaybolabileceğini unutmayın; bu yüzden proje kuralları CLAUDE.md’de yer almalı, ileride sıkıştırılabilecek geçici bir yanıta bırakılmamalıdır.

Ne zaman kullanmalı (veya etkin bırakmalı):

• Çoğu kullanıcı için varsayılan olarak açık — günlük kodlama, büyük refaktörler veya keşif projeleri için ideal.
• Uzun soluklu görevler — işlem kuyrukları, veri boru hatları veya çok dosyalı kod tabanları.
• Takım/kurumsal ortamlar — oturumlar arası bağlam sürekliliğinin önemli olduğu yerler.
• Yüksek riskli projeler — tek bir mimari kararın kaybının saatlere mal olabileceği durumlar.

Ne zaman devre dışı bırakmayı düşünmeli ( /config ile):

• Ultra hassas kontrol için bağlamın her bir token’ını istiyorsunuz.
• Tamamen manuel yönetimi tercih ediyorsunuz (planları dosyalarla kaydedip/geri yükleyen ileri düzey kullanıcılar).

Son gelişmeler (2025–2026): Mart 2025’te Anthropic, Auto Compact’ın koruma mantığını geliştirdi; özetler, “önemli bilgiyi korurken token kullanımını azaltmada” daha akıllı hale geldi. 2025 sonlarında, başarısız sıkıştırmaları önlemek için tetikleme daha erken (bazen %64–75 kullanımda) olacak şekilde rafine edildi. 2026 başında web/masaüstü arayüzlerinde geçici hatalar görüldü (Ocak ortasında düzeltildi ancak münferit raporlar sürdü), CLI ise stabildi. Sürüm 2.0.64 (Şubat 2026), sıkıştırmayı anlık hale getirdi—geliştirici deneyimi için büyük bir kazanım.

Claude Code’da Auto Compact nasıl kullanılır: Adım adım rehber

Claude Code, her oturumun taze bir bağlam penceresiyle başlaması için tasarlanmıştır. Bu, her yeni görevin temiz bir başlangıç yapmasını sağlar ve bir oturumun gürültülü hale geldiğini fark etmeyi kolaylaştırır. İlişkisiz görevler arasında /clear kullanmanızı öneririz, böylece bayat bağlam yer kaplamaya devam etmez.

Adım 1: Mevcut bağlam durumunu kontrol edin

Geçerli bağlam yükünü görselleştirmek için /context kullanın. Claude Code’un yerleşik komut listesi, /context’in renkli bir ızgara gösterdiğini ve hafıza şişmesi, optimizasyon önerileri ve kapasite uyarılarını vurguladığını söyler. Bu, auto compact’ın ne zaman devreye gireceğini anlamanın en hızlı yoludur.

Claude Code oturumunuzda şunu yazın:

/context

Bu, “Auto-compact’a kadar kalan bağlam: XX%” gösterimini sunar—gerçek zamanlı ilerleme çubuğunuz.

Adım 2: Auto-Compact’ı yapılandırın (Opsiyonel)

Bağlam penceresi dolduğunda, Claude Code konuşmayı otomatik olarak sıkıştırır. Hook referansı bu olayı auto olarak etiketler ve bağlam penceresi dolduğunda tetiklendiğini belirtir. Pratikte, auto compact’ı “açmak” yerine, gerektiğinde Claude Code’un çalışmasına izin verirsiniz.

/config

“Auto-compact enabled” bölümüne gidin ve açık/kapalı durumunu değiştirin. Varsayılan açıktır. Ayrıca MCP sunucusu kullanımı gibi ilişkili ayarları, proaktif olarak token boşaltmak için ayarlayabilirsiniz.

Adım 3: Auto-Compact’ın otomatik çalışmasına izin verin

~%95’e ulaştığınızda:

• Claude “Konuşmayı sıkıştırıyorum, böylece devam edebilelim…” (veya benzeri) bir mesaj gösterir.
• Arka planda çalışır ve devam eder.
• Yeni özeti bağlamın en üstünde görürsünüz.

İpucu: %0’ı beklemeyin. Daha iyi sonuçlar için daha erken manuel sıkıştırma yapın (aşağıdaki en iyi uygulamalara bakın).

Adım 4: Sıkıştırma etrafında ne olacağını otomatikleştirmek isterseniz hook’ları kullanın

Claude Code hem PreCompact hem de PostCompact hook’larını sunar. Hook referansı, PreCompact’ın sıkıştırmanın manuel mi otomatik mi olduğunu tespit edebildiğini ve PostCompact’ın oluşturulan compact_summary’yi aldığını gösterir. Bu da hook’ları, günlükleme, denetim izleri, sıkıştırma sonrası notlar veya harici otomasyon için çok uygun kılar.

Basit bir hook deseni şöyle görünür:

{  "hooks": {    "PostCompact": [      {        "matcher": "auto",        "hooks": [          {            "type": "command",            "command": "./scripts/save-compact-summary.sh"          }        ]      }    ]  }}

Ve eşleşen shell betiği, komut hook’larının JSON’u stdin’den aldığı için JSON girdisini stdin’den okuyabilir:

#!/usr/bin/env bashset -euo pipefailjq -r '.compact_summary // empty' \  | sed 's/^/[compact] /' \  >> .claude/compact-log.txt

Dokümanlar, komut hook’larının JSON’u stdin üzerinden aldığını ve PostCompact’ın compact_summary içerdiğini doğrular; bu nedenle bu desen mevcut hook modeline uygundur.

Adım 5: Hassas manuel sıkıştırma (Önerilir)

Konuyu hemen şimdi sıkıştırmasını istediğinizde /compact kullanın. Korunacak özeti şekillendiren talimatlar ekleyebilirsiniz. Anthropic’in yerleşik komutlar sayfası /compact [instructions] komutunu “İsteğe bağlı odak talimatlarıyla konuşmayı sıkıştır” olarak listeler,

/compact keep the auth flow decisions, the current test plan, and the open TODOs

Bu desen, bir devir teslimden hemen önce, dal değişiminden önce veya Claude’dan çalışmanın yeni bir fazına başlamasını istemeden önce faydalıdır.

Gerçek kullanımdan örnekler:

• Hata ayıklamadan sonra: /compact bulduğumuz çözümü koru, hata ayıklama adımlarını çıkar
• Proje kilometre taşı: /compact yeni özellik gereksinimlerine odaklan

API düzeyinde sıkıştırma (İleri seviye – Python SDK & Messages API)

Özel ajanlar veya betikler için resmi sıkıştırma araçlarını kullanın.

Claude Agent Python SDK örneği (araç kullanan iş akışları için otomatik):

from anthropic import Anthropic

client = Anthropic()

runner = client.beta.messages.tool_runner(
    model="claude-opus-4-6",
    max_tokens=4096,
    tools=your_tools,
    messages=messages,
    compaction_control={
        "enabled": True,
        "context_token_threshold": 100000,  # or lower for aggressive compaction
        "model": "claude-haiku-4-5",        # cheaper summarizer
        "summary_prompt": """Create a focused summary preserving:
1. COMPLETED TASKS and key outcomes
2. CURRENT STATE and open items
3. NEXT STEPS
Wrap in <summary></summary> tags."""
    }
)

Sıkıştırma olaylarını tespit edin:

if curr_msg_count < prev_msg_count:
    print(f"Compaction occurred! Messages reduced from {prev_msg_count} to {curr_msg_count}")
```<grok-card data-id="f4afb5" data-type="citation_card" data-plain-type="render_inline_citation" ></grok-card>

**Tam Messages API (beta, 2026)** – header gerektirir:
```bash
curl https://api.anthropic.com/v1/messages \
  --header "anthropic-beta: compact-2026-01-12" \
  --data '{
    "model": "claude-opus-4-6",
    "messages": [...],
    "context_management": {
      "edits": [{
        "type": "compact_20260112",
        "trigger": {"type": "input_tokens", "value": 150000},
        "pause_after_compaction": true
      }]
    }
  }'

API, sonraki çağrılarda geri iletmeniz gereken bir sıkıştırma bloğu döndürür. Özel talimatlar ve duraklama, bütçelemeyi tamamen kontrol etmenize imkan tanır (örn. oturumlar genelinde toplam 3M token sınırını zorunlu kılın).

CometAPI’nin Claude API’sini kullanıyorsanız, mesaj header’ını "https://api.cometapi.com/v1/messages\\" olarak değiştirin.

Auto-Compact vs Manuel Compact vs Clear: Karşılaştırma Tablosu

Claude Code Auto Compact için en iyi uygulamalar (Geliştirici ipuçları)

Proaktif sıkıştırın

Üçüncü kural, sıkıştırmayı baston değil “yeniden ayar” olarak kullanmaktır. Konu çıkmazlarla doluysa, Claude’dan neyin önemli olduğuna dair net talimatla sıkıştırmasını isteyin: mevcut hedef, seçilen yaklaşım, başarısız testler ve çözülmemiş sorular. Pratikte bu, sistemin körlemesine tetiklenen bir sıkıştırmaya kıyasla özeti çok daha kullanışlı kılar.

Kalıcı talimatlarınızı kısa tutun.

Anthropic, 200 satırı aşan dosyaların talimat bağlılığını düşürebileceğini söylüyor; bu yüzden büyük politika blokları genellikle kısa, iyi kapsamlı kurallardan daha kötüdür. Dosya türüne veya yola özgü davranış için .claude/rules/ kullanın ve ana talimat dosyasını şişirmeden daha zengin destekleyici ayrıntıya ihtiyaç duyduğunuzda @path içe aktarmalarını tercih edin.
Önce serbest token’lar — Sıkıştırmadan önce /mcp ile kullanılmayan MCP sunucularını veya @server-name disable ile kapatın.

CLAUDE.md ile birleştirin

CLAUDE.md’yi, uzun bir oturumda hayatta kalmasını istediğiniz her şey için tek doğruluk kaynağı olarak ele alın. /compact sonrası CLAUDE.md yeniden okunur; bu da derleme komutları, kodlama konvansiyonları ve asla kaybetmek istemediğiniz kalıcı kurallar için doğru yer olduğu anlamına gelir. Auto memory de kullanışlıdır, ancak farklı bir amaca sahip ayrı bir sistemdir.

Diğer ipuçları

/context ile izleyin — Mümkün olduğunda kullanımı %70–80’in altında tutun.

API kullanıcıları için — Eşikleri daha düşük ayarlayın (örn. 50k–100k) ve Haiku gibi daha ucuz özetleyici modeller kullanın.

Sadece gerektiğinde devre dışı bırakın — 2025 iyileştirmelerinden sonra çoğu geliştirici Auto-Compact’ı açık bırakmayı öneriyor.

Sıkıştırmayı test edin — Kendi iş akışınızın nasıl özetlendiğini görmek için önce kritik olmayan oturumlarda deneyin.

Gerçek dünya etkisi: Geliştiriciler, 2–3 kat daha uzun verimli oturumlar ve daha az “Claude ne yaptığımızı unuttu” anları bildiriyor.

Yaygın sorunlar ve sorun giderme (2026 baskısı)

• Auto-compact tetiklenmiyor: Web/masaüstü ve CLI’yi kontrol edin; bazı Ocak 2026 hataları düzeltildi ama sürümünüzü doğrulayın.
• Sıkıştırma sonrası bağlam kaybı: Bir sonraki sefer net talimatlarla manuel /compact kullanın.
• Sonsuz döngüler veya %102 kullanım: Nadir; oturumu yeniden başlatın veya son çare olarak /clear kullanın.
• Yavaş sıkıştırma: v2.0.64 öncesi bir sorun—Claude Code’u güncelleyin.
• API sıkıştırma bloğu hataları: Takip çağrılarına her zaman tam sıkıştırma içerik bloğunu ekleyin.

Sonuç

Auto compact, Claude Code’daki en önemli gizli mekanizmalardan biridir; çünkü bağlam penceresi dolduğunda her seferinde yeniden başlamak zorunda kalmadan uzun kodlama oturumlarını kullanılabilir kılar. Pratik kural basittir: taşma için auto compact’ı bırakın, kontrol istediğinizde /compact kullanın, kalıcı yönergeleri CLAUDE.md’ye koyun ve oturum yapısı değiştiğinde /clear veya /rewind kullanın. Bu birleşim, uzun Claude Code iş akışlarında süreklilik, kontrol ve hız arasında en iyi dengeyi sağlar.

Claude Code’daki Auto Compact, pratik yapay zekâ destekli geliştirmede bir sıçramayı temsil ediyor. 200 bin token’lık bağlam penceresini akıllıca yöneterek, uzun formlu kodlamadaki en büyük sürtünme noktasını ortadan kaldırır: hafızanın tükenmesi. Anlık performans (2026), zengin yapılandırma seçenekleri ve güçlü API uzantılarıyla artık her gün binlerce geliştirici tarafından kullanılan, olgun ve sahada kanıtlanmış bir özelliktir.

Bugün atılacak adımlar:

1. Claude Code’u açın ve /config çalıştırın — Auto-Compact’ın açık olduğunu doğrulayın.
2. Geçerli projenizde talimat içeren bir manuel /compact deneyin.
3. CometAPI üzerinde otomatik ajanlar için Python SDK’yı veya Messages API’yi keşfedin.