Il y a un an, le raccourci pour installer un agent de code sous Windows était « installez d’abord WSL ». Aujourd’hui, la plupart des grands agents s’installent nativement dans PowerShell. Mais chacun a sa méthode : un script d’une ligne pour l’un, npm, winget ou scoop pour les autres.
Cet article les rassemble toutes au même endroit. Les commandes proviennent de la documentation de chaque agent en novembre 2026 ; si quelque chose ne fonctionne pas, consultez d’abord la documentation de l’agent, les méthodes d’installation changent souvent.
Avant de commencer
Node.js 20 ou plus. Codex, Gemini CLI, Copilot CLI, Qwen Code et Cline sont distribués sous forme de paquets npm.
winget install OpenJS.NodeJS.LTS
node -v
Git for Windows. La plupart des agents travaillent avec git ; Claude Code, lui, utilise Git Bash pour les commandes shell s’il est présent. Ce n’est plus obligatoire, mais l’installer vous simplifie la vie.
winget install Git.Git
Windows Terminal et PowerShell 7. Pas indispensables, mais Copilot CLI demande PowerShell 6 ou plus, et les couleurs comme l’Unicode s’affichent mieux dans le nouveau terminal.
winget install Microsoft.PowerShell
Les commandes d’installation
| Agent | Commande d’installation Windows |
|---|---|
| Claude Code | irm https://claude.ai/install.ps1 | iex |
| Codex | npm i -g @openai/codex |
| Gemini CLI | npm i -g @google/gemini-cli |
| Copilot CLI | npm i -g @github/copilot |
| Cursor CLI | irm 'https://cursor.com/install?win32=true' | iex |
| opencode | scoop install opencode |
| Qwen Code | npm i -g @qwen-code/qwen-code |
| Kiro CLI | irm 'https://cli.kiro.dev/install.ps1' | iex |
| Droid | irm https://app.factory.ai/cli/windows | iex |
| Kimi Code | irm https://code.kimi.com/kimi-code/install.ps1 | iex |
| Crush | winget install charmbracelet.crush |
| Aider | powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex" |
| Cline CLI | npm i -g cline |
| Mistral Vibe | uv tool install mistral-vibe |
Après l’installation, ouvrez un nouveau terminal. Si l’installation a modifié le PATH, les terminaux déjà ouverts ne le voient pas.
Notes agent par agent
Claude Code
irm https://claude.ai/install.ps1 | iex
claude
Fonctionne sous Windows 10 1809 ou plus récent. Si vous utilisez CMD, prenez la commande CMD de la documentation officielle ; winget (winget install Anthropic.ClaudeCode) et npm sont aussi possibles. Si Git for Windows est installé, les commandes shell s’exécutent dans Git Bash, sinon dans PowerShell ; pour indiquer un Git Bash précis, définissez la variable d’environnement CLAUDE_CODE_GIT_BASH_PATH. Le bac à sable (sandbox) de Claude Code n’existe pas sous Windows natif, seulement dans WSL 2. Détails : comment utiliser Claude Code.
Codex
npm i -g @openai/codex
codex
Au premier lancement, il vous demande de vous connecter avec votre compte ChatGPT. Codex tourne nativement sous Windows avec son propre bac à sable. Détails : comment utiliser Codex CLI.
Gemini CLI
npm i -g @google/gemini-cli
gemini
Un quota gratuit est inclus avec la connexion par compte Google. Détails : comment utiliser Gemini CLI.
Copilot CLI
npm i -g @github/copilot
copilot
Il s’installe aussi avec winget. Il faut un abonnement GitHub Copilot et PowerShell 6 ou plus.
Cursor CLI
irm 'https://cursor.com/install?win32=true' | iex
La commande s’appelle agent (cursor-agent dans les anciennes versions). Vous vous connectez avec votre compte Cursor.
opencode
scoop install opencode
choco et npm sont aussi possibles. Sa documentation recommande WSL pour une expérience optimale, mais il fonctionne aussi sous Windows natif.
Les autres
- Qwen Code et Cline s’installent avec npm.
- Kiro CLI n’est pris en charge que sous Windows 11.
- Droid (Factory) et Kimi Code s’installent avec un script PowerShell. L’ancien Kimi CLI a été archivé ; Kimi Code l’a remplacé.
- Crush s’installe avec winget, Mistral Vibe avec uv.
- La documentation officielle d’Amp indique WSL pour Windows.
Erreurs d’installation courantes
« n’est pas reconnu » (is not recognized). Ouvrez un nouveau terminal. Si la commande reste introuvable, cherchez-la avec where claude ou where codex ; si vous avez installé avec npm, vérifiez que le dossier npm prefix -g est dans le PATH.
« l’exécution de scripts est désactivée sur ce système ». Les shims .ps1 installés par npm peuvent se heurter à la stratégie d’exécution de PowerShell. Autorisez-les pour votre seul utilisateur :
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
ou appelez la commande avec son extension .cmd, comme claude.cmd ou codex.cmd.
Les caractères accentués ou les emojis s’affichent mal. L’ancienne page de codes de la console n’est pas UTF-8. Utilisez Windows Terminal ou passez en UTF-8 avec chcp 65001.
irm ... | iex échoue sur un réseau d’entreprise. Un proxy ou un logiciel de sécurité bloque peut-être le script. Essayez plutôt winget ou npm.
Erreurs de chemins longs. Les dossiers node_modules profonds peuvent dépasser la limite de 260 caractères. Définissez git config --global core.longpaths true et placez vos projets sous une racine courte comme C:\src.
Après l’installation : les faire tourner ensemble
Si vous avez installé plusieurs agents, les suivre dans des fenêtres de terminal séparées devient vite fatigant. AgentVera est une application de bureau qui tourne nativement sous Windows : il détecte tout seul les agents installés, affiche l’indication d’installation Windows à côté de ceux qui manquent et les ouvre tous côte à côte dans une grille par projet.
Comme il déballe les shims .cmd installés par npm et lance directement le script qu’ils contiennent, l’analyse des arguments de cmd.exe ne déforme pas les rôles et réglages JSON contenant & ou %.
Pour gérer plusieurs agents en parallèle, lisez gérer des agents de code sous Windows ; pour savoir s’il faut passer à WSL, WSL ou Windows natif ; et pour le résumé complet, la page Windows.