Kody błędów Claude Code – diagnostyka

Typowa przyczyna: Katalogu instalacji nie ma w PATH albo bieżąca powłoka nie wczytała ponownie konfiguracji.

Naprawa: Otwórz nowy terminal lub dodaj katalog instalacji Claude Code do PATH i wczytaj ponownie konfigurację powłoki.

export PATH="$PATH:$HOME/.local/bin"
source ~/.zshrc

Typowa przyczyna: Wersja Node jest niższa niż oficjalnie wymagana albo WSL wywołuje Node zainstalowany po stronie Windows.

Naprawa: Zaktualizuj Node lub użyj oficjalnego natywnego instalatora. W WSL sprawdź ścieżkę poleceniami which node / which npm, aby upewnić się, że pochodzi ze środowiska Linux.

node -v
which node
which npm

Typowa przyczyna: Globalny katalog npm należy do roota albo wcześniejsza instalacja przez sudo zostawiła błędne uprawnienia.

Naprawa: Nie instaluj Claude Code przez sudo. Zmień prefiks npm (prefix) na katalog użytkownika lub użyj natywnego instalatora.

npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"

Typowa przyczyna: Wywołanie zwrotne OAuth z przeglądarki nie dociera do lokalnego CLI — częste przy zdalnym SSH, devcontainerach, restrykcyjnych zaporach lub zablokowanych wywołaniach zwrotnych na localhost.

Naprawa: Upewnij się, że przeglądarka i CLI mogą się ze sobą komunikować na tym samym komputerze. W razie potrzeby wyloguj się, zrestartuj Claude Code i ponownie przeprowadź uwierzytelnianie.

/logout
# 关闭 Claude Code 后重新运行
claude

Typowa przyczyna: Firmowe proxy lub bramka bezpieczeństwa wstrzykuje certyfikat CA z podpisem własnym, któremu Node domyślnie nie ufa.

Naprawa: Poproś dział IT o firmowy pakiet CA i wskaż go przez NODE_EXTRA_CA_CERTS.

export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem

Typowa przyczyna: Zmienne proxy są błędnie ustawione, protokół proxy nie jest obsługiwany, NO_PROXY obejmuje domenę docelową lub firmowa zapora blokuje dostęp.

Naprawa: Claude Code korzysta ze standardowych zmiennych środowiskowych proxy HTTP/HTTPS; dokumentacja podaje, że proxy SOCKS nie są obsługiwane. Najpierw przetestuj ponownie z HTTPS_PROXY.

export HTTPS_PROXY=http://proxy.example.com:8080
echo $HTTPS_PROXY
echo $NO_PROXY

Typowa przyczyna: Organizacja nie włączyła Claude Code, firmowa biała lista (allowlist) nie obejmuje bieżącego wyjścia, obowiązują ograniczenia konta / regionu / zasad lub proxy jest odrzucane.

Naprawa: W przypadku kont osobistych najpierw sprawdź obsługiwane kraje i stan konta; w przypadku kont firmowych poproś administratora o sprawdzenie uprawnień Claude Code, SSO, białej listy IP i reguł zapory.

Typowa przyczyna: Żądania są zbyt częste, współbieżność jest zbyt wysoka albo plan konta lub organizacja osiągnęły limit zapytań.

Naprawa: Zmniejsz współbieżność w zewnętrznych skryptach, zatrzymaj pętle ponownych prób i poczekaj na zresetowanie limitu. Nie opakowuj Claude Code wieloma workerami, aby wymusić szybsze działanie.

Typowa przyczyna: Klucz API pochodzi z innej powłoki, klucz z Console koliduje z sesją OAuth albo organizacja wymaga logowania przez SSO.

Naprawa: Sprawdź, czy ANTHROPIC_API_KEY jest ustawiony w bieżącej powłoce. Konta firmowe powinny korzystać z procesu logowania Console/SSO wymaganego przez administratora.

echo $ANTHROPIC_API_KEY