Claude Code Önbellek İsabet Oranı
2026-11-03 haftasında Claude modelleriyle Claude Code, devam eden konuşmalarda %98.1 medyan önbellek isabet oranına (343 kullanıcı), tüm isteklerde ise %94.6 oranına ulaştı. Iskalamaların çoğu şunlardan kaynaklandı: önbellek süresinin dolması (%37), devam eden turlardaki yeni içerik (%23), yeni konuşmalar (%17).
2026-11-03 – 2026-11-09 haftası (UTC)
Öne çıkanlar
- Normal değer: 98.1%, devam eden konuşmalarda 343 kullanıcının medyanı; ortadaki yarı %96.9–%98.8
- Tüm istekler: 94.6%, yönlendirme, süre dolması ve yeni sohbetler dahil
- En büyük ıskalama nedeni: önbellek süresinin dolması, ıskalamalar içindeki pay: %37
- Arayüzler arasında: 1.7 puan fark, CLI (terminal), Masaüstü uygulaması, Masaüstü yerel agent
Her istemci için normal önbellek isabet oranı nedir
2026-11-03 – 2026-11-09 haftası (UTC)
- Devam eden konuşmalarda isabet oranı (kullanıcı medyanı): 98.1%
- Kullanıcıların ortadaki yarısı: 96.9%–98.8%
- Koşulu sağlayan kullanıcılar: 343 (haftada en az 20 devam turu)
- Tüm isteklerde isabet oranı: 94.6%
Arayüze göre Claude Code isabet oranı
Bir istemcinin CLI’ı, IDE eklentisi ve masaüstü uygulaması neredeyse aynı istekleri gönderir; bu yüzden isabet oranları birbirine yakın olmalıdır.
- CLI (terminal): 98.2% (147)
- Masaüstü uygulaması: 98.4% (114)
- Masaüstü yerel agent: 98.0% (78)
- VS Code eklentisi: 97.8% (50)
- Agent SDK (CLI): 96.7% (43)
- Agent SDK (TypeScript): 97.8% (16)
- t3-code: 97.9% (5)
Sürüme göre Claude Code isabet oranı
İstek önekini değiştiren bir sürüm, daha yayımlandığı hafta diğerlerinden belirgin biçimde düşük bir isabet oranı gösterir.
- 2.1.321: 97.6% (5)
- 2.1.319: 98.4% (77)
- 2.1.318: 98.3% (92)
- 2.1.317: 97.9% (133)
- 2.1.316: 98.4% (44)
- 2.1.314: 98.5% (25)
- 2.1.312: 98.0% (20)
- 2.1.311: 98.4% (13)
- 2.1.310: 97.4% (14)
- 2.1.309: 98.3% (98)
- 2.1.308: 98.0% (30)
- 2.1.302: 96.4% (7)
- 2.1.299: 97.6% (6)
- 2.1.296: 98.0% (8)
- 2.1.295: 97.6% (14)
- 2.1.292: 99.0% (5)
- 2.1.284: 97.0% (6)
- 2.1.280: 98.2% (11)
Haftalık medyan
- 2026-09-29: 96.8% (120 kullanıcı)
- 2026-10-06: 97.8% (220 kullanıcı)
- 2026-10-13: 98.0% (256 kullanıcı)
- 2026-10-20: 98.0% (250 kullanıcı)
- 2026-10-27: 98.0% (259 kullanıcı)
- 2026-11-03: 98.1% (343 kullanıcı)
Claude Code önbellek isabet oranım neden düşük? Nedenlerine göre ıskalamalar
Bu haftaki girdinin %5.4 oranındaki bölümü önbellekten okunmadı. Aşağıda nedenlerine göre dökümü ve her biri için yapabilecekleriniz yer alıyor.
- 5 dakikadan uzun ara, önbelleğin süresi doldu: ıskalamalar içindeki pay: %37, tüm girdinin yaklaşık %2.0 oranındaki bölümü
- Önbellek varsayılan olarak 5 dakika yaşar ve her isabet onu ücretsiz olarak yeniler. Sık sık daha uzun ara veriyorsanız CLAUDE_CODE_PROMPT_CACHE_TTL=1h ayarlayın (v2.1.242+); o zaman önbellek yazma, girdi fiyatının 1.25 katı yerine 2 katına mal olur.
- Devam eden konuşmada yeni içerik ve önek değişiklikleri: ıskalamalar içindeki pay: %23, tüm girdinin yaklaşık %1.2 oranındaki bölümü
- Bir turda yeni olan içerik yalnızca yazılabilir, okunamaz. MCP sunucusu bağlamak veya kaldırmak ya da MCP sunucusu getiren eklentileri etkinleştirmek araç tanımlarını değiştirir ve önbelleği geçersiz kılar.
- Yeni konuşma veya bir saatten uzun süre boşta: ıskalamalar içindeki pay: %17, tüm girdinin yaklaşık %0.9 oranındaki bölümü
- Yeni bir konuşmanın ilk isteği veya bir saat boşta kaldıktan sonraki istek önbelleği yeniden yazmak zorundadır.
- Model değiştirildi: ıskalamalar içindeki pay: %12, tüm girdinin yaklaşık %0.6 oranındaki bölümü
- Her modelin kendi önbelleği vardır. /model komutundan sonraki istek, içerik aynı olsa bile tüm geçmişi hiç önbellek isabeti olmadan okur.
- Paralel istek (önceki hâlâ sürüyor): ıskalamalar içindeki pay: %10, tüm girdinin yaklaşık %0.5 oranındaki bölümü
- Alt agent’lar ve paralel araç çağrıları, önceki istek bitmeden bir sonrakini gönderir. Claude Code’daki bir fork üst oturumun önbelleğini okur; normal bir alt agent’ın ise kendi system prompt’u ve araçları vardır ve kendi önbelleğini oluşturur.
- Başka bir upstream hesabına veya endpoint’e yönlendirildi: ıskalamalar içindeki pay: %2, tüm girdinin yaklaşık %0.1 oranındaki bölümü
- Prompt önbelleği, isteği işleyen upstream hesabında durur. Bir relay veya çok hesaplı bir gateway sonraki turu başka bir hesaba gönderdiğinde tüm bağlam yeniden yazılır. Sağlayıcıya doğrudan bağlantıda bu neden hiç görülmez.
İsabet oranında birkaç puan, faturada birkaç kat fark
Claude Opus 5.5 resmi fiyatlarıyla, ıskalamalar 5 dakikalık önbelleğe yazıldığında bir milyon girdi token’ı başına efektif maliyet:
- Bu haftanın medyanı: %98.1: $0.29 (×1.0)
- 90%: $0.68 (×2.3)
- 80%: $1.16 (×4.0)
- 50%: $2.60 (×9.0)
Kendi rakamlarınızı Claude API maliyet hesaplayıcıda deneyin
Claude Code önbellek TTL’i: ne kadar yaşar ve ne kadara mal olur
- Varsayılan olarak 5 dakika yaşar ve her isabet onu ücretsiz olarak yeniler.
- CLAUDE_CODE_PROMPT_CACHE_TTL=1h ile 1 saate çıkarın (v2.1.242+; alt agent’lar için CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL), eski sürümlerde ENABLE_PROMPT_CACHING_1H=1 kullanın.
- Önbellek yazma, girdi fiyatının 1.25 katına (5 dakika) veya 2 katına (1 saat) mal olur; okuma genellikle 0.1 katı, Opus 5.5 ve Sonnet 5.5’te 0.05 katıdır.
- Asgari uzunluğun altındaki prompt’lar hata vermeden önbelleğe alınmaz: modele göre 512 ile 4,096 token arası.
Anthropic prompt caching · Claude Code prompt caching · Claude Code ortam değişkenleri
Claude Code önbellek isabet oranınızı nasıl kontrol edersiniz
- Claude Code’da /usage komutunu çalıştırın: Session bloğundaki Prompt cache (main) satırı istek sayısını, girdinin önbellekten karşılanan payını, önbellek ıskalamalarını ve önbelleğin hâlâ sıcak olup olmadığını gösterir.
- Durum satırı betikleri prompt_cache alanlarını okuyabilir; OpenTelemetry exporter’ı önbellek okuma ve oluşturma token’larını kullanıcı ve oturum bazında raporlar.
- API’den: cache_read_input_tokens ÷ (input_tokens + cache_read_input_tokens + cache_creation_input_tokens).
- Wokey’de konsoldaki istek günlüğü, her isteğin önbellek okuma ve önbellek yazma değerlerini gösterir.
Relay arkasında isabet oranı neden düşer
- Hesap değişimi: önbellek upstream hesabına aittir; bu yüzden başka bir hesaba giden tur her şeyi yeniden yazar. Relay’lerde en yaygın nedendir; doğrudan bağlantıda hiç görülmez.
- Biçim dönüşümü: Anthropic ve OpenAI biçimleri arasında çeviri yapmak öneki değiştirebilir veya cache_control breakpoint’lerini düşürebilir.
- v2.1.181 öncesi Claude Code, özel bir base URL kullanıldığında system prompt’un başındaki atıf bloğuna her istekte değişen bir token koyuyordu; bu da istek gövdesine göre önbelleğe alan gateway’leri boşa çıkarır. Güncelleyin veya CLAUDE_CODE_ATTRIBUTION_HEADER=0 ayarlayın.
- Kendiniz test edin: asgari önbellek uzunluğunun üzerinde, aynı öneke sahip iki istek gönderin; ikincisinin önbellek okuması önek uzunluğuna yakın olmalıdır.
Wokey, bir konuşmanın sonraki isteklerini mümkün olduğunca aynı upstream hesabına yönlendirir. 2026-10-04 – 2026-10-10 arasında sıradan Wokey kullanıcıları Claude Opus 5.5’te tüm istekler üzerinden %92.8 isabet oranına ulaştı; OpenRouter genelinde bu oran %87.8 oldu.
OpenRouter önbellek isabet oranlarıyla karşılaştırın · Canlı: Wokey herkese açık önbellek isabet oranı API’si (son 7 gün)
Nasıl ölçüyoruz
- Wokey gateway’inden geçen gerçek kullanıcı istekleri; her pazartesi 05:00 UTC’de bir önceki haftayı (pazartesiden pazara) hesaplıyoruz.
- İstemciler, isteğin User-Agent değerinden tanınır. Gerçek istemcisi bilinmeyen SDK, HTTP kütüphanesi ve alt relay istekleri ile kurumsal hesaplar kapsam dışındadır.
- Devam turu, konuşmasındaki önceki istekle aynı modele ve aynı upstream hesabına sahiptir ve o istek bittikten sonraki 5 dakika içinde başlar. Her kullanıcının oranı, bu turlardaki önbellek okuma ÷ girdidir (girdi, önbellek okuma ve yazmayı içerir); haftada en az 20 böyle turu olan kullanıcıların medyanını yayımlıyoruz.
- Bir hücre, koşulu sağlayan en az 5 kullanıcı olduğunda yayımlanır; geçen haftaya göre 3 puandan fazla değişim önce elle kontrol edilir.
- Bilinen sapmalar: yalnızca Wokey kullanıcıları; kullanım alışkanlıkları çok farklıdır; tüm istekler üzerindeki oran, gateway’in kendi yönlendirme kaybını da içerir (“başka bir upstream hesabına yönlendirildi” nedeni).
Sık sorulan sorular
Claude Code için normal önbellek isabet oranı nedir?
Bu hafta 343 kullanıcının devam eden konuşmalardaki medyanı %98.1 oldu; ortadaki yarı %96.9 ile %98.8 arasındaydı. Tüm isteklerde oran %94.6 oldu.
Claude Code önbellek isabet oranım neden düşük?
Bu hafta ıskalamaların çoğu şunlardan kaynaklandı: önbellek süresinin dolması (%37), devam eden turlardaki yeni içerik (%23), yeni konuşmalar (%17). Sayfada her neden için neler yapabileceğiniz yer alıyor.
Düşük önbellek isabet oranı Claude plan limitimi daha hızlı tüketir mi?
Evet. Claude plan limitlerine ilişkin ölçümlerimizde önbellek okuma limitten neredeyse hiç yemezken, önbellek yazma yaklaşık olarak önbelleksiz girdi gibi sayılıyor. Önbellekteki bir bağlam neredeyse hiçbir şeye mal olmaz; ıskalanan bağlam ise yeniden tam olarak sayılır. Plan bazında limitler Claude kullanım limitleri sayfasında (/claude-usage-limits).
Claude Code’da cache read tokens nedir?
Girdinin önbellekten karşılanan kısmıdır; cache_read_input_tokens olarak raporlanır. Uzun oturumlarda genellikle girdinin %90’ından fazlasıdır ve girdi fiyatının 0.1 katından faturalanır (Opus 5.5 ve Sonnet 5.5’te 0.05 katı); cache_creation_input_tokens ise bu isteğin önbelleğe yeni yazdığı kısımdır.
1 saatlik önbellek değer mi?
Genellikle hayır. Wokey’deki gerçek Claude trafiğinin bir günü yeniden hesaplandığında, her şeyi 1 saatlik önbelleğe geçirmek toplam harcamayı net olarak yaklaşık %15–25 artırıyor: yazma, girdi fiyatının 1.25 katından 2 katına çıkıyor ve bu, daha az süre dolmasının sağladığı tasarruftan fazlaya mal oluyor. Yalnızca uzun bağlam ve sık sık 5–60 dakikalık aralar söz konusuysa kârlı olabilir.
Claude Code önbelleği ne kadar yaşar?
Varsayılan olarak beş dakika; her isabette ücretsiz yenilenir. CLAUDE_CODE_PROMPT_CACHE_TTL=1h (v2.1.242+) bunu bir saate çıkarır; önbellek yazma o zaman girdi fiyatının 1.25 katı yerine 2 katına mal olur.
Model değiştirmek veya alt agent’lar önbelleği bozar mı?
Evet. Her modelin kendi önbelleği vardır; bu yüzden /model sonrasındaki istek her şeyi yeniden okur. Normal bir alt agent’ın kendi system prompt’u ve araçları vardır ve kendi önbelleğini oluşturur; fork ise üst oturumun önbelleğini yeniden kullanır.
Cache creation neden bu kadar pahalı?
Önbellek yazma, girdi fiyatının 1.25 katına (5 dakika) veya 2 katına (1 saat) mal olur. Uzun bir konuşmanın ilk isteği ile hesap değişimi veya süre dolması sonrasındaki her istek tüm bağlamı bir kez yazar ve normal bir turdan belirgin biçimde pahalıya gelir.
Claude Code bir relay üzerinden çalışırken önbellek işler mi?
Evet; relay cache_control alanını olduğu gibi iletiyor ve bir konuşmayı tek bir upstream hesabında tutuyorsa. Özel base URL kullanan v2.1.181 öncesi sürümlerin güncellenmesi veya CLAUDE_CODE_ATTRIBUTION_HEADER=0 ayarlanması gerekir.