Ces dix problèmes représentent la grande majorité des tickets d'assistance liés à l'installation et l'authentification de Claude Code. Chaque entrée inclut la solution la plus fiable.
1. claude : commande introuvable immédiatement après l'installation.
L'installateur a ajouté claude à votre PATH, mais votre shell actuel ne l'a pas encore détecté. Ouvrez un nouveau terminal, ou exécutez source ~/.zshrc (ou ~/.bashrc). Sur Windows, fermez et rouvrez PowerShell.
2. npm install échoue avec EACCES / permission refusée.
Cela signifie généralement que l'installation a été exécutée avec sudo, ou que votre répertoire npm global appartient à root. N'utilisez pas sudo. À la place, utilisez l'installateur curl, ou corrigez le préfixe npm avec npm config set prefix ~/.npm-global et ajoutez ce répertoire bin à votre PATH.
3. "Version de Node non supportée" ou crash silencieux au lancement.
Claude Code nécessite Node 18 ou ultérieur. Vérifiez votre version avec node -v. Si elle est plus ancienne, installez une version actuelle via nvm install --lts, ou utilisez l'installateur curl, qui inclut son propre runtime et évite complètement ce problème.
4. WSL : claude exécute le Node Windows au lieu du Node Linux.
Le PATH Windows s'infiltre dans WSL et remplace nvm. Ajoutez votre node Linux au début du PATH dans ~/.bashrc : export PATH="$HOME/.nvm/versions/node/$(nvm current)/bin:$PATH"
5. L'installateur se bloque ou échoue derrière un réseau d'entreprise.
L'hôte de téléchargement (storage.googleapis.com) est probablement bloqué. Définissez d'abord votre proxy avec export HTTPS_PROXY=http://your-proxy:port, puis relancez l'installateur. Si ce n'est pas possible, demandez à votre équipe informatique le package hors ligne.
6. SELF_SIGNED_CERT_IN_CHAIN ou autres erreurs TLS.
Votre entreprise injecte son propre certificat. Pointez Node vers le bundle CA d'entreprise : export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem Ajoutez-le à votre profil shell pour qu'il persiste.
7. /login ouvre un navigateur mais le terminal ne finit jamais ("En attente d'authentification…").
Cela signifie généralement que le rappel localhost est bloqué, ce qui est courant sur SSH distant, dans les devcontainers, ou derrière un pare-feu strict. Utilisez plutôt le flux manuel : copiez l'URL affichée dans le terminal, complétez la connexion dans n'importe quel navigateur, puis collez le code retourné dans le terminal.
8. "Non authentifié" même si vous avez défini ANTHROPIC_API_KEY.
Il y a trois causes courantes : la clé a été exportée dans un shell différent (exécutez echo $ANTHROPIC_API_KEY pour vérifier), vous avez précédemment exécuté /login et la session OAuth a la priorité (exécutez d'abord /logout), ou la clé est une clé Console mais votre organisation nécessite plutôt une connexion SSO.
9. Bedrock / Vertex : "Impossible de charger les identifiants."
Claude Code utilise les SDK de fournisseur standard, donc la solution est la même que pour n'importe quel outil CLI AWS/GCP. Pour Bedrock, confirmez que aws sts get-caller-identity fonctionne et que AWS_REGION est défini sur une région où votre modèle est activé. Pour Vertex, confirmez que gcloud auth application-default login a été exécuté et que GOOGLE_CLOUD_PROJECT est défini.
10. Il s'est installé et authentifié, mais chaque requête génère une erreur 403 / "modèle non disponible."
Votre compte existe mais n'a pas accès au modèle que Claude Code demande. Pour les sièges Enterprise, confirmez que votre siège est actif dans les paramètres d'administration de votre organisation. Sur Bedrock ou Vertex, confirmez que le modèle Claude spécifique est activé dans cette région ou ce projet. Comme solution rapide, exécutez /model et sélectionnez un modèle auquel vous savez avoir accès.
Toujours bloqué ?
Exécutez claude doctor depuis votre shell normal (pas depuis une session Claude). Il affiche un rapport de diagnostic que vous pouvez joindre à un ticket d'assistance.