Installer Node.js et Claude Code proprement sur Windows
MAJ du 12 avril 2026
Vous avez installé Node.js, suivi la vidéo à la lettre, et au moment de lancer Claude Code votre terminal répond « node n'est pas reconnu ». Le programme est bien là. Windows ne sait simplement pas où le trouver, et c'est ce mur invisible qui bloque tout pilotage d'une IA depuis votre terminal.
Cette masterclass vous explique pourquoi Windows perd vos programmes (le fameux PATH) et vous fait installer Node.js, npm et Claude Code proprement, pour que la commande réponde du premier coup.
Ce que cet exercice ne peut pas casser
L'exercice est un pur diagnostic : trois commandes qui lisent des numéros de version, n'installent rien, ne suppriment rien, ne modifient rien. Au pire, le terminal répond « pas reconnu », et c'est précisément l'information qu'on cherche. Vous ne touchez aux variables d'environnement qu'en dernier recours, guidé pas à pas.
Ce que vous saurez faire à la fin
- Diagnostiquer en une commande si Node.js est installé ou non, et lire ce que le terminal vous dit vraiment.
- Comprendre ce qu'est le PATH, la vraie cause de neuf installations ratées sur dix.
- Installer Node.js et npm avec la bonne case cochée, pour que la commande réponde du premier coup.
- Installer Claude Code et le lancer depuis n'importe quel dossier.
- Réparer un PATH cassé à la main quand l'installateur a échoué.
- Niveau membre· un prompt prêt à coller qui transforme ce parcours en checklist personnalisée selon votre machine, et vous guide message d'erreur par message d'erreur.
- Niveau Pro· je débloque votre installation en direct quand elle résiste, sur votre écran.
Une étape pose le décor, une explique le PATH, quatre installent et vérifient, la dernière répare quand tout le reste a échoué.
Pourquoi sept étapes, et pas une
Installer Node.js sur Windows, sur le papier, c'est cliquer sur Suivant trois fois. Si la méthode compte sept étapes, ce n'est pas pour faire savant : chaque étape neutralise un endroit précis où ça casse en silence, et où vous perdez une heure sans comprendre. La vraie difficulté de Windows n'est pas l'installation, c'est le PATH. Une étape pose le décor, une étape l'explique, quatre étapes installent et vérifient, une dernière répare quand tout le reste a échoué. Retirez-en une et vous reproduisez exactement le piège dans lequel tombent neuf personnes sur dix.
1Voir l'état actuel : savoir d'où vous partezdoute : « et si c'était déjà installé ? »
Avant de toucher à quoi que ce soit, regardez ce qui est déjà là. Ouvrez PowerShell : cherchez PowerShell dans le menu Démarrer, clic droit, Exécuter en tant qu'administrateur. Tapez ensuite la commande de version de Node.js : node, un espace, deux tirets collés, puis le mot version. Deux réponses possibles. Un numéro, par exemple v22.12.0 : Node.js est déjà là, vous sautez directement à l'installation de Claude Code. Ou « pas reconnu » : Node.js n'est pas installé, ou il l'est mais Windows ne le trouve pas. Cette étape existe pour vous éviter de réinstaller par-dessus une installation qui marchait déjà, et de créer des conflits.
2Comprendre le PATH : la cause de neuf erreurs sur dixdoute : « pourquoi « pas reconnu » alors que c'est installé ? »
Le PATH est une liste de dossiers où Windows va chercher quand vous tapez une commande. Vous tapez node, Windows ouvre cette liste, regarde dans chaque dossier, et s'il ne trouve node nulle part, il répond « pas reconnu ». Le programme peut être parfaitement installé sur votre disque : si son dossier n'est pas dans la liste, il n'existe pas aux yeux de Windows. Cette étape ne se fait pas dans le terminal, elle se fait dans votre tête. Trente secondes pour comprendre ça vous économisent deux heures de forums. Sur Mac, l'installateur range tout au bon endroit tout seul. Sur Windows, il le fait aussi, mais seulement si vous cochez la bonne case à l'installation. Et beaucoup de gens la décochent sans le savoir.
3Installer Node.js avec la bonne case cochéedoute : « quelle version télécharger ? »
Allez sur le site officiel, nodejs.org, et téléchargez la version LTS (Long Term Support), le gros bouton mis en avant. Lancez l'installateur et avancez. Sur l'écran des options, deux cases comptent. Cochez Automatically install the necessary tools. Et surtout, ne décochez jamais Add to PATH : c'est cette case qui vous épargne l'étape 7 et la moitié des forums Stack Overflow. Si elle est décochée, Node.js s'installe mais reste invisible pour Windows.
4Fermer et rouvrir le terminal : l'étape qu'on oublie tousdoute : « pourquoi ça ne marche toujours pas ? »
Le PATH est lu une seule fois, au démarrage du terminal. Si vous avez installé Node.js pendant que PowerShell était ouvert, votre terminal travaille encore avec l'ancienne liste, sans Node.js dedans. Il ne le verra jamais tant que vous ne le redémarrez pas. Fermez PowerShell, rouvrez-le, puis tapez la commande de version pour node, puis pour npm. Vous devez voir deux numéros de version, par exemple v22.12.0 et 10.9.0. npm s'installe tout seul avec Node.js, vous n'avez rien à faire de plus pour lui.
5Installer Claude Codedoute : « encore un installateur à télécharger ? »
Maintenant que npm répond, une seule ligne installe Claude Code pour toute votre machine : npm install -g @anthropic-ai/claude-code. Le -g veut dire global : Claude Code devient disponible partout, pas seulement dans un projet. npm télécharge les paquets, ça prend trente à soixante secondes, et à la fin vous ne devez voir aucune ligne en rouge.
6Vérifier que tout réponddoute : « comment être sûr que c'est gagné ? »
Tapez la commande de version pour claude : vous devez voir un numéro de version. Puis tapez claude tout court : Claude Code démarre et vous demande de vous connecter à votre compte. Si vous voyez ces deux choses, vous avez gagné. Votre IA tourne sur votre machine, depuis n'importe quel dossier.
7Réparer un PATH cassé à la main (le filet de sécurité)doute : « et si node reste introuvable ? »
Si après tout ça node reste introuvable, c'est que le PATH n'a pas été mis à jour automatiquement. On le répare à la main. Menu Démarrer, tapez variables d'environnement, ouvrez Modifier les variables d'environnement système, puis le bouton Variables d'environnement. Dans la section Variables système, trouvez Path, cliquez sur Modifier, puis Nouveau, et ajoutez ces deux lignes, une par une : C:\Program Files\nodejs\ et %APPDATA%\npm. Validez par OK partout, fermez et rouvrez PowerShell, retestez la version de node. Vous venez de faire à la main ce que la case Add to PATH aurait fait pour vous.
On commence tout de suite : votre diagnostic en quatre lignes
Ne touchez à rien encore. Prenez une feuille : c'est ce diagnostic qui vous dira quoi faire, au lieu de cliquer au hasard.
Le résultat, en 30 secondes
À partir de vos seules sorties de commande et du message d'erreur exact, le prompt vous renvoie votre point de départ et la seule action à faire maintenant, en clair.
Votre point de départ : Node.js est bien installé, mais Windows ne le trouve pas, le PATH est cassé. Rien de grave, on répare en deux minutes. L'action à faire maintenant : ouvrez le menu Démarrer, tapez variables d'environnement, on ajoute un seul chemin, ensemble, et on vérifie aussitôt. Si ça casse : si node reste introuvable après redémarrage, dites-le-moi, c'est le deuxième chemin (%APPDATA%\npm) qui manque.
Le prompt prêt à coller
# RÔLE Tu es un assistant d'installation technique, spécialiste de Node.js, npm et Claude Code sur Windows, patient avec un débutant total. Ton exigence : que la commande finisse par répondre, sans jamais me faire taper quelque chose au hasard. Tu ne t'appuies QUE sur ce que je te donne (mes sorties de commande, mes messages d'erreur, ma version de Windows). Ce que tu ne sais pas, tu me le demandes. Tu n'inventes jamais un chemin de dossier ni une version : si tu n'es pas sûr, tu me fais vérifier. # CONTEXTE Je suis sur Windows et je veux que `node`, `npm` et la commande `claude` répondent depuis n'importe quel dossier. Voici ma situation actuelle (je colle ce que j'ai, je laisse vide ce que je n'ai pas) : - Version de Windows (10 ou 11) : [collez ici]
Écrire ce diagnostic à la main et le suivre étape par étape, c'est faisable, mais c'est long quand on débute et qu'on panique devant un terminal. Le prompt prêt à coller transforme tout ça en checklist personnalisée pour votre machine : il lit vos sorties de commande et vos messages d'erreur exacts, et vous donne une seule action à la fois, jusqu'à ce que claude réponde. Laissez votre email, je vous l'envoie.
Vérifiez que c'est à vous
Vous venez d'installer Node.js pendant que PowerShell était resté ouvert. Vous tapez node et le terminal répond « pas reconnu ». Que faites-vous en premier ?
D'abord avec vos mots, sans regarder les options :
Expliquez-le pour l'ancrer
En une phrase, à un collègue qui vient de voir « pas reconnu » : comment un programme parfaitement installé peut-il rester invisible pour Windows ? Si vous savez l'expliquer avec le mot PATH, c'est à vous.
Ce que vous savez faire maintenant
- Lire « pas reconnu » comme une information (le dossier manque dans le PATH), plus jamais comme une panne.
- Installer Node.js, npm et Claude Code dans le bon ordre, avec la case Add to PATH cochée.
- Réparer un PATH cassé à la main, avec les deux chemins exacts à ajouter.
Une commande qui répond « pas reconnu », ce n'est plus une panique, c'est une information.
Continuez seul
Une fois claude qui répond, marche suivante du parcours : configurer votre première IA.
Installer et configurer Claude Code de A à Z →Faites-le avec moi
Je débloque votre installation en direct, sur votre écran : PATH qui résiste, antivirus qui bloque npm, deux versions de Node.js qui se télescopent. Vous ne perdez plus votre soirée sur les forums.