Skip to content
Floskool

Chapter 2 · Installation et configuration

Les erreurs courantes et comment t'en sortir

Free lesson 8 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Le 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 doctor affiche 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.
  • claude introuvable : ouvre un nouveau terminal, sinon page de dépannage officielle.
  • Erreur avec && : tu es dans PowerShell ; erreur avec irm : tu es dans CMD.
  • claude --version et claude doctor sont tes deux outils de vérification.
  • En dernier recours, désinstalle et réinstalle avec la méthode native.