Comment installer Claude Code et Codex CLI sous Windows

Les commandes PowerShell, CMD, WinGet et npm exactes pour installer Claude Code et Codex CLI sous Windows 10 et 11, quand choisir WSL, et comment corriger « claude n'est pas reconnu » et les autres erreurs.

Les deux CLI s'installent en une ligne sous Windows aujourd'hui. Les ennuis arrivent presque tous après cette ligne : un terminal qui ne trouve pas la commande, une stratégie d'exécution qui bloque npm, une vieille distribution WSL 1, une commande collée dans le mauvais shell. Ce guide donne les commandes exactes de chaque voie d'installation, puis les erreurs et leurs correctifs.

Ce qui est dit des deux CLI vient de la documentation d'Anthropic et d'OpenAI et des scripts d'installation eux-mêmes, lus le 16 novembre 2026, avec Claude Code 2.1.318 et Codex CLI 0.169.0. Les deux outils bougent vite : si une commande ci-dessous échoue, vérifie la page officielle liée dans chaque section.

La réponse courte. Ouvre PowerShell, pas CMD, et lance :

irm https://claude.ai/install.ps1 | iex
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Puis ouvre un nouveau terminal et lance claude --version et codex --version. Si Windows répond que claude n'est pas reconnu, la correction du PATH est dans le tableau des erreurs, plus bas.

Ce que chaque CLI demande sous Windows

Claude CodeCodex CLI
Version de WindowsWindows 10 1809 ou plus récent, Windows Server 2019 ou plus récentWindows 11 recommandé, Windows 10 récent en « best effort »
Processeurx64 ou ARM64, jamais 32 bitsx64 ou ARM64
CompteUn forfait Claude payant ou un compte ConsoleUn forfait ChatGPT ou une clé API OpenAI
Node.jsSeulement pour la voie npm, version 22 ou plusSeulement pour la voie npm
Git for WindowsOptionnelPas nécessaire
Sandbox sous Windows natifNon, seulement dans WSL 2Oui, sa propre sandbox Windows
Droits administrateur pour installerNonNon

Deux lignes de ce tableau surprennent. Claude Code n'exige plus Git for Windows : sans lui, il utilise PowerShell comme outil shell. Et Codex isole ses commandes dans une sandbox (un bac à sable) sous Windows natif, alors que Claude Code ne le fait que dans WSL 2.

Installer Claude Code sous Windows

La page d'installation d'Anthropic donne quatre voies. L'installeur natif est celle qu'elle recommande : il ne demande pas Node.js et se met à jour tout seul en arrière-plan.

VoieCommande
PowerShell (recommandée)irm https://claude.ai/install.ps1 | iex
CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
WinGetwinget install Anthropic.ClaudeCode
npm (Node.js 22+)npm install -g @anthropic-ai/claude-code@latest

Ce que chaque voie laisse derrière elle :

  • Installeur natif : claude.exe dans %USERPROFILE%\.local\bin, les versions dans %USERPROFILE%\.local\share\claude. L'installeur te prévient quand .local\bin n'est pas dans ton PATH, et il ne l'y ajoute pas pour toi.
  • WinGet : pas de mise à jour automatique. Tu mets à jour avec winget upgrade Anthropic.ClaudeCode, et Anthropic précise qu'une mise à jour peut échouer pendant que Claude Code tourne, parce que Windows verrouille l'exécutable.
  • npm : avec un Node.js plus ancien que la 22, l'installation se termine sur un avertissement EBADENGINE.

Pour rester une version derrière la dernière, sur le canal stable :

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

Vérifie ensuite l'installation. claude --version affiche la version, et claude doctor lance un diagnostic en lecture seule de l'installation et de ses réglages.

Si tu as Git for Windows, Claude Code cherche Git Bash dans C:\Program Files\Git, puis C:\Program Files (x86)\Git, puis le git de ton PATH. Pour en imposer un autre, règle CLAUDE_CODE_GIT_BASH_PATH dans le bloc env de ton settings.json. Il doit pointer vers un fichier nommé bash.exe ou sh.exe, pas git-bash.exe.

Installer Codex CLI sous Windows

La page Windows d'OpenAI est claire : utilise Codex en natif avec sa sandbox Windows par défaut, et prends WSL quand tes outils vivent déjà sous Linux. Une source est en retard : la page d'installation du dépôt GitHub dit encore « Windows 11 via WSL2 ». La documentation officielle a changé, et l'installeur aussi.

VoieCommande
Installeur PowerShellpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npmnpm install -g @openai/codex

L'installeur PowerShell est le plus simple. La lecture du script montre ce qu'il fait : il installe Codex dans %LOCALAPPDATA%\Programs\OpenAI\Codex\bin, ajoute ce dossier au PATH de ton utilisateur et à la session en cours, et te dit d'ouvrir une nouvelle fenêtre PowerShell. Relancer la même commande met Codex à jour. Avec npm, tu mets à jour en relançant la commande d'installation.

Connecte-toi ensuite. Lance codex et choisis Sign in with ChatGPT, ou lance codex login. Sur une machine sans navigateur, codex login --device-auth te donne un code à taper sur un autre appareil. codex login status te dit avec quel compte tu es connecté.

La sandbox Windows

Codex a trois implémentations de sandbox sous Windows :

  • mxc : celle qu'OpenAI recommande, sans réglage administrateur. Elle demande Windows 11 24H2 (build 26100.9278) ou 25H2 (build 26200.9278).
  • elevated : le repli préféré. Elle demande une mise en place unique approuvée par un administrateur.
  • unelevated : une isolation réseau plus faible, et aucun chemin en lecture seule.

Le choix se fait dans config.toml :

[features]
prefer_mxc = true

[windows]
sandbox = "elevated" # or "unelevated"

Si la sandbox échoue avec l'erreur 1385, Windows a refusé le type de connexion du compte de la sandbox. OpenAI demande alors CODEX_HOME/.sandbox/sandbox.log. Ne partage jamais le contenu de .sandbox-secrets/.

Windows natif ou WSL ?

Natif (PowerShell, CMD)WSL 2
Installer Claude Codeirm https://claude.ai/install.ps1 | iexcurl -fsSL https://claude.ai/install.sh | bash dans WSL
Installer Codexl'installeur PowerShellcurl -fsSL https://chatgpt.com/codex/install.sh | sh dans WSL
Sandbox de Claude Codeindisponibledisponible, avec bubblewrap et socat
Sandbox de Codexla sandbox Windowsla sandbox Linux
Où garder le dépôtn'importe oùsous ~/, pas sous /mnt/c/

Prends WSL 2 quand ton projet se compile et tourne sous Linux de toute façon, ou quand tu veux que Claude Code isole les commandes qu'il lance. Reste en natif quand ton projet est un projet Windows : .NET, scripts PowerShell, chemins Windows partout.

Trois règles si tu passes par WSL :

  1. WSL 2, jamais WSL 1. Codex ne prend plus en charge WSL 1 depuis la version 0.115. La sandbox de Claude Code refuse WSL 1 avec Sandboxing requires WSL2, et une installation sous WSL 1 peut échouer sur Exec format error. Convertis une distribution avec wsl --set-version <DistroName> 2.
  2. Installe et lance dans WSL. Lance la commande Linux dans le terminal WSL, pas dans PowerShell. C'est le Node.js de Windows appelé depuis WSL qui produit exec: node: not found : installe Node.js dans la distribution elle-même, avec son gestionnaire de paquets ou nvm.
  3. Garde le code dans le système de fichiers Linux. Les deux éditeurs te disent de garder le dépôt hors de /mnt/c/, et Anthropic précise que les recherches de Claude Code y sont moins complètes. Clone-le sous ton dossier personnel Linux.

« claude n'est pas reconnu » et les autres erreurs

Ce que tu voisPourquoiCorrectif
'claude' is not recognized as an internal or external command (CMD), The term 'claude' is not recognized (PowerShell)%USERPROFILE%\.local\bin n'est pas dans ton PATHL'ajouter au PATH de l'utilisateur (commandes plus bas), puis ouvrir un nouveau terminal
Toujours pas reconnu après l'ajoutLe terminal, ou l'éditeur qui le contient, a démarré avant le changementFermer et rouvrir le terminal, et l'éditeur si le terminal vit dedans
Pas reconnu juste après une mise à jourUne mise à jour coupée en plein échange n'a laissé aucun claude.exeRenommer le claude.exe.old.* le plus récent en claude.exe (commande plus bas)
'irm' is not recognizedTu as collé la ligne PowerShell dans CMDOuvrir PowerShell, ou prendre la ligne CMD
The token '&&' is not a valid statement separatorTu as collé la ligne CMD dans Windows PowerShellPrendre la ligne PowerShell
npm.ps1 cannot be loaded because running scripts is disabled on this systemLa stratégie d'exécution bloque le raccourci PowerShell de npmSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, ou appeler npm.cmd
Une erreur sur Windows 32 bits alors que le PC est en 64 bitsTu as ouvert « Windows PowerShell (x86) » depuis le menu DémarrerOuvrir le PowerShell 64 bits habituel
claude ouvre l'app de bureau au lieu du CLIUne ancienne app de bureau Claude a posé un Claude.exe dans WindowsApps, devant le CLI dans le PATHMettre à jour l'app de bureau Claude
requires either Git for Windows (for bash) or PowerShellClaude Code n'a trouvé aucun des deux shellsInstaller Git for Windows, ou vérifier que PowerShell est dans le PATH
EBADENGINE pendant npm installNode.js est plus ancien que la 22Mettre Node.js à jour, ou prendre l'installeur natif

La correction du PATH, dans PowerShell, pour l'utilisateur courant, sans droits administrateur :

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Pour voir où Windows cherche avant de changer quoi que ce soit :

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
where.exe claude

Le renommage après une mise à jour cassée :

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

Sur la stratégie d'exécution : Windows PowerShell 5.1, celui qui est livré avec Windows, est réglé par défaut sur Restricted sur les postes clients, ce qui explique qu'un portable neuf bloque npm.ps1. La portée CurrentUser ne demande pas de droits administrateur. L'installeur natif de Claude et celui de Codex ne sont pas concernés : irm | iex et -ExecutionPolicy ByPass ne chargent jamais un fichier de script depuis le disque.

Mettre à jour et désinstaller

Claude CodeCodex CLI
Mettre à jour tout de suiteclaude update (natif), winget upgrade Anthropic.ClaudeCode, ou l'installation npm relancéecodex update sur les versions qui le permettent, l'installeur PowerShell relancé, ou npm install -g @openai/codex
Mises à jour automatiquesinstallation native seulement, coupées avec DISABLE_AUTOUPDATER=1non documentées
Désinstallersupprimer %USERPROFILE%\.local\bin\claude.exe et %USERPROFILE%\.local\share\claude, ou winget uninstall Anthropic.ClaudeCode, ou npm uninstall -g @anthropic-ai/claude-codesupprimer le dossier d'installation, ou npm uninstall -g @openai/codex
Réglages laissés sur le disque%USERPROFILE%\.claude et %USERPROFILE%\.claude.json%USERPROFILE%\.codex

Ce qu'on a appris en faisant tourner des CLI d'agent sous Windows

AgentsRoom lance Claude Code, Codex et les autres CLI d'agent côte à côte, et sa version Windows nous a appris où ces installations cassent une fois sorties du terminal. Quatre choses valent d'être sues, même si tu n'utilises jamais notre app.

Un programme lancé depuis le menu Démarrer garde le PATH de son démarrage. Tu installes Claude Code, tu ajoutes .local\bin au PATH, et une app de bureau déjà ouverte ne trouve toujours pas claude. Redémarrer ton terminal ne suffit pas pour les apps qui lancent des CLI à ta place. AgentsRoom relit le PATH de l'utilisateur et de la machine dans le registre quand il cherche un CLI, pour qu'une installation qui vient de réussir ne soit pas annoncée comme absente.

npm n'installe pas de .exe. npm install -g @openai/codex écrit trois fichiers dans %APPDATA%\npm : codex, codex.cmd et codex.ps1. Un programme qui lance codex directement reçoit spawn codex ENOENT, parce que Windows n'ajoute que .exe à un nom nu. Ton terminal te le cache, puisque PowerShell et CMD lisent PATHEXT. C'est une raison de plus de préférer les installeurs natifs, qui posent bien un exécutable.

Les raccourcis npm ont besoin de Node.js au moment du lancement. Si tu installes Node.js puis un CLI dans la même session, le raccourci .cmd est trouvé mais échoue sur « node is not recognized » dans tout programme lancé avant que Node.js soit dans le PATH. Même symptôme avec un gestionnaire de versions de Node dont les raccourcis pointent vers une version qui n'est pas active.

Créer un processus coûte bien plus cher sous Windows. On a mesuré 20 à 80 ms pour créer un processus sous Windows, contre 1 à 3 ms sous macOS, et chaque vérification de fichier coûte plus cher parce que l'antivirus l'inspecte. Notre première détection des CLI essayait chaque dossier, chaque nom et chaque extension, et figeait l'app jusqu'à une seconde sous Windows. Lire chaque dossier une seule fois a réglé le problème.

Dans l'app, l'assistant d'installation installe un CLI manquant avec l'installeur de l'éditeur pour ton système (irm https://claude.ai/install.ps1 | iex pour Claude Code, le script d'OpenAI pour Codex), se replie sur npm quand le script échoue, et le lance dans un terminal que tu peux regarder. Quand un CLI ne démarre pas, CLI Doctor lit l'erreur et la commande exacte, puis te dit ce qui a cassé. Une fois que les deux CLI répondent à --version, le guide de démarrage prend le relais, et l'annonce de la version Windows dit ce que fait l'app sous Windows.

Questions fréquentes

Comment installer Claude Code sous Windows ?

Ouvre PowerShell et lance irm https://claude.ai/install.ps1 | iex. Dans CMD, prends plutôt la ligne install.cmd de la page d'installation d'Anthropic, et avec WinGet lance winget install Anthropic.ClaudeCode. Le binaire arrive dans %USERPROFILE%\.local\bin, que l'installeur n'ajoute pas à ton PATH : ajoute-le toi-même si claude n'est pas reconnu, puis ouvre un nouveau terminal et lance claude --version.

Faut-il WSL pour utiliser Claude Code ou Codex sous Windows ?

Non. Les deux tournent nativement dans PowerShell ou CMD sous Windows 10 et 11. WSL 2 vaut le coup quand ton projet vit déjà sous Linux, ou quand tu veux la sandbox de Claude Code, qui ne tourne pas sous Windows natif. Prends WSL 2, pas WSL 1 : Codex a abandonné WSL 1 à la version 0.115.

Pourquoi Windows dit que 'claude' n'est pas reconnu juste après l'installation ?

L'installeur natif pose claude.exe dans %USERPROFILE%\.local\bin et affiche un avertissement si ce dossier n'est pas dans ton PATH, mais il ne modifie pas le PATH lui-même. Ajoute le dossier au PATH de ton utilisateur, puis ferme et rouvre le terminal, et l'éditeur si le terminal tourne dedans. Un terminal déjà ouvert garde son ancien PATH.

Claude Code a-t-il besoin de Git for Windows ?

Plus maintenant. La page d'installation d'Anthropic présente Git for Windows comme optionnel : sans lui, Claude Code utilise PowerShell comme outil shell. Avec lui, Claude Code trouve Git Bash dans C:\Program Files\Git, et tu peux désigner un autre bash.exe avec le réglage CLAUDE_CODE_GIT_BASH_PATH.

Peut-on installer Codex CLI sous Windows sans Node.js ?

Oui. L'installeur PowerShell d'OpenAI télécharge un Codex autonome, le pose dans %LOCALAPPDATA%\Programs\OpenAI\Codex\bin et ajoute ce dossier au PATH de ton utilisateur. Seule la voie npm, npm install -g @openai/codex, demande Node.js.

PowerShell ou CMD pour les installer ?

PowerShell. Les deux commandes officielles sont des commandes PowerShell, et les erreurs les plus fréquentes viennent d'une ligne PowerShell collée dans CMD ou l'inverse : 'irm' is not recognized (ou « 'irm' n'est pas reconnu » sur un Windows en français) veut dire que tu es dans CMD, et '&&' is not a valid statement separator veut dire que tu es dans PowerShell. Prends le PowerShell 64 bits, pas l'entrée « Windows PowerShell (x86) » du menu Démarrer.

Ingénieur DevOpsRédacteurDéveloppeur FrontendCommercialDéveloppeur BackendCoach / FormateurArchitecte LogicielJuristeIngénieur QAFinance & adminDéveloppeur Full-StackCréatif / DesignDéveloppeur MobileChercheur / VeilleIngénieur SécuritéRH & recrutement
Chef de ProjetTraducteurExpert GitAnalyste de donnéesSpécialiste SEOComptableSpécialiste de la LocalisationCommunication & RPBrainstormerOpérations & logistiqueSpécialiste MarketingService clientAssistant du projetAcheteurCommunity managerAssistant personnel

Télécharger AgentsRoom

Lancez tous vos agents IA, sur tous vos projets, depuis une seule fenêtre.

Télécharger AgentsRoomGratuit

App companion : suivez vos agents en déplacement

Utilisez Claude, Codex, Antigravity CLI ou un autre fournisseur IA.

Installer l'extension
Chrome Web Store

Remontez bugs et demandes directement dans votre backlog public.

Des agents qu'on lit comme une conversation

Chaque agent a un rôle, un visage et un fil que vous lisez comme une messagerie.

Vue conversation

Vue conversation d'AgentsRoom : le travail d'un agent IA affiché comme un fil de discussion
Multi-projets
Multi-provider
Multi-agents
Statut en direct
Diff & commit
App mobile
Aperçu live
Équipes d'agents
Tests navigateur
Dev pilotée par backlog
Bibliothèque de prompts
Bibliothèque de skills
Voir toutes les fonctionnalités

Continuer la lecture