Claude Code: zdalne zerwania połączenia — objawy, kryteria i rozwiązania dla sześciu typów rozłączeń

Zdalna praca z Claude Code — najbardziej irytujące nie jest to, że nie można się połączyć, tylko że połączenie się zrywa, a za każdym razem przyczyna jest inna.

Słowo „zerwanie połączenia” tak naprawdę obejmuje sześć zupełnie różnych awarii. Każda ma charakterystyczne objawy, a metody naprawy są od siebie niezależne — jeśli potraktujesz zerwanie długotrwałego połączenia spowodowane zmianą sieci jako uśpienie maszyny, wyłączenie trybu uśpienia nie pomoże; jeśli potraktujesz półotwarte połączenie jako słabą sieć i będziesz czekać, nie naprawi się samo nawet do rana.

W tym artykule wnioskujemy przyczynę odwrotnie, na podstawie tego, co faktycznie widzisz: dla każdego typu rozłączenia podajemy objawy, sposób potwierdzenia oraz odpowiednie rozwiązanie. Jeśli chcesz od razu działać, przejdź do listy kontrolnej w ostatniej sekcji.

Ten artykuł dotyczy wyłącznie diagnostyki zerwań połączenia. Jak skonfigurować zdalny dostęp, zobacz „Zdalny dostęp do Claude Code: steruj sesją z dowolnego miejsca bez lokalnego terminala”, a jak korzystać z telefonu — „Claude Code na telefonie: przeglądaj sesje i zatwierdzaj narzędzia na iOS”.

Najpierw dopasuj objawy: który przypadek widzisz

Połączenie zdalne składa się z dwóch segmentów: maszyna deweloperska uruchamiająca Claude Code ←→ twoje urządzenie podglądowe. Awaria dowolnego segmentu objawia się jako „zerwanie”, ale symptomy się różnią:

Co widzisz	Najprawdopodobniej	Przejdź do
Sesja nagle zamiera; po ponownym połączeniu widać, że postęp zatrzymał się w tym momencie	Uśpienie / zablokowanie ekranu maszyny deweloperskiej	§1
Zerwanie w momencie wejścia do windy, przełączenia na 4G, zmiany WiFi	Długotrwałe połączenie zostało przerwane	§2
Po zamknięciu lokalnego terminala lub uśpieniu komputera połączenie zdalne natychmiast się zrywa	Twarde ograniczenie rozwiązania typu mirroring	§3
Wyświetla „online”, ale wiadomości giną bez żadnego błędu	Połączenie półotwarte (half-open)	§4
Można się ponownie połączyć, ale sesja jest pusta / wiadomości z okresu rozłączenia zniknęły	Ponowne połączenie nie wróciło do oryginalnej sesji	§5
Po kilku godzinach ponowne połączenie — sesji nie ma	Proces został zakończony przez system i nie ma zimnego przywracania	§6

Najłatwiej o błędną diagnozę w przypadku czwartym: nie zgłasza błędów. Status połączenia jest zielony, wiadomości wychodzą, ale odpowiedź nie nadchodzi — trudniej to wykryć niż bezpośrednie rozłączenie, bo wszystkie wskaźniki mówią „wszystko działa”.

1. Uśpienie / zablokowanie ekranu / zamknięcie pokrywy maszyny deweloperskiej

Objawy: Sesja cała się zatrzymuje w pewnym momencie. Po ponownym połączeniu postęp wciąż jest w tym samym punkcie, ani o krok dalej.

Dlaczego: Wiele osób myśli „moja maszyna deweloperska jest cały czas włączona”, ale uśpienie systemu, sen po zamknięciu pokrywy i automatyczne blokowanie ekranu zawieszają lub całkowicie zabijają proces Claude Code. Po stronie podglądu widać po prostu „nagle przestało działać”.

Jak potwierdzić: Wróć do maszyny deweloperskiej i sprawdź, czy proces nadal istnieje oraz czy w dziennikach systemowych znajdują się wpisy o uśpieniu. Jeśli proces istnieje, ale jego znacznik czasu zatrzymał się w momencie zerwania, to najprawdopodobniej to.

Rozwiązanie: Ustaw plan zasilania maszyny deweloperskiej na „bez uśpienia / bez uśpienia po zamknięciu pokrywy”. To jedyny skuteczny sposób — żadne zdalne rozwiązanie nie pomoże maszynie, która już śpi.

2. Zmiana sieci powoduje przerwanie długotrwałego połączenia

Objawy: Zerwanie następuje w bardzo konkretnym momencie — wejście do windy, przełączenie z WiFi na 4G, nocne ponowne nawiązywanie połączenia przez domowe łącze.

Dlaczego: Zdalna synchronizacja w czasie rzeczywistym opiera się na długotrwałym połączeniu (WebSocket / SSH). Gdy IP się zmienia, połączenie natychmiast przestaje działać, bez żadnej negocjacji.

Jak potwierdzić: Jeśli moment zerwania pokrywa się z momentem zmiany sieci, to właśnie to.

Rozwiązanie: Tego rodzaju zerwań nie da się uniknąć; można je tylko ogarnąć za pomocą automatycznego ponownego łączenia + backoffu (1s→2s→5s…, aby nie bombardować połączenia zaraz po zerwaniu). Goły SSH nie ma tej możliwości — zerwanie to zerwanie, trzeba łączyć się ręcznie. To twardy wymóg przy wyborze rozwiązania.

3. Rozwiązanie typu mirroring: komputer lokalny musi działać na pierwszym planie

Objawy: Po zamknięciu lokalnego terminala lub uśpieniu komputera strona telefonu natychmiast się rozłącza. To nie jest powolny timeout, tylko całkowita utrata synchronizacji.

Dlaczego: Oficjalny Remote Control od Anthropic projektuje sesję uruchomioną na twoim komputerze na telefon/przeglądarkę. Zakłada, że Claude Code na komputerze działa cały czas na pierwszym planie, a komputer pozostaje online. Gdy komputer odpada, strona zdalna nie ma niezależnego cyklu życia, na którym mogłaby się oprzeć.

Jak potwierdzić: Zamknij okno terminala na komputerze i sprawdź, czy połączenie zdalne zrywa się w tej samej sekundzie. Jeśli tak, używasz rozwiązania typu mirroring.

Rozwiązanie: Przejdź na architekturę stałego demony po stronie maszyny deweloperskiej — strona uruchamiająca sesję staje się usługą w tle startującą automatycznie przy starcie systemu, żyjącą niezależnie od urządzenia podglądowego. Nawet jeśli urządzenie podglądowe zostanie zamknięte, wymienione lub utraci połączenie, sesja nadal działa na maszynie deweloperskiej. To zasadnicza różnica między „mirroringiem” a „usługą stałą”, nie da się jej wyregulować parametrami.

4. Połączenie półotwarte (half-open): najtrudniejszy do wykrycia przypadków

Objawy: Wyświetla status online, ale wiadomości nie otrzymują odpowiedzi i nie pojawiają się żadne błędy. Może zamrozić na kilka minut albo do momentu ręcznego ponownego połączenia.

Dlaczego: Gdy sieć cicho się przerywa (przekroczenie limitu czasu wpisów NAT, utrata stanu przez urządzenia pośrednie, sygnał tak słaby, że gubi pakiety, ale nie zrywa połączenia), obie strony TCP mogą myśleć, że nadal są połączone, podczas gdy dane już nie przechodzą. Bez heartbeat obie strony będą utrzymywać tę iluzję.

Jak potwierdzić: Status połączenia wydaje się normalny, ale wysłane wiadomości nie mają ani potwierdzenia dostarczenia, ani błędu; po ręcznym rozłączeniu i ponownym połączeniu wszystko natychmiast wraca — to właśnie to.

Rozwiązanie: Na połączeniu należy uruchomić heartbeat (keepalive ping): jeśli w ustalonym czasie nie nadejdzie żadna odpowiedź od drugiej strony, uznajemy połączenie za półotwarte i aktywnie rozłączamy się, by ponownie połączyć, zamiast czekać bezczynnie. Kryterium musi być „brak odpowiedzi”, a nie „brak błędów” — półotwarte połączenie nigdy nie zgłasza błędów.

5. Ponowne połączenie nie wraca do oryginalnej sesji / gubienie wiadomości

Objawy: Po zerwaniu można się ponownie połączyć, ale po powrocie sesja jest pusta albo zniknęły wszystkie wiadomości wysłane podczas przerwy.

Dlaczego: Ponowne połączenie tworzy tylko nowe połączenie, ale nie subskrybuje go z powrotem do oryginalnej sesji; wiadomości z okresu rozłączenia nie są również buforowane.

Jak potwierdzić: Po ponownym połączeniu identyfikator sesji się zmienił albo historia zaczyna się dopiero od momentu ponownego połączenia.

Rozwiązanie: Wybierz rozwiązanie, które po ponownym połączeniu automatycznie subskrybuje z powrotem oryginalną sesję i odtwarza historię z okresu rozłączenia. Jeśli można się tylko ponownie połączyć, ale nie wrócić do sesji, to jakby nie połączyć się wcale.

6. Proces sesji został zakończony przez system, a nie ma zimnego przywracania

Objawy: Krótkie rozłączenia i ponowne połączenia działają normal, ale po kilku godzinach sesja znika.

Dlaczego: Proces sesji pozostawionej na długi czas w stanie bezczynności może zostać zakończony przez system, a sam demon mógł zostać zrestartowany (aktualizacja, podniesienie po awarii). Stan sesji w pamięci znika wraz z tym.

Jak potwierdzić: Problem pojawia się tylko po dłuższym rozłączeniu, a nie po krótkim.

Rozwiązanie: Potrzebna jest możliwość zimnego przywracania — stan sesji jest zapisywany na dysku, więc nawet po utracie procesu kontekst można przywrócić z dysku. W idealnym przypadku wystarczy wysłać jedną wiadomość, a sesja automatycznie się przywróci i będzie kontynuowana — bez twojego udziału.

Lista kontrolna (możesz nią postępować niezależnie od rozwiązania)

Przejdź po kolei; każdy krok można niezależnie zweryfikować jako prawdziwy lub fałszywy:

1. Czy maszyna uruchamiająca sesję śpi / ma zablokowany ekran? → Wyłącz automatyczne uśpienie i uśpienie po zamknięciu pokrywy. (§1)
2. Czy moment zerwania pokrywa się z momentem zmiany sieci? → Potrzebne rozwiązanie z automatycznym ponownym łączeniem + backoffem; nie polegaj na gołym SSH. (§2)
3. Czy po zamknięciu lokalnego terminala połączenie zdalne zrywa się natychmiast? → Twarde ograniczenie rozwiązania typu mirroring; trzeba przejść na architekturę ze stałym demonem. (§3)
4. Utknąłeś na „wyświetla online, ale wiadomości nie mają odpowiedzi”? → Połączenie półotwarte; uratować może tylko wykrywanie heartbeat. (§4)
5. Czy po ponownym połączeniu sesja jest pusta / brakuje wiadomości? → Potrzebne „powrót do oryginalnej sesji + odtwarzanie historii”. (§5)
6. Czy sesja ginie tylko po dłuższym rozłączeniu? → Potrzebny zapis na dysk + zimne przywracanie. (§6)

W praktyce: konkretne rozwiązania

Z powyższych sześciu punktów tylko punkt 1 to kwestia ustawień twojej własnej maszyny; pozostałe pięć jest zdeterminowanych architekturą — są przesądzone na etapie wyboru rozwiązania, a po wystąpieniu problemu nie da się ich naprawić regulacją parametrów.

Niezawodne rozwiązanie zdalne musi jednocześnie zapewniać: stały demon po stronie maszyny deweloperskiej (odpowiada za pozostałe ryzyko z §1 i za §3), automatyczne ponowne łączenie + backoff (§2), wykrywanie heartbeat (§4), ponowne połączenie do oryginalnej sesji + odtwarzanie historii (§5) oraz zapis na dysk i zimne przywracanie (§6).

Zestaw PandaNpc + pandapaw został zaprojektowany dokładnie pod te sześć punktów: pandapaw rejestruje się na maszynie deweloperskiej jako stały demon uruchamiany przy starcie systemu (to nie okno terminala, które musisz trzymać otwarte ręcznie; po awarii zostanie automatycznie podniesiony); po stronie podglądu automatyczne ponowne łączenie z backoffem; na połączeniu działa heartbeat — brak odpowiedzi oznacza półotwarte połączenie i aktywne ponowne połączenie; po ponownym połączeniu automatycznie subskrybuje oryginalną sesję i odtwarza historię z okresu rozłączenia; nawet jeśli proces sesji zostanie zakończony przez system, wysłanie jednej wiadomości przywraca go z dysku i kontynuuje.

Konkretną instalację i podłączanie znajdziesz w „Zdalny dostęp do Claude Code”; przeglądanie sesji i zatwierdzanie narzędzi na telefonie — w „Claude Code na telefonie”.

Dodatkowa pułapka: nie wpadnij w opłaty przy zdalnym uruchamianiu

Podczas diagnozowania zerwań łatwo jest sięgnąć po claude -p (tryb headless), ale od 15 czerwca 2026 Anthropic zmienił zasady rozliczeń — headless nie korzysta już z limitu subskrypcji, tylko z niewielkiego miesięcznego kredytu SDK, a po jego wykorzystaniu rozliczany jest według API; intensywne używanie szybko prowadzi do przekroczenia budżetu. Tryb interaktywny (REPL claude) nadal korzysta z limitu subskrypcji. Zmieniając rozwiązanie podczas diagnostyki zerwań, uważaj, żeby nie zmienić przypadkiem także modelu rozliczeń.