Claude Code 2.1.296, allow_large ile Read'e büyük dosyaları tek çağrıda yükleme imkânı ekliyor

2.1.296'da ne değişti

Anthropic, 9 Ekim 2026'da Claude Code v2.1.296'yı yayınladı ve bu sürüm Read aracına isteğe bağlı bir allow_large girdisi ekledi. Resmî değişiklik günlüğüne ve bir dev.to rehberinde aktarıldığı üzere araçlar referansına göre, bu seçeneğin true olarak ayarlanması Claude'un tüm bir metin dosyasını ya da çok uzun bir satır aralığını tek bir çağrıda isteyebilmesini sağlıyor. Bu okumanın boyutu, aracın olağan varsayılanlarına göre değil, oturumun context penceresinde kalan boşluğa göre ölçülüyor.

İki sınır geçerli. Seçenek yalnızca v2.1.296 ve sonraki sürümlerde mevcut, yani eski kurulumlarda bulunmuyor. Ve yalnızca metin dosyalarını kapsıyor — PDF'ler, görseller ve notebook'lar kendi ayrı limitlerini koruyor.

Aşılıp geçilen varsayılanlar

Dokunulmadığında, tek bir Read çağrısı en fazla 25.000 token döndürüyor; bu rakam CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS ortam değişkeniyle ayarlanabiliyor ve 256 KB üzerindeki herhangi bir dosyanın tamamının okunması ise doğrudan reddediliyor. Bu limitler devreye girdiğinde Claude'un gerçekte aldığı şey, okumanın nasıl çerçevelendiğine bağlı. Token sınırını aşan bir tüm dosya isteği yalnızca ilk sayfayı döndürüyor; yanına neyin geldiğini ve offset ve limit ile nasıl daha fazlasının alınabileceğini açıklayan bir PARTIAL görünüm bildirimi eşlik ediyor. 256 KB üzerindeki bir dosya ya da yine sınırı aşan aralıklı bir okuma, Claude'u daha küçük bir aralığa ya da aramaya yönlendiren bir hata üretiyor.

dev.to rehberi, bir Claude Code docs issue'sına dayanarak, PARTIAL davranışının v2.1.145 civarında geldiğini belirtiyor. Ondan önce, fazla büyük bir okuma basitçe "file content exceeds maximum allowed tokens" hatasıyla başarısız oluyordu; bu mesaj eski eğitimlerde hâlâ dolaşıyor.

Belirtilmesi值得 olan tekrarlayan bir karışıklık var: MAX_MCP_OUTPUT_TOKENS yalnızca MCP sunucularının çıktısını yönetir ve yerleşik Read aracı üzerinde hiçbir etkisi yoktur. Mart 2026 tarihli bir GitHub issue'su ayrıca masaüstü uygulamasının Read'i 10.000 token ile sınırladığını, buna karşılık CLI'nın 25.000'e izin verdiğini iddia etti; ancak resmî referans yüzeye göre bir fark belgelemiyor, dolayısıyla bu doğrulanmamış bir kullanıcı raporu olarak kalıyor.

Bayrağı siz değil Claude ayarlıyor

Allow_large'ı açan belgelenmiş bir komut satırı bayrağı ya da ayar anahtarı yok. Dokümantasyon, Claude'un bunu bir görev gerçekten dosyanın tamamını gerektirdiğinde — örneğin kullanıcı her şeyi istediğinde — kendisinin etkinleştirdiğini anlatıyor. Rehbere göre pratikte bu, niyeti prompt'ta açıkça belirtmek anlamına geliyor — tüm dosyanın hiçbir şey atlanmadan tek çağrıda okunması gerektiğini söylemek. Tüm dosya okumalarını zorunlu kılmaya dair uzun bir GitHub issue'su, kullanıcıların yalnızca birkaç yüz satırlık dosyalarda bile kısmi sonuçlar aldığını; düz ve açık talimatların sorunu çoğu zaman çözdüğünü, buna karşılık CLAUDE.md yönlendirmesinin güvenilmez olduğunu kaydediyor. Bazı yorumcular minified CLI'ya yama yapma yoluna gitti; bu desteklenmeyen bir yaklaşım ve her güncellemede bozuluyor.

Bağımsız bir test ne buldu

Classmethod'un geliştirici blogu, yaklaşık 204 KB'lık ve 3.000 satırlık bir metin dosyasıyla v2.1.296'ya karşı uygulamalı bir test yaptı. Varsayılan bir Read 3.001 satırın 732'sini döndürdü ve token sınırı kesintisini işaretledi. Prompt tüm dosyanın gerektiğini belirttiğinde, Claude kendi kendine allow_large'ı true olarak ayarladı ve 3.001 satırın tamamını tek bir çağrıda aldı; yazar aynı davranışı hem Opus 5.5 hem de Haiku 5.5 üzerinde bildiriyor.

Uyarıları belirtmekte fayda var: bu tek bir yazarın sonucu ve dosya 256 KB tavanının altındaydı, yani yalnızca token sınırı devredeydi. Yazar ayrıca, o tek turluk testte tam okumanın kesik olanından biraz daha ucuza mal olduğunu gözlemledi — bu karşılaştırma genellenemez, çünkü gerçek bir oturumda yüklenen dosya sonraki her turda context'i işgal etmeye devam eder.

Ne zaman başka bir şey kullanmalı

Uzun bir dosyanın belirli bir bölümü için offset ve limit doğru araçlar olmaya devam ediyor ve tüm dosya varsayılanları aşacak olsa bile çalışıyorlar. Büyük loglar içinse yüklemek yerine aramak daha iyi: 400 KB'lık bir log, 256 KB'lık tüm dosya limitini aşıyor ve token başına kabaca dört karakterle yaklaşık 100.000 token tutuyor — çoğu oturumun harcaması gerekenin ötesinde. macOS, Linux ve WSL'de özel Grep aracı varsayılan olarak bulunmuyor, dolayısıyla Claude aramayı Bash üzerinden grep ve find ile yapıyor; Bash üzerinden okumak da bir bypass değil, çünkü daha uzun çıktılar bir dosyaya kaydedilmeden önce kabaca 30.000 karakter satır içinde döndürülüyor. PDF'ler kendi sayfalamasını koruyor ve bir seferde en fazla 20 sayfalık aralıklarla okunuyor. Allow_large ile tüm dosya okumaları, her satırın önemli olduğu ve içeriğin kalan context'e rahatça sığdığı üretilmiş kod, şemalar ya da yapılandırma dosyaları için en çok anlam ifade ediyor.

Neden önemli

Claude Code'u üretilmiş koda, build loglarına ya da büyük yapılandırma dosyalarına yönelten herkes muhtemelen sessiz kesintiyle karşılaşmıştır: okuma başarılı görünürken yalnızca dosyanın açılış satırlarını kapsar. Allow_large seçeneği, dosyanın tamamının gerçekten context'e ait olduğu durumlar için bu belirsizliği ortadan kaldırıyor ve PARTIAL bildirimleri ait olmadığında limitleri görünür kılıyor. Context penceresi gerçek tavan olmaya devam ediyor — allow_large ile bir okuma için belgelenmiş sabit bir üst sınır yok, bu yüzden kalan context'ten büyük bir dosya hâlâ sığamaz. Pratik beceri artık ne zaman her şeyin isteneceğini ve ne zaman offset, limit ya da bir aramanın daha ucuz ve daha hızlı bir seçim olduğunu bilmek.