Claude Code: Response Stalled Mid-Stream

Her iki ileti de modelden gelen akışlı yanıtın tamamlanmadan durduğu anlamına gelir. “The response above may be incomplete”, yanıtın bir kısmı geldikten sonra akış durduğunda, koptuğunda veya bozulduğunda yazdırılır; Claude Code gelen kısmı korur ve continue yanıtı turu kaldığı yerden sürdürür. “Streaming response ended before any complete data was received”, hiç kullanılabilir veri gelmediği anlamına gelir; bu nedenle Claude Code aynı isteği akış olmadan yeniden dener — bu durum devam ettiğinde, iletinin kendisinin de belirttiği gibi neden genellikle Claude Code ile model sağlayıcısı arasındaki bir proxy veya ağ geçididir.

Hata

Claude Code tarafından yazdırılır

API Error: Response stalled mid-stream. The response above may be incomplete.

# the wording in Claude Code's current error reference for the same stall:
API Error: The response stopped arriving. The response above may be incomplete.

# when nothing complete arrived at all:
Streaming response ended before any complete data was received. Retrying without
streaming. If this keeps happening, check any proxy or gateway between Claude Code
and your model provider.

Nedenler ve çözümler özeti

Neden	Çözüm
Bağlantı açık kaldı ancak veri göndermeyi durdurdu; Claude Code'un akış boşta bekleme bekçisi bağlantıyı iptal etti	continue yanıtını verin. Bağlantınızda uzun duraklamalar meşruysa bekçiyi kapatmak yerine CLAUDE_STREAM_IDLE_TIMEOUT_MS değerini artırın.
Bağlantı koptu, bilgisayar uykuya geçti veya sunucu yanıtın ortasında hata döndürdü	continue yanıtını verin; yanıtın tamamlanan kısmı korunur. Tekrarlanıyorsa VPN'i, Wi-Fi geçişlerini ve uyku ayarlarını kontrol edin.
Aradaki bir proxy veya ağ geçidi akışı tamponladı, kesti veya reddetti — örneğin istek gövdesi boyut sınırını aştı	Bir kez proxy veya ağ geçidi olmadan test edin. Proxy'nin gövde boyutu sınırını ve okuma zaman aşımını artırın, API rotası için yanıt tamponlamayı kapatın.
Claude Code yükseltmesinden hemen sonra başladı	/status içindeki sürümü not edin. Temmuz 2026 tarihli bir rapor, aynı makinede takılma iletisinin 2.1.210'da %0, 2.1.217–2.1.218'de %3,0–4,4 olduğunu ölçtü.

Önce continue yanıtını verin

Claude Code, hata öncesinde tamamlanan metni ve araç çağrılarını korur ve bildirimi ekler. Etkileşimli bir oturumda gelenleri okuyun ve continue yanıtını verin: tur oradan devam eder. Etkileşimsiz bir çalışmada (claude -p) Claude Code son tamamlanan metin bloğunu ve ardından bildirimi yazdırır; o oturumu sürdürün ve continue gönderin. Bir kez olursa başka bir şeyi değiştirmeniz gerekmez.

İletileri birbirinden ayırın

Claude Code'un hata başvurusu, eksik yanıt ifadelerini nedenlerine göre listeler: yanıtın ortasında sunucu hatası, yanıtın ortasında bağlantı kaybı, yanıtın ortasında bilgisayarın uykuya geçmesi, yanıtın gelmeyi durdurması (takılma), yanıtın bir bölümünün hiç gelmemesi ve yanıt akışının biçimsel olarak bozulması. Temmuz 2026 tarihli raporlar takılma için eski bir ifadeyi, “Response stalled mid-stream” sözünü aktarır. Ayrı ileti olan “Streaming response ended before any complete data was received”, hiçbir tamamlanmış verinin gelmediği durumdur; Claude Code'un kısmi yanıtı korumak yerine akış olmadan yeniden denemesinin nedeni budur.

Bekçiyi ayarlayın, devre dışı bırakmayın

Claude Code, akış sessiz kaldığında onu sonlandıran dört zamanlayıcı çalıştırır; böylece kopmuş bir bağlantı takılı kalmak yerine hata verir ve yeniden denenir: ilk bayt için bir süre sınırı, olay düzeyinde bir gözetim zamanlayıcısı (300 saniye), bayt düzeyinde bir gözetim zamanlayıcısı (doğrudan Anthropic API'sinde 180 saniye; özel bir ANTHROPIC_BASE_URL kullanımı dahil diğer tüm durumlarda 300 saniye) ve bazı sağlayıcılarda yanıt gövdesi için beş dakikalık bir hareketsizlik zaman aşımı. CLAUDE_STREAM_IDLE_TIMEOUT_MS, her iki gözetim zamanlayıcısını da ayarlar; beş dakikanın altındaki değerler beş dakikaya yükseltilir ve bayt düzeyindeki gözetim zamanlayıcısı en fazla 30 dakika olabilir. Arka plan ajanlarının da bu ayarı alması için settings.json dosyasının env bloğuna ekleyin:

~/.claude/settings.json

{
  "env": {
    "CLAUDE_STREAM_IDLE_TIMEOUT_MS": "600000"
  }
}

Bir proxy veya ağ geçidinin arkasındaysanız onsuz test edin

Akış olmadan yeniden deneme iletisi tekrarlanıyorsa aradaki bağlantı noktasını bir kez çıkarın: tek bir oturum için HTTPS_PROXY ayarını kaldırın veya NO_PROXY="*" olarak ayarlayın ve aynı görevi çalıştırın. Durursa neden aradaki bağlantı noktasıdır. Yaygın suçlular; uzun oturumların aştığı istek gövdesi boyutu sınırı, canlı akışı uzun bir sessizliğe dönüştüren yanıt tamponlama ve modelin düşünme duraklamalarından daha kısa bir okuma zaman aşımıdır. ANTHROPIC_BASE_URL bir ağ geçidine işaret ettiğinde ilk bayt son tarihinin çalışmadığını, ancak bayt düzeyindeki bekçinin çalıştığını unutmayın.

Kunavo üzerinden çağrı yapıyorsanız

Kunavo, bu iletinin sözünü ettiği ağ geçitlerinden biridir; Claude Code'un çağırdığı /v1/messages üzerinde yaptığı budur. Üst akış, ilk içerik olayını üretmeden önce tutulur; bundan önce bir üst akış hatası veya boş akış denemeyi başarısız kılar ve modelin birden fazla kanalı varsa başka bir kanalda yeniden denenir veya HTTP hatası olarak döndürülür — hiçbir zaman içinde hiçbir şey olmayan 200 durum kodlu bir akış olarak sona ermez. İçerik başladıktan sonraki bir takılma, ağ geçidinin yeniden deneyebileceği bir şey değildir; Claude Code'un bekçisi ve continue özelliği bunun için doğru araçlardır. OpenAI uyumlu tarafta akışların nasıl sona erdiği ve eksiksiz bir yanıtı kesilmiş bir yanıttan nasıl ayırt edeceğiniz şu bölümde açıklanıyor: LLM API akış hataları.

Sık sorulan sorular

Claude Code'da “The response above may be incomplete” ne anlama gelir?

Akışlı yanıtın bir kısmı geldikten sonra durdu — takılma, bağlantı kopması, sunucu hatası veya bilgisayarın uykuya geçmesi. Claude Code tamamlanan metni ve araç çağrılarını korur ve bildirimi ekler. continue yanıtını verin; tur gelen kısımdan devam eder.

“Response stalled mid-stream”, “The response stopped arriving” ile aynı şey midir?

Aynı durumu açıklarlar: bağlantı açık kaldı ancak bir akış bekçisi onu iptal edene kadar veri göndermeyi durdurdu. Claude Code'un güncel hata başvurusu “The response stopped arriving” ifadesini kullanır; Temmuz 2026'da açılan raporlar “Response stalled mid-stream” ifadesini aktarır.

Claude Code neden “Retrying without streaming” diyor?

Çünkü akış, hiçbir tamamlanmış veri alınmadan sona erdi ve korunacak bir şey yoktu. Claude Code aynı isteği akış olmadan yeniden gönderir. İleti görünmeye devam ederse Claude Code ile sağlayıcı arasındaki proxy'yi veya ağ geçidini kontrol edin — gövde boyutu sınırları, tamponlama ve okuma zaman aşımı genellikle nedenlerdir.

Akış bekçisini kapatmalı mıyım?

Hayır. Bekçiler, oturumun süresiz olarak takılı kalması yerine ölü bağlantının başarısız olup yeniden denenmesini sağlar. Bağlantınız meşru olarak uzun süre sessiz kalıyorsa CLAUDE_ENABLE_STREAM_WATCHDOG veya CLAUDE_ENABLE_BYTE_WATCHDOG değerini 0 olarak ayarlamak yerine CLAUDE_STREAM_IDLE_TIMEOUT_MS değerini artırın (beş dakikanın altındaki değerler beş dakikaya yükseltilir).

ANTHROPIC_BASE_URL ile ağ geçidi kullanmak bunu daha olası hâle getirir mi?

Claude Code ile sağlayıcı arasındaki her bağlantı noktası, akışın tamponlanabileceği, kesilebileceği veya zaman aşımına uğrayabileceği bir yer daha demektir; bu nedenle iletiler tekrarlanıyorsa ağ geçidi olmadan test edin. Bayt düzeyindeki bekçi ağ geçidi bağlantılarında da çalışır; ANTHROPIC_BASE_URL bir ağ geçidi üzerinden yönlendirme yaptığında ilk bayt son tarihi çalışmaz.

İlgili kılavuzlar

Hata anlamlarına ilişkin daha fazla bilgi hata referansı bölümünde; anahtar almak kayıt ve kimlik doğrulama kılavuzu üzerinden bir dakika sürer.