Claude Code: Connection reset (ECONNRESET) - jak naprawić

Claude Code

Claude Code: Connection reset (ECONNRESET) - jak naprawić

W skrócie

Połączenie z API zostało nawiązane, ale ktoś po drodze zamknął gniazdo w trakcie transmisji i Claude Code dostał ECONNRESET. Pokazujemy, jak namierzyć element sieci, który zrywa połączenie.

Jak to wygląda w praktyce

W terminalu widać Connection reset albo błąd z kodem ECONNRESET. Operacja przerywa się nagle, często w środku odpowiedzi, a nie po długim oczekiwaniu jak przy timeoucie.

Zrywanie bywa powtarzalne przy dłuższych zadaniach: krótkie zapytania przechodzą, a te trwające dłużej regularnie kończą się resetem połączenia.

Dlaczego tak się dzieje

Reset oznacza, że druga strona połączenia - najczęściej urządzenie sieciowe po drodze, a nie serwer API - nagle zamknęła gniazdo. Typowo robi to firewall albo proxy, które tną połączenia trwające dłużej niż ustawiony limit, albo firmowa inspekcja TLS, która rozłącza sesje, gdy nie potrafi ich przeanalizować.

Zobacz też: Szkolenie Claude Code - od zera do zespołu agentów AI

Do tego dochodzą przyczyny czysto sprzętowe i łączowe: niestabilne WiFi, VPN, który sam się rozłącza, oraz agresywne reguły bezpieczeństwa blokujące ruch do api.anthropic.com. Wszystkie prowadzą do tego samego skutku - połączenie umiera w trakcie.

Jak to rozwiązać krok po kroku

1. Sprawdź, czy w ogóle dochodzisz do API i czy połączenie jest stabilne: curl -v https://api.anthropic.com. Jeśli połączenie zrywa się w trakcie, zobaczysz to w logu curla.
2. Wyłącz VPN na próbę albo przełącz się na inną sieć bez VPN. Rozłączający się VPN to jedna z najczęstszych przyczyn resetu w trakcie sesji.
3. Jeśli firma wymusza proxy, upewnij się, że jest poprawnie ustawione przez HTTPS_PROXY, i sprawdź z IT, czy proxy nie przycina długich połączeń.
4. Poproś dział IT o odblokowanie i wpisanie na listę wyjątków hosta api.anthropic.com, żeby inspekcja TLS ani firewall nie zrywały sesji do tego adresu.
5. Przełącz się na stabilniejsze łącze - z WiFi na kabel - żeby wykluczyć zrywanie po stronie sygnału.
6. Ponów operację. Reset bywa jednorazowy i drugie podejście czasem przechodzi bez dalszych zmian.
7. Jeśli reset wraca tylko przy dłuższych zadaniach, poproś IT o sprawdzenie limitów czasu połączeń na firewallu i proxy - to typowa przyczyna zamykania długich sesji.

Jak sprawdzić, że zadziałało

Uruchom dłuższe polecenie w Claude Code, które wcześniej zrywało się resetem. Jeśli teraz kończy się poprawnie, element tnący połączenie został ominięty lub przestrojony.

Log z curl -v https://api.anthropic.com powinien pokazać zestawienie połączenia TLS i odpowiedź serwera bez nagłego zamknięcia. Czyste zakończenie żądania to znak, że po drodze nic już nie resetuje gniazda.

Wróć do listy problemów z Claude Code