Sommaire
Vous avez installé Claude Code, mais taper claude dans le terminal donne ceci — ça vous parle ?
zsh: command not found: claude
bash: claude: command not found
'claude' is not recognized as an internal or external command # WindowsCette erreur signifie « l'exécutable claude est introuvable », et la cause est presque toujours « le dossier d'installation n'est pas dans votre PATH ». L'installation elle-même a souvent réussi — le shell ne sait simplement pas où chercher. Cet article couvre les méthodes et emplacements d'installation, la correction du PATH, les conflits entre plusieurs installations, les pièges propres à Windows et la mise à jour — le tout fondé sur les informations officielles.
Les points clés d'emblée. (1) command not found n'est presque toujours que « ~/.local/bin (le dossier d'installation) n'est pas dans le PATH » — ajoutez-le, redémarrez le terminal et tout fonctionne. (2) Une erreur de permission npm (EACCES) ne doit PAS être corrigée avec sudo — passez plutôt à l'installeur natif. (3) En cas de blocage, lancez claude doctor — il vérifie d'un coup l'état de l'installation, les réglages et le résultat de la mise à jour. Les commandes exactes et les valeurs par défaut évoluent selon la version, alors vérifiez les dernières dans la documentation officielle.
Installé, mais introuvable
— le dossier d'installation n'est tout simplement pas dans le PATH
Le binaire existe bel et bien. C'est juste que le PATH du shell ne liste pas son emplacement.
La solution est donc « ajouter une ligne au PATH » — généralement moins d'une minute.
1. Ce que cette erreur vous dit vraiment
Lorsque vous tapez une commande, le shell (zsh / bash / PowerShell) parcourt dans l'ordre les dossiers listés dans la variable d'environnement PATH et exécute le premier exécutable correspondant. command not found: claude signifie qu'aucun de ces dossiers ne contenait claude.
L'important : cela ne veut pas forcément dire que l'installation a échoué. L'installeur natif place claude dans ~/.local/bin (Windows : %USERPROFILE%\.local\bin), mais si ce dossier n'est pas dans le PATH, le binaire existe sans que le shell puisse le trouver. Ainsi, la plupart des cas se règlent en « ajoutant une ligne au PATH et en redémarrant le terminal ». Avant de soupçonner un échec d'installation, lancez ls ~/.local/bin/claude pour vérifier si le binaire est bien présent.
Sous Windows, une « mauvaise console » pour la commande d'installation (par exemple, exécuter la commande PowerShell dans CMD) produit des erreurs différentes — abordées au §4. Commençons par bien fixer les méthodes et emplacements d'installation corrects.
2. Méthodes d'installation et emplacement du binaire
Voici les principales méthodes d'installation en 2026 et l'endroit où le binaire atterrit (l'installeur natif est recommandé).
| Méthode | Commande (forme) | Emplacement / remarque |
|---|---|---|
| Natif (recommandé) mac/Linux | curl -fsSL https://claude.ai/install.sh | bash | ~/.local/bin/claude. Mise à jour automatique |
| Natif (recommandé) Windows | Dans PowerShell : irm https://claude.ai/install.ps1 | iex | %USERPROFILE%\.local\bin\claude.exe |
| npm | npm install -g @anthropic-ai/claude-code | Nécessite Node 18+. Installe le même binaire natif |
| Homebrew (mac) | brew install --cask claude-code | Pas de mise à jour auto → brew upgrade |
| WinGet (Windows) | winget install Anthropic.ClaudeCode | Pas de mise à jour auto → winget upgrade |
L'essentiel : l'installeur natif est officiellement recommandé. La version npm installe le même binaire natif (Node 18+ n'est requis qu'au moment de l'installation ; le binaire n'a pas besoin de Node pour s'exécuter), mais elle est plus sujette aux problèmes de permissions et de PATH. Pour une nouvelle installation, le natif est le choix sûr. À noter qu'installer uniquement l'extension VS Code embarque un CLI privé dans l'extension et n'ajoute PAS claude au PATH — si vous voulez claude dans le terminal, installez-le séparément.
3. Principales causes et solutions
Voici les causes fréquentes autour de command not found, associées à leurs solutions.
Principaux facteurs install / PATH
~/.local/bin est hors du PATH. Ajoutez export PATH="$HOME/.local/bin:$PATH" à ~/.zshrc/~/.bashrc et redémarrez le terminal.sudo npm (officiellement déconseillé). Passer à l'installeur natif est la solution la plus rapide et la plus sûre.which -a claude (Win : where.exe claude) et ne gardez que la version native.Could not find native binary package ... apparaît quand vous avez installé avec les dépendances optionnelles ignorées. Réinstallez sans --omit=optional, etc.
En cas de doute, « réinstaller via l'installeur natif » résout la plupart de ces cas —
cela contourne d'un seul coup les problèmes de permissions, de Node et de conflit.
Un exemple concret de correction du PATH (macOS zsh) : echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc puis source ~/.zshrc. Sous Linux bash, faites de même dans ~/.bashrc. Après le changement, ouvrez un nouveau terminal.
4. Pièges propres à Windows
Sous Windows, l'échec classique consiste à exécuter la commande d'installation dans la « mauvaise console ». L'erreur affichée indique de quelle confusion il s'agit.
Repérer la confusion de console
| Erreur | Signification et solution |
|---|---|
'irm' is not recognized ... | Commande PowerShell exécutée dans CMD → utilisez PowerShell : irm ... | iex |
The token '&&' is not valid | Commande CMD exécutée dans PowerShell → utilisez la commande CMD |
'bash' is not recognized ... | Installeur Linux exécuté sous Windows → utilisez l'installeur PowerShell |
Autres remarques Windows : (1) Redémarrez le terminal après l'installation (un changement de PATH ne prend effet que dans un nouveau terminal). (2) Un ancien Claude Desktop qui a enregistré WindowsApps\Claude.exe peut faire lancer l'application de bureau au lieu du CLI quand vous tapez claude — mettez Claude Desktop à jour. (3) Si Git Bash est introuvable, pointez CLAUDE_CODE_GIT_BASH_PATH dans les réglages vers votre bash.exe. Exécuter sous WSL est aussi une option.
5. Mise à jour automatique et manuelle
Les installations natives se mettent à jour automatiquement en arrière-plan et prennent effet au prochain lancement. Pour mettre à jour manuellement, utilisez claude update ; pour réinstaller/figer une version précise, utilisez claude install <version> (accepte aussi stable / latest). Vérifiez le résultat de la mise à jour avec claude doctor.
Quand la mise à jour auto échoue sur l'installation npm
Si le dossier global de npm n'est pas accessible en écriture, la mise à jour automatique échoue. claude doctor liste les correctifs, et la solution de fond est de migrer vers une installation native. Pour simplement arrêter la mise à jour automatique, définissez DISABLE_AUTOUPDATER dans la section env des réglages (les mises à jour manuelles restent possibles) ; pour bloquer toutes les mises à jour, définissez DISABLE_UPDATES.
6. La démarche de diagnostic
Quand la cause n'est pas claire, procédez du haut vers le bas. La plupart des cas se résolvent dès l'étape 3.
Isolez le problème du haut vers le bas
claude doctor (depuis le shell s'il ne démarre pas) pour vérifier l'état de l'installation.which -a claude / where.exe claude pour voir où et combien de versions sont installées (conflits ?).~/.local/bin au PATH et redémarrez le terminal.
La règle : « le binaire existe-t-il → est-il dans le PATH → y a-t-il un conflit ? » dans cet ordre.
En cas de blocage, une réinstallation native est le recours fiable.
Conclusion
Le « command not found: claude » de Claude Code n'est, dans la plupart des cas, que « le dossier d'installation (~/.local/bin) n'est pas dans le PATH ». Le binaire existe, alors ajoutez une ligne au PATH, redémarrez le terminal et tout fonctionne. Pour l'installation, l'installeur natif est recommandé (la version npm exige Node 18+ et comporte davantage de pièges de permissions/PATH). Une erreur EACCES de npm se corrige en passant au natif, pas avec sudo.
Diagnostiquez avec (1) claude doctor -> (2) which -a claude / where.exe claude pour les conflits -> (3) ajout de ~/.local/bin au PATH -> (4) suppression des versions superflues -> (5) réinstallation native. Sous Windows, attention à la confusion de console (par exemple irm dans CMD), à la nécessité de redémarrer le terminal, et à l'ancien conflit Claude Desktop Claude.exe. Mettez à jour avec claude update / claude install, et arrêtez la mise à jour auto avec DISABLE_AUTOUPDATER. En cas de blocage, une réinstallation native est la solution fiable. À lire aussi : le récapitulatif des erreurs Claude Code, les erreurs d'authentification / connexion.
FAQ
Q. Je l'ai installé, mais j'obtiens command not found: claude.
A. Presque à coup sûr, le dossier d'installation n'est pas dans votre PATH. Vérifiez d'abord si le binaire existe avec ls ~/.local/bin/claude (Windows : %USERPROFILE%\.local\bin) ; s'il est là, ajoutez export PATH="$HOME/.local/bin:$PATH" à ~/.zshrc/~/.bashrc puis ouvrez un nouveau terminal. L'installation elle-même a généralement réussi.
Q. npm install -g échoue avec une erreur de permission (EACCES).
A. N'utilisez pas sudo npm (officiellement déconseillé ; cela attire les problèmes de permissions et de sécurité). Le plus rapide et le plus sûr est de passer à l'installeur natif (mac/Linux : curl -fsSL https://claude.ai/install.sh | bash). La build native n'a aucun piège de permission et ne nécessite pas Node. Vous pouvez aussi déplacer le prefix global de npm vers un dossier accessible en écriture par l'utilisateur, mais la recommandation officielle est le natif.
Q. J'ai plusieurs installations de claude et c'est une ancienne version qui s'exécute.
A. Lancez which -a claude (Windows : where.exe claude) pour voir tous les claude présents dans le PATH. Vous avez peut-être un mélange de npm-global, Homebrew, WinGet et natif. Gardez la version native (~/.local/bin) et supprimez les autres (par exemple npm uninstall -g @anthropic-ai/claude-code) pour n'avoir plus qu'une seule installation.
Q. Sous Windows, taper claude ouvre l'application de bureau.
A. Un ancien Claude Desktop a enregistré WindowsApps\Claude.exe, et il a la priorité sur le CLI dans le PATH. Mettez Claude Desktop à jour pour résoudre cela. De plus, si après l'exécution de l'installeur PowerShell il reste introuvable ou affiche une ancienne version, redémarrez le terminal pour que le changement de PATH prenne effet.
Q. Les mises à jour ne fonctionnent pas / je veux les arrêter.
A. Les installations natives se mettent à jour automatiquement en arrière-plan et prennent effet au prochain lancement. Manuellement, utilisez claude update ; pour réinstaller/figer, claude install <version>. Si la mise à jour auto échoue sur une installation npm globale, c'est un problème de permission d'écriture — suivez claude doctor et migrez vers le natif. Pour arrêter la mise à jour auto, définissez DISABLE_AUTOUPDATER dans la section env des réglages ; pour bloquer toutes les mises à jour, définissez DISABLE_UPDATES.
