Claude Code Uzaktan Bağlantı Kopması Sorun Giderme: Altı Tür Kopmanın Belirtileri, Tanı Kriterleri ve Çözümleri

Claude Code'u uzaktan çalıştırırken en sinir bozucu şey bağlanamamak değil, bağlanıp da kopması ve her kopuşun nedeninin farklı olması.

"Bağlantı kopması" aslında altı tamamen farklı arızayı kapsıyor. Belirtileri farklı özellikler taşıyor ve çözüm yöntemleri birbiriyle ilgisiz—ağ değişiminden kaynaklanan uzun bağlantı kaybını makine uykusu sanıp uyku modunu kapatmak işe yaramaz; yarı ölü bağlantıyı kötü ağ sanıp beklemek, sabaha kadar kendiliğinden düzelmez.

Bu makale, gerçekte gördüğünüz belirtilerden yola çıkarak nedeni tespit eder: her kopma türü için belirtiler, nasıl doğrulanacağı ve buna karşılık gelen çözümler verilir. Doğrudan işe koyulmak istiyorsanız, son bölümdeki sorun giderme kontrol listesine atlayın.

Bu yazı yalnızca bağlantı kopması sorun gidermeyi kapsar. Uzaktan erişimin nasıl kurulacağı için Claude Code Uzaktan Erişim: Yerel Makineyi Kapatmadan Her Yerden Oturum Yönetimi yazısına, mobilde nasıl kullanılacağı için Telefonla Claude Code: iOS'ta Oturumları ve Onay Araçlarını Görüntüleme yazısına bakın.

Önce Belirtileri Eşleştirin: Hangisini Görüyorsunuz?

Uzaktan bağlantı iki katmandan oluşur: Claude Code'u çalıştıran geliştirme makinesi ←→ elinizdeki görüntüleme cihazı. İki katmandan herhangi birinde sorun çıktığında "koptu" olarak görünür, ancak belirtiler farklıdır:

Gördüğünüz Belirti	Büyük Olasılıkla	Git
Oturum aniden dondu, yeniden bağlanınca ilerlemenin de o anda durduğunu gördünüz	Geliştirme makinesi uyku / kilitli ekran	§1
Asansöre girme, 4G'ye geçme, WiFi değiştirme anında kopma	Uzun bağlantı kesildi	§2
Yerel terminal kapatıldığında veya yerel makine uykuya geçtiğinde uzaktan bağlantı anında kopuyor	Yansıtma tabanlı çözümün katı kısıtı	§3
Çevrimiçi görünüyor ama gönderilen mesajlar kayboluyor, hata yok	Yarı ölü bağlantı	§4
Yeniden bağlanabiliyor ama oturum boş / kopma sırasındaki mesajlar yok	Yeniden bağlanma orijinal oturuma dönmemiş	§5
Birkaç saat sonra tekrar bağlanınca oturum kaybolmuş	İşlem geri dönüştürülmüş ve soğuk kurtarma yok	§6

En kolay yanlış teşhis edilen dördüncüsüdür: hiç hata vermez. Bağlantı durumu yeşildir, mesajlar gider, ama asla yanıt gelmez—doğrudan kopmadan daha zor tespit edilir, çünkü tüm göstergeler size "her şey normal" der.

1. Geliştirme Makinesi Uyku / Kilitli Ekran / Kapak Kapatma

Belirtiler: Oturum bir anda tamamen durur. Yeniden bağlandığınızda ilerleme hâlâ kopmanın olduğu andadır, bir adım bile ilerlememiştir.

Neden: Birçok kişi "geliştirme makinem hep açık" sanır, ancak sistem uyku modu, kapak kapatınca uyku, zamanlanmış kilitli ekran Claude Code sürecini askıya alır veya doğrudan öldürür. Görüntüleme tarafında görülen şey "aniden durdu" olur.

Nasıl doğrulanır: Geliştirme makinesine dönüp o sürecin hâlâ var olup olmadığına ve sistem günlüklerinde uyku kaydı olup olmadığına bakın. Süreç hâlâ varsa ancak zaman damgası kopma anında durmuşsa, neredeyse kesin odur.

Çözüm: Geliştirme makinesinin güç planını "uykusuz / kapak kapatınca uyumama" olarak ayarlayın. Bu, kökten çözen tek yöntemdir—hiçbir uzaktan erişim çözümü uykuya dalmış bir makineyi kurtaramaz.

2. Ağ Değişimi Uzun Bağlantının Kesilmesine Neden Oluyor

Belirtiler: Kopma çok belirgin bir anda gerçekleşir—asansöre girme, WiFi'dan 4G'ye geçme, ev geniş bantının gece yarısı yeniden bağlanması.

Neden: Uzaktan gerçek zamanlı senkronizasyon tek bir uzun bağlantıya (WebSocket / SSH) dayanır. IP değiştiğinde bu bağlantı anında geçersiz olur, başka seçenek yoktur.

Nasıl doğrulanır: Kopma zamanı, ağ değiştirme zamanınızla uyuşuyorsa odur.

Çözüm: Bu tür kaçınılmazdır; yalnızca otomatik yeniden bağlanma + geri çekilme (backoff) ile telafi edilebilir (1s→2s→5s…, kopar kopmaz aşırı deneme yapmaktan kaçınmak için). Çıplak SSH bu özelliğe sahip değildir; koptuysa kopmuştur, elle bağlanmanız gerekir. Çözüm seçerken bu kesin bir gerekliliktir.

3. Yansıtma Tabanlı Çözüm: Yerel Makine Ön Planda Açık Olmalı

Belirtiler: Yerel terminal kapatıldığında veya yerel makine uykuya geçtiğinde, telefon tarafı anında kopar. Yavaş yavaş zaman aşımı değil, senkronizasyon bozulmasıdır.

Neden: Anthropic'in resmi Remote Control özelliği, yerel makinenizde çalışan oturumu telefona/tarayıcıya yansıtır. Ön koşul, yerel makinedeki Claude Code'un sürekli ön planda açık olması ve yerel makinenin sürekli çevrimiçi olmasıdır. Yerel makine koptuğunda, uzak tarafın bağlanabileceği bağımsız bir yaşam döngüsü yoktur.

Nasıl doğrulanır: Yerel terminal penceresini kapatın ve uzak bağlantının aynı saniyede kopup kopmadığına bakın. Öyleyse, yansıtma tabanlı bir çözüm kullanıyorsunuz demektir.

Çözüm: Geliştirme makinesi tarafında kalıcı arka plan hizmeti mimarisine geçin—oturumun çalıştığı tarafı, açılışta otomatik başlayan ve görüntüleme cihazınızdan bağımsız yaşayan bir arka plan hizmeti haline getirin. Görüntüleme tarafı kapatılsa, değişse veya kopsa da, geliştirme makinesinde normal şekilde çalışmaya devam eder. Bu, "yansıtma" ile "kalıcı hizmet" arasındaki temel farktır; parametrelerle ayarlanacak bir şey değildir.

4. Yarı Ölü Bağlantı (half-open): En Zor Tespit Edilen Tür

Belirtiler: Çevrimiçi görünür, mesaj gönderilince yanıt gelmez, hata da vermez. Birkaç dakika takılı kalabilir veya elle yeniden bağlanana kadar sürebilir.

Neden: Ağ sessizce kesildiğinde (NAT tablosu girişinin zaman aşımı, ara cihazların durum kaybı, sinyalin yalnızca paket kaybına yol açacak kadar zayıf olması ama bağlantının kopmaması), TCP uçlarının her ikisi de hâlâ bağlı olduğunu sanabilir, ancak veriler artık geçemez. Kalp atışı (heartbeat) yoksa, iki taraf da bu yanılsamayı sürdürür.

Nasıl doğrulanır: Bağlantı durumu normal görünür, ancak gönderilen mesajlar ne teslimat onayı ne de hata alır; elle bağlantıyı kesip yeniden bağlandığınızda hemen düzelir—işte odur.

Çözüm: Bağlantı üzerinde kalp atışı (keepalive ping) çalıştırılmalıdır: belirlenen süre içinde karşı taraftan hiçbir yanıt alınamazsa, bu bağlantı yarı ölü kabul edilir ve aptalca beklemek yerine aktif olarak bağlantı kesilip yeniden bağlanılır. Ölçüt "yanıt alamamak" olmalıdır, "hata almamak" değil—yarı ölü bağlantı asla hata vermez.

5. Yeniden Bağlantı Orijinal Oturuma Dönmüyor / Mesaj Kaybı

Belirtiler: Koptuktan sonra yeniden bağlanabiliyor, ancak geri dönülen oturum ya boş ya da kopma sırasında karşı tarafın gönderdiği mesajlar tamamen kaybolmuş.

Neden: Yeniden bağlanma yalnızca yeni bir bağlantı kurar, bu bağlantıyı orijinal oturuma yeniden abone yapmaz; kopma sırasındaki mesajlar sizin için önbelleğe alınmamıştır.

Nasıl doğrulanır: Yeniden bağlandıktan sonra oturum kimliği (ID) değişmiş veya geçmiş yalnızca yeniden bağlanma anından itibaren başlıyor.

Çözüm: Yeniden bağlandıktan sonra otomatik olarak orijinal oturuma abone olan ve kopma sırasındaki geçmişi oynatan bir çözüm seçin. Yalnızca yeniden bağlanıp oturuma dönememek, boşa bağlanmak demektir.

6. Oturum Süreci Geri Dönüştürülmüş ve Soğuk Kurtarma Yok

Belirtiler: Kısa süreli kopmalarda yeniden bağlanma normaldir, ancak birkaç saat sonra dönüldüğünde oturum kaybolmuştur.

Neden: Uzun süre boşta kalan oturum süreci geri dönüştürülebilir; arka plan hizmeti (daemon) de yeniden başlatılmış olabilir (güncelleme, çökme sonrası ayağa kaldırma). Bellekteki oturum durumu da böylece kaybolur.

Nasıl doğrulanır: Yalnızca uzun süreli kopmalarda tekrarlanır, kısa kopmalarda görülmez.

Çözüm: Soğuk kurtarma yeteneği gerekir—oturum durumu diske yazılır, süreç yok olsa bile bağlam diskten geri yüklenebilir. İdeal olarak siz bir mesaj gönderdiğinizde otomatik olarak kurtarılır ve devam eder; bu sizin için fark edilmez.

Sorun Giderme Kontrol Listesi (Her Çözümle Uygulanabilir)

Sırayla gözden geçirin; her adım bağımsız olarak elenebilir:

1. Oturumun çalıştığı makine uyku moduna geçti mi / kilitlendi mi? → Otomatik uykuyu kapatın, kapak kapanınca uyumayı engelleyin. (§1)
2. Kopma zamanı, ağ değiştirme zamanınızla çakışıyor mu? → Otomatik yeniden bağlanma + backoff içeren bir çözüm gerekir; çıplak SSH'ye güvenmeyin. (§2)
3. Yerel terminal kapatıldığında uzak bağlantı anında kopuyor mu? → Bu, yansıtma tabanlı çözümün katı kısıtıdır; kalıcı arka plan hizmeti mimarisine geçmelisiniz. (§3)
4. "Çevrimiçi görünüyor ama mesajlara yanıt yok" durumunda mı kaldınız? → Yarı ölü bağlantıdır; yalnızca kalp atışı algılaması otomatik olarak kurtarabilir. (§4)
5. Yeniden bağlandıktan sonra oturum boş / mesajlar eksik mi? → "Orijinal oturuma dönüş + geçmiş oynatma" gerekir. (§5)
6. Yalnızca uzun süreli kopmalarda oturum kayboluyor mu? → Diske yazma + soğuk kurtarma gerekir. (§6)

Somut Çözümlere Uygulama

Yukarıdaki altı maddeden yalnızca 1. madde sizin makinenizin ayar sorunudur; diğer beşi tamamen mimariye bağlıdır—çözüm seçimi sırasında kesinleşir; sorun çıktıktan sonra parametre ayarlayarak kurtarılamaz.

Bir uzaktan erişim çözümünün kopmaması için şunlara aynı anda sahip olması gerekir: geliştirme makinesi tarafında kalıcı arka plan hizmeti (§1'deki kalan risk ve §3 için), otomatik yeniden bağlanma + backoff (§2), kalp atışı algılama (§4), yeniden bağlanınca orijinal oturuma dönme + geçmiş oynatma (§5), diske yazma ile soğuk kurtarma (§6).

PandaNpc + pandapaw sistemi bu altı maddenin her birine göre yapılmıştır: pandapaw geliştirme makinesinde açılışta otomatik başlayan kalıcı bir arka plan hizmeti olarak kaydedilir (elle açık tutmanız gereken bir terminal penceresi değildir; çökerse otomatik olarak yeniden başlatılır); görüntüleme tarafı koptuğunda otomatik yeniden bağlanır ve backoff uygular; bağlantı üzerinde kalp atışı çalışır, yanıt alınamazsa bağlantı yarı ölü kabul edilip aktif olarak yeniden bağlanılır; yeniden bağlandıktan sonra otomatik olarak orijinal oturuma abone olur ve kopma sırasındaki geçmişi oynatır; oturum süreci geri dönüştürülse bile, bir mesaj gönderdiğinizde diskten soğuk kurtarma yapılarak devam edilir.

Nasıl kurulacağı ve bağlanılacağı için Claude Code Uzaktan Erişim yazısına; mobilde oturum görüntüleme ve araç onayı için Telefonla Claude Code yazısına bakın.

Ek Bir Tuzak: Uzaktan Çalışırken Faturalandırmaya Dikkat

Kopma sorununu giderirken kolayca claude -p (headless mod) kullanmaya geçebilirsiniz, ancak 15 Haziran 2026'dan itibaren Anthropic faturalandırmayı değiştirdi—headless artık abonelik kotasını kullanmıyor; küçük bir aylık SDK kredisi harcıyor ve kredi bitince API üzerinden faturalandırılıyor. Yoğun kullanımda kolayca limit aşılabilir. Etkileşimli mod (claude REPL) hâlâ abonelik kotasını kullanır. Çözüm değiştirirken kopmayı araştırırken dikkatli olun, farkında olmadan faturalandırma modunu da değiştirmeyin.