Foutcodes van Claude Code oplossen

Veelvoorkomende oorzaak: De installatiemap staat niet in PATH, of de huidige shell heeft zijn configuratie nog niet opnieuw geladen.

Oplossing: Open een nieuwe terminal, of voeg de installatiemap van Claude Code toe aan PATH en laad je shellconfiguratie opnieuw.

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

Veelvoorkomende oorzaak: De Node-versie is lager dan de officiële eis, of WSL roept de Node aan de Windows-kant aan.

Oplossing: Werk Node bij of gebruik de officiële native installer. Controleer onder WSL met which node / which npm of het pad uit de Linux-omgeving komt.

node -v
which node
which npm

Veelvoorkomende oorzaak: De globale npm-map is eigendom van root, of een eerdere installatie met sudo heeft de rechten in de war gebracht.

Oplossing: Installeer Claude Code niet met sudo. Zet het npm-prefix op een gebruikersmap of gebruik de native installer.

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

Veelvoorkomende oorzaak: De OAuth-callback van de browser bereikt de lokale CLI niet - komt vaak voor bij remote SSH, devcontainers, strikte firewalls of geblokkeerde localhost-callbacks.

Oplossing: Controleer of browser en CLI elkaar op dezelfde machine kunnen bereiken. Log zo nodig uit, start Claude Code opnieuw en voer de authenticatie opnieuw uit.

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

Veelvoorkomende oorzaak: Een bedrijfsproxy of beveiligingsgateway injecteert een zelfondertekende CA die Node standaard niet vertrouwt.

Oplossing: Vraag IT om de CA-bundel van het bedrijf en geef die op via NODE_EXTRA_CA_CERTS.

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

Veelvoorkomende oorzaak: De proxyvariabelen zijn verkeerd ingesteld, het proxyprotocol wordt niet ondersteund, NO_PROXY overschrijft het doeldomein, of een bedrijfsfirewall blokkeert de toegang.

Oplossing: Claude Code gebruikt de standaard HTTP/HTTPS-proxyvariabelen; volgens de documentatie worden SOCKS-proxy's niet ondersteund. Test eerst opnieuw met HTTPS_PROXY.

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

Veelvoorkomende oorzaak: De organisatie heeft Claude Code niet ingeschakeld, de whitelist van het bedrijf bevat de huidige uitgang niet, er gelden beperkingen voor account, regio of beleid, of de proxy wordt geweigerd.

Oplossing: Controleer bij persoonlijke accounts eerst de ondersteunde regio's en de accountstatus; laat bij zakelijke accounts een beheerder de rechten voor Claude Code, SSO, de IP-whitelist en de firewallregels controleren.

Veelvoorkomende oorzaak: Er worden te veel verzoeken verstuurd, de gelijktijdigheid is te hoog, of het accountabonnement of de organisatie heeft een verzoeklimiet bereikt.

Oplossing: Verlaag de gelijktijdigheid in je eigen scripts, stop herhaalpogingen in een lus en wacht tot de limiet is gereset. Verpak Claude Code niet in meerdere workers om snelheid af te dwingen.

Veelvoorkomende oorzaak: De API-sleutel komt uit een andere shell, een Console-sleutel botst met een OAuth-sessie, of de organisatie vereist inloggen via SSO.

Oplossing: Controleer of ANTHROPIC_API_KEY in de huidige shell is ingesteld. Zakelijke accounts volgen de door de beheerder vereiste inlogprocedure via Console/SSO.

echo $ANTHROPIC_API_KEY