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 Code | Codex CLI | |
|---|---|---|
| Version de Windows | Windows 10 1809 ou plus récent, Windows Server 2019 ou plus récent | Windows 11 recommandé, Windows 10 récent en « best effort » |
| Processeur | x64 ou ARM64, jamais 32 bits | x64 ou ARM64 |
| Compte | Un forfait Claude payant ou un compte Console | Un forfait ChatGPT ou une clé API OpenAI |
| Node.js | Seulement pour la voie npm, version 22 ou plus | Seulement pour la voie npm |
| Git for Windows | Optionnel | Pas nécessaire |
| Sandbox sous Windows natif | Non, seulement dans WSL 2 | Oui, sa propre sandbox Windows |
| Droits administrateur pour installer | Non | Non |
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.
| Voie | Commande |
|---|---|
| PowerShell (recommandée) | irm https://claude.ai/install.ps1 | iex |
| CMD | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| WinGet | winget 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.exedans%USERPROFILE%\.local\bin, les versions dans%USERPROFILE%\.local\share\claude. L'installeur te prévient quand.local\binn'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.
| Voie | Commande |
|---|---|
| Installeur PowerShell | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" |
| npm | npm 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 Code | irm https://claude.ai/install.ps1 | iex | curl -fsSL https://claude.ai/install.sh | bash dans WSL |
| Installer Codex | l'installeur PowerShell | curl -fsSL https://chatgpt.com/codex/install.sh | sh dans WSL |
| Sandbox de Claude Code | indisponible | disponible, avec bubblewrap et socat |
| Sandbox de Codex | la sandbox Windows | la sandbox Linux |
| Où garder le dépôt | n'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 :
- 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 surExec format error. Convertis une distribution avecwsl --set-version <DistroName> 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. - 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 vois | Pourquoi | Correctif |
|---|---|---|
'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 PATH | L'ajouter au PATH de l'utilisateur (commandes plus bas), puis ouvrir un nouveau terminal |
| Toujours pas reconnu après l'ajout | Le terminal, ou l'éditeur qui le contient, a démarré avant le changement | Fermer et rouvrir le terminal, et l'éditeur si le terminal vit dedans |
| Pas reconnu juste après une mise à jour | Une mise à jour coupée en plein échange n'a laissé aucun claude.exe | Renommer le claude.exe.old.* le plus récent en claude.exe (commande plus bas) |
'irm' is not recognized | Tu as collé la ligne PowerShell dans CMD | Ouvrir PowerShell, ou prendre la ligne CMD |
The token '&&' is not a valid statement separator | Tu as collé la ligne CMD dans Windows PowerShell | Prendre la ligne PowerShell |
npm.ps1 cannot be loaded because running scripts is disabled on this system | La stratégie d'exécution bloque le raccourci PowerShell de npm | Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, ou appeler npm.cmd |
| Une erreur sur Windows 32 bits alors que le PC est en 64 bits | Tu as ouvert « Windows PowerShell (x86) » depuis le menu Démarrer | Ouvrir le PowerShell 64 bits habituel |
claude ouvre l'app de bureau au lieu du CLI | Une ancienne app de bureau Claude a posé un Claude.exe dans WindowsApps, devant le CLI dans le PATH | Mettre à jour l'app de bureau Claude |
requires either Git for Windows (for bash) or PowerShell | Claude Code n'a trouvé aucun des deux shells | Installer Git for Windows, ou vérifier que PowerShell est dans le PATH |
EBADENGINE pendant npm install | Node.js est plus ancien que la 22 | Mettre 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 Code | Codex CLI | |
|---|---|---|
| Mettre à jour tout de suite | claude update (natif), winget upgrade Anthropic.ClaudeCode, ou l'installation npm relancée | codex update sur les versions qui le permettent, l'installeur PowerShell relancé, ou npm install -g @openai/codex |
| Mises à jour automatiques | installation native seulement, coupées avec DISABLE_AUTOUPDATER=1 | non documentées |
| Désinstaller | supprimer %USERPROFILE%\.local\bin\claude.exe et %USERPROFILE%\.local\share\claude, ou winget uninstall Anthropic.ClaudeCode, ou npm uninstall -g @anthropic-ai/claude-code | supprimer 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.
Télécharger AgentsRoom
Lancez tous vos agents IA, sur tous vos projets, depuis une seule fenêtre.
App companion : suivez vos agents en déplacement
Utilisez Claude, Codex, Antigravity CLI ou un autre fournisseur IA.
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.

Continuer la lecture
Le mode vocal dans Codex, OpenCode, Antigravity et Claude Code : quel CLI en a un ?
On a vérifié cinq CLI d'agents de code et deux apps le 13 octobre 2026. Codex CLI et oh-my-pi tiennent une conversation parlée, Claude Code et Antigravity CLI ne font que dicter dans le prompt, OpenCode n'a rien d'intégré. Comment lancer chacun, où part l'audio, et ce que la voix coûte en tokens.
Lire l'articleLes loops d'agents IA : comment un agent de code s'auto-corrige tout seul
Un loop d'agent IA transforme le prompt-et-corrige en un cycle auto-correcteur : l'agent écrit un plan, le construit, vérifie son propre travail face au plan, et boucle jusqu'à ce que ce soit fini. Comment le loop marche dans Claude Code, Codex, Antigravity CLI, Cursor et le Ralph loop.
Lire l'articleComment retirer Co-Authored-By Claude de tes commits git
Claude Code signe tes commits d'un trailer Co-Authored-By et tes pull requests d'une ligne Generated with Claude Code. Le réglage qui les retire, le fichier où le mettre, et comment nettoyer les commits déjà poussés.
Lire l'article