Chapitre 2 · Installation et configuration
Les erreurs courantes et comment t'en sortir
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementLe pourquoi : une erreur, ce n'est pas un échec
Le jour où Léa a installé Claude Code sur son ordinateur Windows, elle a vu apparaître un message rouge incompréhensible. Elle a cru avoir « cassé » quelque chose. En fait, elle avait juste collé la commande prévue pour CMD dans PowerShell. Une minute plus tard, tout fonctionnait.
La plupart des erreurs d'installation sont connues et documentées. Cette leçon te donne les plus fréquentes, d'après la documentation officielle, avec la sortie de secours pour chacune.
Le comment : lire le message, puis appliquer la bonne solution
Réflexe numéro un : lis le message d'erreur en entier. Souvent, il contient un mot qui te dit exactement ce qui ne va pas. Ensuite, compare-le avec la liste ci-dessous.
Erreur 1 : claude introuvable ou non reconnu
Ce que ça veut dire : l'installation s'est bien passée, mais le dossier où se trouve Claude Code n'est pas encore dans le PATH (la liste des dossiers où l'ordinateur cherche les commandes).
Solution : ferme ton terminal et ouvre-en un nouveau. Dans la plupart des cas, ça suffit. Sinon, suis la page de dépannage officielle : https://code.claude.com/docs/en/troubleshoot-install
Erreur 2 : The token '&&' is not a valid statement separator
Ce que ça veut dire : tu es dans PowerShell, mais tu as collé la commande prévue pour CMD.
Solution : utilise la commande PowerShell.
irm https://claude.ai/install.ps1 | iex
Erreur 3 : 'irm' is not recognized as an internal or external command
Ce que ça veut dire : l'inverse. Tu es dans CMD, mais tu as collé la commande PowerShell.
Solution : utilise la commande CMD.
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Rappel : dans PowerShell, l'invite affiche PS C:\ ; dans CMD, C:\ sans PS.
Erreur 4 : syntax error near unexpected token '<', erreur 403 ou autre message
Solution : ces cas sont traités sur la page de dépannage officielle. N'essaie pas de deviner : va lire https://code.claude.com/docs/en/troubleshoot-install
Erreur 5 : claude fonctionne encore après une désinstallation
Ce que ça veut dire : il existe une seconde installation (par exemple une installation via npm en plus de la native) ou un ancien alias (un raccourci de commande).
Solution : repère les méthodes que tu as utilisées et retire chaque installation selon sa méthode. Vérifie la documentation officielle pour la marche à suivre exacte.
Bloc à copier : ta routine de diagnostic
Quand quelque chose ne va pas, suis cette check-list dans l'ordre.
ROUTINE DE DIAGNOSTIC
- ☐ J'ai lu le message d'erreur en entier
- ☐ Je suis dans le bon terminal (PS C:\ = PowerShell, C:\ = CMD)
- ☐ J'ai ouvert un NOUVEAU terminal après l'installation
- ☐ claude --version affiche un numéro de version
- ☐ claude doctor ne signale pas d'erreur (ou j'ai noté ses suggestions)
- ☐ Sinon : page officielle troubleshoot-install
Et les deux commandes de vérification :
claude --version
claude doctor
Repartir de zéro : désinstaller proprement
Si vraiment rien ne va, tu peux désinstaller l'installation native et recommencer. Ces commandes suppriment Claude Code : utilise-les seulement si tu veux vraiment le retirer.
macOS, Linux, WSL :
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
Windows PowerShell :
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
Ensuite, réinstalle avec la commande native de la leçon 4.
Demander de l'aide à Claude Code lui-même
Une fois Claude Code lancé, tu peux aussi lui décrire un problème. Il ne remplace pas la documentation, mais il peut t'aider à comprendre un message.
J'ai eu ce message d'erreur : [colle le message].
Explique-moi en termes simples ce qu'il signifie, et propose-moi
une solution. Ne lance aucune commande sans me l'expliquer d'abord.
Si ça coince
- Le message d'erreur n'est dans aucune liste : copie-le tel quel et cherche-le sur la page de dépannage officielle.
claude doctoraffiche des avertissements : lis les corrections suggérées ; elles sont écrites pour être suivies.- Tu as tout essayé : désinstalle, ouvre un nouveau terminal, réinstalle avec la méthode native, puis vérifie avec
claude --version.
À toi de jouer
Ouvre volontairement le « mauvais » terminal (CMD si tu utilises PowerShell, ou l'inverse) et tape seulement irm puis Entrée, sans le reste de la commande. Observe le message obtenu. Tu sauras désormais reconnaître cette erreur en un coup d'œil. Puis lance claude doctor dans le bon terminal et note son verdict. Léa l'a fait, et elle n'a plus peur des messages rouges.
En bref
- Lis toujours le message d'erreur en entier avant d'agir.
claudeintrouvable : ouvre un nouveau terminal, sinon page de dépannage officielle.- Erreur avec
&&: tu es dans PowerShell ; erreur avecirm: tu es dans CMD. claude --versionetclaude doctorsont tes deux outils de vérification.- En dernier recours, désinstalle et réinstalle avec la méthode native.