Terminalde claude komutunu çalıştırıyorsunuz, imleç bir süre kıpırdamıyor, sonra Request timed out. İlk tepki genelde aynı: CLI'yi yeniden kuralım, bağlamı kısaltalım, daha hafif modele geçelim. Bunlar bazen işe yarar. Ama aynı komutun bir ağda sorunsuz çalışıp başka bir ağda takıldığını fark ettiyseniz, sorun istem cümlenizde değildir. Paketlerin API'ye giderken izlediği yoldadır.
Bu yazı uygulama katmanını değil, onun altındaki katmanı konu alıyor: gecikme, paket kaybı ve yanıt ortasında kopan TLS bağlantıları. API sunucularına coğrafi olarak uzaktaki bir geliştiriciyseniz asıl darboğaz büyük ihtimalle burada.
Bu hata en çok kimin başına geliyor
Üç tipik durum var, ve hepsinin ortak noktası şu: istek hiçbir zaman temiz biçimde bitmiyor, bu yüzden istemci pes ediyor.
Birincisi, trafiği API'ye varmadan önce uzun ve kalabalık bir uluslararası hattı geçmek zorunda kalan geliştirici. Büyük bir refactor için komutu çalıştırırsınız, kısa istekler az önce sorunsuz dönmüşken bu sefer zaman aşımı yersiniz. Model aslında yanıt üretiyordu; geri dönen belirteç akışı kayıplı hatta ilerleyemedi, o kadar.
İkincisi şirket ya da kampüs ağı. Burada bağlantı çoğu zaman yanıtın ortasında sıfırlanır ve karşınıza o sinir bozucu Partial response received çıkar. Sebep genelde bir proxy veya güvenlik duvarıdır: akışı tamponlar, ya da boşta saydığı bağlantıyı model düşünmek için durduğu anda kapatır.
Üçüncüsü başsız çalıştırmalar ve CI boru hatları. Burada bir agent peş peşe onlarca araç çağrısı yapar ve her çağrı ayrı bir gidiş-dönüş demektir. İnsan oturumunda tek bir takılan istek can sıkar ama düzeltirsiniz; otomatik bir akışta ise zincirin tek halkası takıldığında bütün iş sessizce çöker ve sabah logları açana kadar haberiniz olmaz. Bu yüzden CI tarafında rota kalitesi, etkileşimli kullanımdan bile kritiktir.
Önce hatayı doğru okuyun: gerçek zaman aşımı mı, yoksa sadece yavaşlık mı
Claude Code her isteğe oldukça geniş bir pencere tanır, dakikalar mertebesinde. Yani gerçek bir zaman aşımı, akışın bu süre içinde kullanılabilir bir sonuç üretememesi demektir. Modelin biraz ağır olması değil.
Ayrımı yapmanın hızlı yolu var. claude --version ile sürümün güncel olduğundan emin olun, sonra /doctor çalıştırın; bu komut yapılandırma kaynaklı sorunların çoğunu tek seferde önünüze döker. Ardından tek satırlık minik bir istem gönderin. Küçük istek anında dönüyor ama büyük agent görevi zaman aşımına uğruyorsa hat çalışıyor demektir. Sorun, zayıf rotanın ağır trafiği taşıyamamasıdır.
Rotadaki gecikmeyi ve kaybı ölçün
Çoğu rehberin atladığı adım tam olarak burası. Tahmin yürütmek yerine sayıya bakın.
API ana makinesine temel gidiş-dönüş süresini görmek için ping, kaybın hangi atlamada başladığını anlamak için traceroute ya da mtr. Etkileşimli kodlamada makul gidiş-dönüş 150 ms altında, neredeyse kayıpsız ve istikrarlı olmalı. 250 ms'yi aşıp ara bir atlamada aralıklı kayıp başladığında akış yanıtları takılmaya, uzun çağrılar da zaman aşımı vermeye başlar.
Bir not: titreşim de saf gecikme kadar zararlı. 80 ile 400 ms arasında zıplayan bir rota, ortalaması iyi görünse bile akışı düzensizce koparır. Tek seferlik bir ping burada yanıltıcı olabilir; birkaç dakika sürekli ölçüm yapıp en kötü değerlere ve kaybın yüzdesine bakmak, ortalamadan çok daha fazlasını anlatır. Akış tabanlı bir araç, sayıların en kötü olduğu anlarda kopar, ortalamanın güzel göründüğü anlarda değil.
"Partial response received" ne anlatır
Bu mesaj bir bağlantı katmanı işaretidir, model hatası değil. Akışı taşıyan TLS bağlantısı son belirteç gelmeden kesilmiştir. Pratikte iki şüpheli vardır: araya giren ve akışı tamponlayan bir proxy, ya da model bir an durakladığında bağlantıyı boşta sayıp kapatan bir keep-alive politikası. Trafiğinizin önünde bir şirket proxy'si olup olmadığını ve aynı isteğin başka bir ağda tamamlanıp tamamlanmadığını kontrol edin.
Katmanları teker teker eleyin
Hangi katmanın suçlu olduğunu bulmak için sırayla ilerleyin:
- Resmi durum sayfasına bakın. Yeşilse sorun API'nin kendisinde değil, daha aşağıda.
- Telefon etkin noktası ya da bambaşka bir ağ üzerinden tekrar deneyin. Zaman aşımı kayboluyorsa suçlu sizin asıl hattınızdır; bu testin sonucu bir dakikadan kısa sürede belli olur.
- İki test de hattı işaret ediyorsa, geriye trafiği daha kararlı bir yola taşımak kalır.
NasaCode'un devreye girdiği yer tam olarak bu orta katman. Paketlerin kalabalık varsayılan rotada dolaşmasına izin vermek yerine, trafiği gecikmesi daha öngörülebilir ve kaybı daha düşük bir rotaya sabitler. Amaç akışı, büyük bir agent görevinin sonuna kadar canlı tutmak.
Bağlantı yollarını yan yana koyunca
Aynı komut için seçtiğiniz yol, uzun görevlerin bitip bitmemesini doğrudan belirliyor.
| Bağlantı yolu | Uzun görevde akış kararlılığı | Rota seçenekleri | İstemci uyumu | Claude Code için |
|---|---|---|---|---|
| Varsayılan doğrudan bağlantı | Uzun uluslararası atlamalarda öngörülemez | İnternet sağlayıcınıza bağlı | Her terminal | API yakınsa iyi, uzaktaysa zorlanır |
| Ücretsiz genel proxy | Sık sık ortada sıfırlanır | Az, paylaşımlı, aşırı yüklü | Elle kurulum, kırılgan | Zayıf; her sıfırlama agent'ı koparır |
| Genel tüketici tüneli | Akış için ayarlanmamış, orta düzey | Genel amaçlı bölge düğümleri | Masaüstü uygulamaları | Sürekli çağrıda tutarsız |
| NasaCode optimize rota | Sürekli akış için kararlı gecikme | Geliştiriciye yönelik düşük gecikmeli düğümler | Masaüstü ve CLI dostu | Uzun IDE ve agent oturumlarına göre ayarlı |
Sık çıkan sorular
Zaman aşımı süresini uzatsam çözülür mü?
Genelde hayır. Daha geniş pencere yalnızca akış gerçekten bitmek üzereyken son bir kaç saniye kazandırır. Paketler kaybolmaya ya da bağlantı sıfırlanmaya devam ediyorsa, tek elde ettiğiniz şey aynı hata için daha uzun beklemek olur. Önce rotayı düzeltin.
Daha güçlü bir bilgisayar fark eder mi?
Hayır. Zaman aşımı bir ağ olayı; baytlar terminaliniz ile API arasında gidip geliyor. İşlemci ve bellek yerel araçların hızını belirler, yanıt akışının kayıplı bir atlamayı aşıp aşamayacağını değil.
Resmi bir kesintiyle kendi bağlantımı nasıl ayırırım?
Önce resmi durum sayfasına bakın. Orası sağlıklı görünüyor ama en küçük istem bile takılıyorsa, sorun sizin tarafınızda. Başka bir ağda denemek bunu saniyeler içinde teyit eder.
Çok adımlı agent görevlerini nasıl korurum?
Her adımın yükünü makul tutmak yardımcı olur, ama belirleyici olan rotanın kalitesi. Çok adımlı bir görevin akışını baştan sona ancak kararlı gecikmeli ve düşük kayıplı bir bağlantı taşıyabilir.
Özetle: Claude Code zaman aşımı çoğu zaman uygulama katmanı kılığına girmiş bir rota sorunudur. Tahmin etmeyi bırakıp gecikmeyi ve kaybı ölçtüğünüzde çözüm de kendiliğinden netleşir, rotayı sabitlemek. NasaCode bu iş için kuruldu; yapay zeka kodlama araçlarının ürettiği sürekli akış trafiğine göre ayarlanmış düşük gecikmeli düğümlerle çalışır. Kendi hattınızda bir akşamı zaman aşımlarıyla harcadıysanız, denemeye değer.
