Claude Code: Diagnostika vzdálených výpadků – příznaky, kritéria a řešení šesti typů přerušení

Při vzdáleném provozu Claude Code není nejhorší to, že se nelze připojit, ale že se připojení přeruší, a pokaždé z jiného důvodu.

Slovo „výpadek“ ve skutečnosti zahrnuje šest zcela odlišných poruch. Mají různé příznaky a jejich řešení spolu nesouvisí – pokud si spletete selhání dlouhého spojení způsobené přepnutím sítě s uspáním počítače, vypnutí režimu spánku nepomůže; pokud si spletete polomrtvé spojení se špatnou sítí a budete čekat, samo se do rána nespraví.

Tento článek postupuje od toho, co skutečně vidíte, zpět k příčině: u každého typu přerušení uvádí příznaky, jak ho potvrdit, a odpovídající řešení. Pokud chcete rovnou jednat, skočte na kontrolní seznam v poslední části.

Tento článek se věnuje pouze diagnostice výpadků. Jak nastavit vzdálený přístup, viz Vzdálený přístup k Claude Code: ovládejte relace odkudkoli i bez lokálního počítače, jak používat mobilní zařízení, viz Claude Code na mobilu: prohlížení relací a schvalování nástrojů v iOS.

Nejprve porovnejte příznaky: kterou z nich vidíte

Vzdálené připojení se skládá ze dvou stran: vývojový stroj, na kterém běží Claude Code ←→ vaše zobrazovací zařízení. Problém na kterékoli straně se projeví jako „přerušeno“, ale příznaky se liší:

Co vidíte	Pravděpodobná příčina	Přejít na
Relace náhle zamrzne a po opětovném připojení zjistíte, že postup se zastavil v tom okamžiku	Uspání / uzamčení vývojového stroje	§1
Přerušení v okamžiku, kdy vstoupíte do výtahu, přepnete na 4G nebo změníte WiFi	Dlouhé spojení bylo ukončeno	§2
Když zavřete terminál na lokálním počítači nebo ho uspíte, vzdálené připojení se okamžitě přeruší	Tvrdé omezení řešení typu zrcadlení obrazovky	§3
Zobrazuje se jako online, ale zprávy mizí beze stopy a bez chybové hlášky	Polomrtvé spojení	§4
Lze se znovu připojit, ale vrátíte se do prázdné relace / zprávy z doby výpadku zmizely	Znovupřipojení nepokračuje v původní relaci	§5
Po několika hodinách se připojíte a relace je pryč	Proces byl uvolněn a neexistuje žádné studené zotavení	§6

Nejsnáze lze chybně určit čtvrtý typ: nehlásí žádnou chybu. Stav připojení je zelený, zprávy se odesílají, ale odpověď nikdy nepřijde – je to obtížnější na diagnostiku než přímé přerušení, protože všechny kontrolky vám říkají, že je „vše v pořádku“.

1. Uspání / uzamčení / zavření víka vývojového stroje

Příznaky: Relace se v určitém okamžiku úplně zastaví. Po opětovném připojení postup stále stojí v místě přerušení, ani o krok dál.

Proč: Mnoho lidí si myslí: „vývojový stroj mi pořád běží“, ale systémový spánek, uspání po zavření víka a časové uzamčení obrazovky pozastaví nebo rovnou ukončí proces Claude Code. Na straně zobrazovacího zařízení to vypadá jako „najednou se to zastavilo“.

Jak to ověřit: Vraťte se k vývojovému stroji a zkontrolujte, jestli proces stále běží a jestli systémový log obsahuje záznam o uspání. Pokud proces běží, ale časové razítko zůstalo v okamžiku přerušení, je to téměř jistě tento případ.

Řešení: Nastavte plán napájení vývojového stroje na „nikdy nespát / nezavírat víko a neuspávat“. To je jediné skutečné řešení – žádné vzdálené připojení nezachrání stroj, který už usnul.

2. Přepnutí sítě přeruší dlouhé spojení

Příznaky: Přerušení nastane ve zcela konkrétním okamžiku – vstoupíte do výtahu, WiFi se přepne na 4G, domácí optika se v noci znovu připojí.

Proč: Vzdálená synchronizace v reálném čase spéhá na jedno dlouhé spojení (WebSocket / SSH). Jakmile se změní IP adresa, toto spojení okamžitě zanikne, bez jakéhokoli vyjednávání.

Jak to ověřit: Pokud čas přerušení odpovídá času přepnutí sítě, je to ono.

Řešení: Tomuto typu se nelze vyhnout; lze ho pouze zachytit automatickým znovupřipojením s ústupem (1s→2s→5s…, aby se zabránilo opakovaným pokusům hned po přerušení). Holé SSH tuto schopnost nemá; když se spojení přeruší, je to definitivní a musíte se připojit ručně. Při výběru řešení je to tvrdé kritérium.

3. Řešení typu zrcadlení obrazovky: lokální počítač musí zůstat otevřený v popředí

Příznaky: Jakmile zavřete terminál na lokálním počítači, nebo lokální počítač uspíte, připojení z mobilu se okamžitě přeruší. Není to pomalé vypršení časového limitu, ale ztráta synchronizace.

Proč: Oficiální Remote Control od Anthropic funguje tak, že zrcadlí relaci, která právě běží na vašem lokálním počítači, do mobilu/prohlížeče. Předpokladem je, že Claude Code na lokálním počítači stále běží v popředí a lokální počítač je stále online. Jakmile lokální počítač vypadne, vzdálená strana nemá žádný nezávislý životní cyklus, o který by se mohla opřít.

Jak to ověřit: Zavřete okno terminálu na lokálním počítači a sledujte, jestli se vzdálené připojení přeruší ve stejné sekundě. Pokud ano, používáte řešení typu zrcadlení obrazovky.

Řešení: Přepněte na architekturu s trvale běžícím démonem na straně vývojového stroje – strana, která spouští relaci, by měla být implementována jako služba na pozadí s automatickým spuštěním, nezávislá na vašem zobrazovacím zařízení. I když zobrazovací zařízení vypnete, vyměníte nebo se připojení přeruší, relace na vývojovém stroji dál běží. To je podstatný rozdíl mezi „zrcadlením“ a „trvalou službou“, a nelze ho doladit žádnými parametry.

4. Polomrtvé spojení (half-open): nejobtížněji odhalitelný typ

Příznaky: Zobrazuje se jako online, ale zprávy nereagují a nehlásí chybu. Může to trvat pár minut, nebo to může zůstat zamrzlé, dokud se ručně nepřipojíte znovu.

Proč: Při tichém přerušení sítě (vypršení záznamu NAT, ztráta stavu na prostředním zařízení, signál tak slabý, že se pakety ztrácejí, ale spojení se nepřeruší) mohou obě strany TCP stále předpokládat, že jsou spojené, i když data už nemohou projít. Bez heartbeat obě strany tento přelud udržují donekonečna.

Jak to ověřit: Stav připojení vypadá normálně, ale odeslané zprávy nemají ani potvrzení o doručení, ani chybu; po ručním odpojení a znovupřipojení se vše okamžitě obnoví – to je ono.

Řešení: Na spojení musí běžet heartbeat (keepalive ping): pokud v daném časovém limitu neobdržíte žádnou odpověď od protistrany, vyhodnoťte to jako polomrtvé spojení a aktivně se odpojte a znovu připojte, místo abyste bezmocně čekali. Kritérium musí být „nedostáváme odpověď“, ne „nehlásí chybu“ – polomrtvé spojení nikdy nehlásí chybu.

5. Znovupřipojení nepokračuje v původní relaci / ztráta zpráv

Příznaky: Po přerušení se lze znovu připojit, ale buď se vrátíte do prázdné relace, nebo všechny zprávy zaslané protistranou během výpadku zmizely.

Proč: Znovupřipojení pouze vytvoří nové spojení, ale toto spojení se nepřihlásí zpět k původní relaci; zprávy z doby výpadku nejsou pro vás uloženy do mezipaměti.

Jak to ověřit: Po znovupřipojení se změnilo ID relace, nebo historie začíná až od okamžiku znovupřipojení.

Řešení: Vyberte řešení, které se po znovupřipojení automaticky přihlásí zpět k původní relaci a přehraje historii z doby výpadku. Pouze znovupřipojení bez návratu k původní relaci je k ničemu.

6. Proces relace byl uvolněn a neexistuje žádné studené zotavení

Příznaky: Krátkodobé výpadky a znovupřipojení fungují normálně, ale po pár hodinách se vrátíte a relace je pryč.

Proč: Dlouho nečinné procesy relací mohou být uvolněny; také samotný démon mohl být restartován (upgrade, restart po pádu). Stav relace v paměti tím zmizí.

Jak to ověřit: Objeví se to jen po dlouhém výpadku, ne po krátkém.

Řešení: Je potřeba studené zotavení – stav relace musí být uložen na disk, takže i když proces zmizí, lze kontext z disku obnovit. V ideálním případě pošlete zprávu a relace se automaticky obnoví a pokračuje, aniž byste si toho všimli.

Kontrolní seznam pro diagnostiku (lze použít s jakýmkoli řešením)

Projděte postupně; každý krok lze nezávisle vyvrátit:

1. Uspal se / uzamkl se stroj, na kterém běží relace? → Vypněte automatické uspávání a nastavte režim bez uspání po zavření víka. (§1)
2. Odpovídá čas výpadku okamžiku přepnutí sítě? → Potřebujete řešení s automatickým znovupřipojením + ústupem, nespoléhejte na holé SSH. (§2)
3. Jakmile zavřete terminál na lokálním počítači, přeruší se vzdálené připojení okamžitě? → Tvrdé omezení řešení typu zrcadlení obrazovky; musíte přejít na architekturu s trvale běžícím démonem. (§3)
4. Zaseklo se to ve stavu „zobrazuje se online, ale zprávy nereagují“? → Polomrtvé spojení; dokáže ho automaticky zachránit pouze detekce heartbeat. (§4)
5. Po znovupřipojení je relace prázdná / zprávy chybí? → Potřebujete „návrat k původní relaci + přehrání historie“. (§5)
6. Ztratíte relaci pouze při dlouhém výpadku? → Potřebujete ukládání na disk + studené zotavení. (§6)

Jak to vypadá v konkrétním řešení

Z výše uvedených šesti bodů je pouze bod 1 otázkou nastavení vašeho vlastního počítače; zbývajících pět je určeno architekturou – je to zadáno už při výběru řešení a po vzniku problému to nelze opravit laděním parametrů.

Spolehlivé řešení bez výpadků musí zároveň mít: trvale běžícího démona na straně vývojového stroje (odpovídá zbývajícímu riziku §1 a §3), automatické znovupřipojení + ústup (§2), detekci heartbeat (§4), znovupřipojení k původní relaci + přehrání historie (§5) a studené zotavení z disku (§6).

Sada PandaNpc + pandapaw byla vytvořena přesně podle těchto šesti bodů: pandapaw se na vývojovém stroji zaregistruje jako trvale běžící démon s automatickým spuštěním (ne terminálové okno, které musíte ručně otevřít; po pádu se automaticky znovu spustí); zobrazovací strana se po výpadku automaticky znovu připojí s ústupem; na spojení běží heartbeat, a když nepřijde odpověď, vyhodnotí se jako polomrtvé a aktivně se znovu připojí; po znovupřipojení se automaticky přihlásí zpět k původní relaci a přehraje historii z doby výpadku; i když je proces relace uvolněn, stačí poslat jednu zprávu a obnoví se z disku studeným zotavením.

Jak přesně nainstalovat a připojit, viz Vzdálený přístup k Claude Code; prohlížení relací a schvalování nástrojů na mobilu viz Claude Code na mobilu.

Dodatečná past: pozor na fakturaci při vzdáleném provozu

Při diagnostice výpadků je snadné mimochodem přepnout na claude -p (headless režim), ale od 15. června 2026 Anthropic upravil fakturaci – headless už nevyužívá předplatný limit, ale spotřebovává malý měsíční kredit SDK, a po jeho vyčerpání se účtuje podle API; při intenzivním používání snadno překročíte rozpočet. Interaktivní režim (claude REPL) nadále využívá předplatný limit. Při změně řešení a diagnostice výpadků dejte pozor, abyste omylem nezměnili také fakturační režim.