Claude Code fonctionne-t-il sur Windows ?

Claude Code peut être utilisé sur Windows via WSL2, l’environnement Linux intégré à Windows. C’est l’approche la plus fiable, car l’outil et son installation npm se comportent mieux dans un terminal Linux comme Ubuntu que dans un environnement Windows classique.

Quelle version de Node.js faut-il pour Claude Code ?

Il faut Node.js en version 18 ou supérieure. Pour limiter les conflits, je recommande une version LTS installée avec nvm, car elle permet de changer facilement de version si un projet ou un outil l’exige.

Faut-il une clé API Anthropic pour utiliser Claude Code ?

Claude Code nécessite une authentification Anthropic. Selon votre usage, vous pouvez vous connecter avec un compte compatible ou utiliser une clé API via la variable d’environnement ANTHROPIC_API_KEY. La clé ne doit jamais être copiée dans un dépôt Git.

Pourquoi npm affiche une erreur EACCES sur Mac ?

L’erreur EACCES apparaît quand npm n’a pas les droits d’écriture dans le dossier global utilisé pour installer les paquets. La bonne correction consiste à utiliser nvm ou à configurer un dossier global npm dans votre répertoire utilisateur, plutôt que d’utiliser sudo par réflexe.

Comment vérifier que Claude Code est bien installé ?

Lancez claude --version pour vérifier que la commande existe, puis ouvrez un dossier de projet et exécutez claude. Si l’outil démarre, accède au contexte du projet et ne renvoie pas d’erreur d’authentification, l’installation est opérationnelle.

Comment installer Claude Code sur Mac et Windows en 2026 ?

Claude Code s’installe avec Node.js, npm et une authentification Anthropic. Sur Mac, l’installation est directe. Sur Windows, je recommande WSL2 pour éviter les incompatibilités. Voici la méthode propre, les commandes utiles et les erreurs à corriger avant de coder depuis le terminal.

Quels prérequis faut-il vérifier ?

Il faut vérifier Node.js en version 18 ou supérieure, npm, un accès Anthropic valide et idéalement Git avant d’installer Claude Code.

Claude Code est un outil en ligne de commande créé par Anthropic. C’est-à-dire qu’il s’utilise depuis le terminal pour interagir avec un projet de code, lire des fichiers, proposer des modifications, expliquer une base existante ou aider à exécuter certaines tâches de développement.

Il ne remplace pas Git, votre éditeur de code ou vos tests automatisés. Il s’intègre plutôt dans votre flux de travail existant. Vous continuez à versionner votre code, relire les changements, lancer les tests et valider ce qui doit partir en production.

Les prérequis sont assez simples, mais autant les contrôler avant de perdre du temps sur une erreur d’installation.

Node.js sert à exécuter l’écosystème JavaScript sur votre machine. Claude Code s’appuie dessus pour fonctionner.
Npm, pour Node Package Manager, sert à installer le paquet @anthropic-ai/claude-code depuis le registre npm.
Git permet de travailler proprement dans un projet versionné. Claude Code peut ainsi mieux s’insérer dans un dépôt existant et vous gardez un historique clair des modifications.
Un compte Anthropic ou une clé API permet l’authentification. Sans accès valide, l’outil peut être installé, mais il ne pourra pas interagir correctement avec les modèles Claude.

Avant installation, lancez ces commandes dans votre terminal sur Mac, ou dans PowerShell, Windows Terminal ou WSL sous Windows.

node --version
npm --version
git --version

Les sources à vérifier restent les documentations officielles. La documentation Anthropic Claude Code précise les prérequis à jour. La documentation Node.js indique les versions LTS, c’est-à-dire les versions maintenues sur la durée. La documentation npm détaille l’installation globale des paquets. La documentation Microsoft WSL est utile si vous installez Claude Code dans un environnement Linux sous Windows.

Prérequis	Rôle	Commande de vérification	Statut
Node.js 18 ou supérieur	Exécuter l’environnement JavaScript nécessaire à Claude Code	node –version	Obligatoire
Npm	Installer le paquet @anthropic-ai/claude-code	npm –version	Obligatoire
Git	Travailler dans un projet versionné et garder un historique propre	git –version	Recommandé
Compte Anthropic ou clé API	Authentifier Claude Code auprès des services Anthropic	Vérification dans le compte Anthropic	Obligatoire

Comment installer Node.js proprement ?

La méthode la plus propre consiste à installer Node.js LTS via nvm ou Homebrew sur macOS, et via nvm dans Ubuntu sous WSL2 sur Windows. LTS signifie Long Term Support : c’est une version maintenue plus longtemps, donc plus adaptée à un usage stable que les versions “Current”, qui changent plus vite.

Évitez les installations bricolées, surtout les mélanges entre installateur officiel, Homebrew, npm global et anciens dossiers copiés à la main. Elles créent souvent des conflits de versions ou des erreurs de permission npm, par exemple quand npm essaie d’écrire dans un dossier système sans les bons droits.

Sur macOS, vous avez trois options propres, à choisir selon votre usage.

Homebrew convient si vous utilisez déjà ce gestionnaire de paquets macOS. La commande est simple :

brew install node

Nvm, pour Node Version Manager, est le meilleur choix si vous devez changer facilement de version Node.js selon vos projets. Installez nvm avec le script officiel du projet, puis lancez :

nvm install --lts
nvm use --lts

L’installateur officiel depuis nodejs.org reste acceptable si vous voulez une installation classique. Choisissez simplement une version LTS compatible, pas une version expérimentale.

Sur Windows, Claude Code fonctionne mieux dans un environnement Linux via WSL2, c’est-à-dire Windows Subsystem for Linux version 2. Microsoft recommande WSL2 pour exécuter un vrai environnement Linux intégré à Windows, avec de meilleures performances et une compatibilité plus complète que WSL1.

Ouvrez PowerShell en administrateur, puis lancez :

wsl --install

Redémarrez votre machine, créez l’utilisateur Ubuntu demandé au premier lancement, puis vérifiez ou forcez WSL2 avec :

wsl --set-default-version 2

Ensuite, installez nvm et Node.js dans Ubuntu, pas dans PowerShell Windows. C’est important : Claude Code travaillera dans l’environnement Linux, donc Node.js doit aussi y être installé.

nvm install --lts
nvm use --lts

Contrôlez enfin les versions installées :

node --version
npm --version

Si votre version de Node.js est inférieure à 18, mettez-la à jour avant d’aller plus loin.

Méthode	Simplicité	Contrôle des versions	Cas d’usage
Homebrew	Très simple	Moyen	Mac avec gestion centralisée des outils dev
Nvm	Simple	Excellent	Projets avec plusieurs versions de Node.js
Installateur officiel	Très simple	Faible	Usage basique avec une seule version
WSL2 + nvm	Moyen	Excellent	Windows avec environnement Linux propre pour Claude Code

Comment installer Claude Code avec npm ?

Claude Code s’installe globalement avec npm grâce à la commande npm install -g @anthropic-ai/claude-code.

Une installation globale npm signifie que l’exécutable claude devient disponible depuis n’importe quel dossier du terminal. Npm, le gestionnaire de paquets installé avec Node.js, place alors la commande dans un dossier de binaires global, lui-même référencé par la variable PATH. Cette variable indique au terminal où chercher les commandes que vous tapez.

L’installation doit se faire dans l’environnement où Node.js a été installé. Sur Mac, utilisez le terminal macOS. Sur Windows avec WSL2, utilisez le terminal Ubuntu si Node.js a été installé dans Ubuntu. Évitez de mélanger les environnements : une installation faite côté Windows ne rend pas automatiquement la commande disponible côté Linux, et inversement.

Les étapes sont simples :

Lancez l’installation globale avec npm.
Vérifiez que Claude Code répond avec sa version.
Démarrez Claude Code depuis le terminal.

npm install -g @anthropic-ai/claude-code
claude --version
claude

Si le terminal répond que la commande est introuvable, le problème vient souvent du PATH. Vérifiez où npm installe ses binaires globaux avec npm bin -g. Selon votre version de npm, utilisez aussi la configuration équivalente, par exemple npm prefix -g, puis le dossier bin associé sur macOS ou Linux.

npm bin -g
npm prefix -g

Sur macOS, une erreur fréquente est EACCES permission denied. Elle apparaît quand npm essaie d’écrire dans un dossier système sans les droits nécessaires. La solution recommandée par la documentation npm consiste à utiliser un gestionnaire de versions comme nvm, ou à configurer un répertoire global npm dans votre dossier utilisateur.

Voici une configuration propre avec un dossier global utilisateur :

mkdir ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

Si vous utilisez Bash au lieu de Zsh, adaptez le fichier de configuration :

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile

Évitez de lancer sudo npm install -g par réflexe. Cette commande peut masquer le problème, installer des fichiers avec le mauvais propriétaire et créer d’autres conflits de droits lors des mises à jour suivantes.

Comment authentifier Claude Code ?

L’authentification de Claude Code se fait soit avec un compte Anthropic compatible, soit avec une clé API Anthropic définie dans une variable d’environnement.

Le premier scénario est le plus simple si votre compte donne accès à Claude Code. Lancez la commande suivante dans votre terminal, puis suivez l’URL affichée.

claude

Une page s’ouvre dans le navigateur. Autorisez la connexion avec votre compte Anthropic, puis revenez dans le terminal. Si tout est valide, Claude Code récupère l’autorisation et peut commencer à fonctionner dans votre environnement local.

Le deuxième scénario consiste à utiliser une clé API Anthropic. Une clé API est un identifiant secret qui permet à un programme d’appeler les services Anthropic à votre place. Dans Claude Code, elle se configure avec la variable d’environnement ANTHROPIC_API_KEY.

Pour une session temporaire, valable uniquement dans le terminal actuel, utilisez cette commande avec zsh, bash, WSL ou Git Bash.

export ANTHROPIC_API_KEY=sk-ant-...

Pour garder cette configuration après redémarrage du terminal, ajoutez la variable dans le fichier de configuration de votre shell. Sur macOS, le shell par défaut est généralement zsh.

echo 'export ANTHROPIC_API_KEY=sk-ant-...' >> ~/.zshrc
source ~/.zshrc

Si vous utilisez bash, par exemple sur Linux, WSL ou certaines configurations Windows, utilisez plutôt ~/.bashrc.

echo 'export ANTHROPIC_API_KEY=sk-ant-...' >> ~/.bashrc
source ~/.bashrc

Une variable d’environnement est une valeur disponible pour les programmes lancés depuis le terminal. Elle sert souvent à stocker une configuration sensible, comme une clé API, sans l’écrire directement dans le code source. C’est pratique, mais ce n’est pas une protection magique.

Côté sécurité, quelques règles évitent les mauvaises surprises.

Ne commitez jamais une clé API dans Git, un fichier README ou un dépôt public.
Stockez vos secrets dans un gestionnaire adapté comme 1Password, Bitwarden, le trousseau macOS, Windows Credential Manager ou un secret manager cloud.
Révoquez immédiatement une clé exposée depuis la console Anthropic.
Vérifiez votre fichier .gitignore si un fichier local contient des secrets.

Une installation peut être correcte techniquement, avec la commande claude disponible, mais rester inutilisable tant que l’accès Anthropic n’est pas validé. Le test pratique du chapitre suivant permet de vérifier ce point sans ambiguïté.

Comment tester et corriger l’installation ?

Le test le plus fiable consiste à ouvrir un vrai dossier de projet, lancer claude, puis vérifier que Claude Code lit le contexte sans erreur.

Un test dans un dossier vide ne suffit pas toujours, car Claude Code prend surtout son intérêt quand il analyse des fichiers, comprend une arborescence et repère les conventions du projet.

Voici le test simple à faire juste après l’installation :

cd chemin/du/projet
git status
claude

Ouvrez un terminal, ou Ubuntu WSL sous Windows si vous avez installé Claude Code dans Linux via WSL, le sous-système Windows pour exécuter un environnement Linux.
Allez dans un vrai dossier de projet avec cd chemin/du/projet.
Lancez git status pour vérifier si le projet est suivi par Git, l’outil de versionnement qui permet de comparer et restaurer les changements.
Lancez claude.
Demandez une action non destructive, par exemple : “Analyse la structure du projet et explique le rôle des fichiers principaux”.

Les premiers échanges doivent rester en lecture seule. Demandez une analyse, une explication, une recherche de dette technique ou une synthèse des tests existants. Évitez de commencer par “corrige tout” ou “réécris ce module”.

Les bons réflexes sont simples : relire chaque modification proposée, utiliser Git pour comparer les changements, puis lancer les tests du projet avant d’accepter une modification importante. Si votre projet utilise npm, lancez par exemple npm test. Si c’est un projet Python, ce sera souvent pytest.

Les erreurs les plus fréquentes se corrigent vite quand on identifie leur origine :

L’erreur node command not found signifie que Node.js n’est pas installé ou que son chemin n’est pas dans le PATH, la variable système qui indique où chercher les commandes.
L’erreur claude command not found indique souvent un problème d’installation globale npm ou de PATH.
L’erreur EACCES signale un problème de droits avec npm, le gestionnaire de paquets de Node.js.
Une erreur d’authentification indique généralement un compte non connecté ou une variable ANTHROPIC_API_KEY absente ou incorrecte.
Sous Windows, une installation faite dans PowerShell alors que vous travaillez ensuite dans Ubuntu WSL peut créer deux environnements séparés et donc de la confusion.

Symptôme	Cause probable	Commande utile	Correction recommandée
Node command not found	Node.js absent ou PATH incomplet	node -v	Installer Node.js puis rouvrir le terminal
Claude command not found	Installation npm globale non trouvée	npm list -g –depth=0	Réinstaller Claude Code et vérifier le PATH npm
EACCES	Droits npm insuffisants	npm config get prefix	Configurer un répertoire npm utilisateur
Erreur d’authentification	Compte non connecté ou clé API invalide	echo $ANTHROPIC_API_KEY	Se reconnecter ou corriger la variable ANTHROPIC_API_KEY
Commande visible dans PowerShell mais pas dans WSL	Environnements Windows et Linux séparés	which claude	Installer et utiliser Claude Code dans le même environnement

Une fois le terminal, l’authentification et le projet validés, Claude Code peut être intégré dans une routine de développement réelle sans perdre le contrôle du code.

Prêt à utiliser Claude Code dans votre terminal ?

Installer Claude Code ne demande pas une configuration lourde, mais il faut respecter l’ordre : Node.js 18 ou plus, npm fonctionnel, installation du paquet, permissions propres, puis authentification Anthropic. Sur Mac, nvm ou Homebrew suffisent dans la majorité des cas. Sur Windows, WSL2 évite beaucoup de problèmes en travaillant dans un environnement Linux cohérent. Je recommande de tester l’outil dans un projet versionné avec Git et de commencer par des actions de lecture. Le bénéfice pour vous : un assistant de code directement dans le terminal, utilisable sans casser votre environnement de développement.

FAQ

Claude Code fonctionne-t-il sur Windows ?
Claude Code peut être utilisé sur Windows via WSL2, l’environnement Linux intégré à Windows. C’est l’approche la plus fiable, car l’outil et son installation npm se comportent mieux dans un terminal Linux comme Ubuntu que dans un environnement Windows classique.
Quelle version de Node.js faut-il pour Claude Code ?
Il faut Node.js en version 18 ou supérieure. Pour limiter les conflits, je recommande une version LTS installée avec nvm, car elle permet de changer facilement de version si un projet ou un outil l’exige.
Faut-il une clé API Anthropic pour utiliser Claude Code ?
Claude Code nécessite une authentification Anthropic. Selon votre usage, vous pouvez vous connecter avec un compte compatible ou utiliser une clé API via la variable d’environnement ANTHROPIC_API_KEY. La clé ne doit jamais être copiée dans un dépôt Git.
Pourquoi npm affiche une erreur EACCES sur Mac ?
L’erreur EACCES apparaît quand npm n’a pas les droits d’écriture dans le dossier global utilisé pour installer les paquets. La bonne correction consiste à utiliser nvm ou à configurer un dossier global npm dans votre répertoire utilisateur, plutôt que d’utiliser sudo par réflexe.
Comment vérifier que Claude Code est bien installé ?
Lancez claude –version pour vérifier que la commande existe, puis ouvrez un dossier de projet et exécutez claude. Si l’outil démarre, accède au contexte du projet et ne renvoie pas d’erreur d’authentification, l’installation est opérationnelle.

A propos de l’auteur

Je suis Franck Scandolera, responsable de l’agence webAnalyste et de l’organisme Formations Analytics. J’accompagne les entreprises sur le tracking avancé server-side, l’Analytics Engineering, l’automatisation No/Low Code avec n8n, l’intégration de l’IA dans les workflows métier et le SEO/GEO. J’ai travaillé pour des références comme Logis Hôtel, Yelloh Village, BazarChic, la Fédération Française de Football ou Texdecor. Si vous voulez intégrer des outils IA comme Claude Code dans vos équipes sans bricolage, contactez-moi.

Franck Scandolera

⭐ Analytics engineer, Data Analyst et Automatisation IA indépendant ⭐

Ref clients : Logis Hôtel, Yelloh Village, BazarChic, Fédération Football Français, Texdecor…

Mon terrain de jeu :

Data Analyst & Analytics engineering : tracking avancé (GA4, Matomo, Piano, GTM server, Tealium, Commander Act, e-commerce, CAPI, RGPD), entrepôt de données (BigQuery, Snowflake, PostgreSQL, ClickHouse), modèles (Airflow, dbt, Dataform), dashboards décisionnels (Looker, Power BI, Metabase, SQL, Python).
Automatisation IA des taches Data, Marketing, RH, compta etc : conception de workflows intelligents robustes (n8n, App Script, scraping) connectés aux API de vos outils et LLM (OpenAI, Mistral, Claude…).
Engineering IA pour créer des applications et agent IA sur mesure : intégration de LLM (OpenAI, Mistral…), RAG, assistants métier, génération de documents complexes, APIs, backends Node.js/Python.