Diagnostic des codes d'erreur Claude Code

Cause fréquente : Le répertoire d'installation n'est pas dans le PATH, ou le shell actuel n'a pas rechargé sa configuration.

Solution : Ouvrez un nouveau terminal, ou ajoutez le répertoire d'installation de Claude Code au PATH puis rechargez la configuration de votre shell.

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

Cause fréquente : La version de Node est inférieure à l'exigence officielle, ou WSL appelle le Node installé côté Windows.

Solution : Mettez Node à jour ou utilisez l'installateur natif officiel. Sous WSL, vérifiez avec which node / which npm que le chemin provient bien de l'environnement Linux.

node -v
which node
which npm

Cause fréquente : Le répertoire npm global appartient à root, ou une installation précédente avec sudo a laissé des autorisations incohérentes.

Solution : N'installez pas Claude Code avec sudo. Définissez le préfixe npm (prefix) sur un répertoire utilisateur, ou utilisez l'installateur natif.

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

Cause fréquente : Le callback OAuth du navigateur n'atteint pas la CLI locale, ce qui est fréquent en SSH distant, dans les devcontainers, derrière des pare-feu stricts ou quand les callbacks localhost sont bloqués.

Solution : Vérifiez que le navigateur et la CLI peuvent communiquer sur la même machine. Si nécessaire, déconnectez-vous, redémarrez Claude Code et refaites l'authentification.

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

Cause fréquente : Un proxy d'entreprise ou une passerelle de sécurité injecte une CA autosignée à laquelle Node ne fait pas confiance par défaut.

Solution : Demandez à votre service informatique le bundle CA de l'entreprise et indiquez-le via NODE_EXTRA_CA_CERTS.

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

Cause fréquente : Les variables de proxy sont mal configurées, le protocole du proxy n'est pas pris en charge, NO_PROXY exclut le domaine cible ou un pare-feu d'entreprise bloque l'accès.

Solution : Claude Code utilise les variables d'environnement standard de proxy HTTP/HTTPS ; la documentation indique que les proxys SOCKS ne sont pas pris en charge. Refaites d'abord le test avec HTTPS_PROXY.

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

Cause fréquente : L'organisation n'a pas activé Claude Code, la liste d'autorisation de l'entreprise n'inclut pas la sortie actuelle, des restrictions de compte, de région ou de politique s'appliquent, ou le proxy est refusé.

Solution : Pour un compte personnel, vérifiez d'abord les régions prises en charge et l'état du compte ; pour un compte entreprise, demandez à un administrateur de vérifier les autorisations Claude Code, le SSO, la liste d'autorisation d'IP et les règles du pare-feu.

Cause fréquente : Les requêtes sont trop fréquentes, la concurrence est trop élevée, ou l'offre du compte ou l'organisation a atteint une limite de requêtes.

Solution : Réduisez la concurrence côté appelant, arrêtez les boucles de nouvelles tentatives et attendez la réinitialisation de la limite. N'encapsulez pas Claude Code dans plusieurs workers pour forcer la vitesse.

Cause fréquente : La clé API provient d'un autre shell, une clé Console entre en conflit avec une session OAuth, ou l'organisation exige une connexion SSO.

Solution : Vérifiez si la variable ANTHROPIC_API_KEY est définie dans le shell actuel. Les comptes entreprise doivent suivre le parcours de connexion Console/SSO imposé par l'administrateur.

echo $ANTHROPIC_API_KEY