Hace un año, el atajo para instalar un agente de programación en Windows era «primero instala WSL». Hoy la mayoría de los grandes agentes se instalan de forma nativa en PowerShell. Pero cada uno tiene su propio camino: unos piden un script de una línea, otros npm, otros winget o scoop.
Este artículo los reúne todos en un solo sitio. Los comandos se tomaron en noviembre de 2026 de la documentación de cada agente; si algo no funciona, mira primero la documentación del agente, porque los métodos de instalación cambian a menudo.
Antes de empezar
Node.js 20 o superior. Codex, Gemini CLI, Copilot CLI, Qwen Code y Cline vienen como paquetes de npm.
winget install OpenJS.NodeJS.LTS
node -vGit for Windows. La mayoría de los agentes trabajan con git, y Claude Code usa Git Bash para los comandos de shell si está disponible. Ya no es obligatorio, pero instalarlo te facilita las cosas.
winget install Git.GitWindows Terminal y PowerShell 7. No son imprescindibles, pero Copilot CLI pide PowerShell 6 o superior, y los colores y el Unicode se ven mejor en la terminal nueva.
winget install Microsoft.PowerShellComandos de instalación
| Agente | Comando de instalación en 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 |
Después de instalar, abre una terminal nueva. Si la instalación cambió el PATH, las terminales abiertas no lo ven.
Notas agente por agente
Claude Code
irm https://claude.ai/install.ps1 | iex
claudeFunciona en Windows 10 1809 o superior. Si usas CMD, usa el comando para CMD de la documentación oficial; winget (winget install Anthropic.ClaudeCode) y npm también son opciones. Si Git for Windows está instalado, los comandos de shell se ejecutan en Git Bash; si no, en PowerShell. Para indicarle un Git Bash concreto, define la variable de entorno CLAUDE_CODE_GIT_BASH_PATH. El sandbox de Claude Code no existe en Windows nativo; sí en WSL 2. Más detalles: cómo usar Claude Code.
Codex
npm i -g @openai/codex
codexLa primera vez te pide iniciar sesión con tu cuenta de ChatGPT. Codex funciona de forma nativa en Windows con su propio sandbox. Más detalles: cómo usar Codex CLI.
Gemini CLI
npm i -g @google/gemini-cli
geminiTiene una cuota gratuita al iniciar sesión con una cuenta de Google. Más detalles: cómo usar Gemini CLI.
Copilot CLI
npm i -g @github/copilot
copilotTambién se puede instalar con winget. Necesita una suscripción a GitHub Copilot y PowerShell 6 o superior.
Cursor CLI
irm 'https://cursor.com/install?win32=true' | iexEl comando es agent (en versiones antiguas, cursor-agent). Inicias sesión con tu cuenta de Cursor.
opencode
scoop install opencodechoco y npm también son opciones. Su documentación recomienda WSL para la mejor experiencia, pero también funciona en Windows nativo.
Los demás
- Qwen Code y Cline se instalan con npm.
- Kiro CLI solo es compatible con Windows 11.
- Droid (Factory) y Kimi Code se instalan con un script de PowerShell. La antigua Kimi CLI se archivó; su sustituto es Kimi Code.
- Crush se instala con winget y Mistral Vibe, con uv.
- La documentación oficial de Amp dice WSL para Windows.
Errores de instalación frecuentes
«no se reconoce como comando» (is not recognized). Abre una terminal nueva. Si sigue sin aparecer, búscalo con where claude o where codex; si lo instalaste con npm, comprueba que la carpeta de npm prefix -g está en el PATH.
«la ejecución de scripts está deshabilitada en este sistema». Los shims .ps1 que instala npm pueden chocar con la directiva de ejecución de PowerShell. O permites scripts solo para tu usuario:
Set-ExecutionPolicy -Scope CurrentUser RemoteSignedo llamas al comando con la extensión .cmd, como claude.cmd o codex.cmd.
Los acentos, la ñ o los emojis se ven rotos. La página de códigos de la consola antigua no es UTF-8. Usa Windows Terminal o cambia a UTF-8 con chcp 65001.
irm ... | iex falla en la red de la empresa. Puede que un proxy o un software de seguridad esté bloqueando el script. Prueba la vía de winget o npm.
Errores de rutas largas. Las carpetas node_modules profundas pueden toparse con el límite de 260 caracteres. Configura git config --global core.longpaths true y pon los proyectos en una raíz corta como C:\src.
Después de instalar: ejecutarlos todos juntos
Si has instalado varios agentes, seguirlos en ventanas de terminal separadas cansa enseguida. AgentVera es una app de escritorio que funciona de forma nativa en Windows: detecta sola los agentes que tienes instalados, muestra la pista de instalación para Windows junto a los que faltan y los abre todos lado a lado en una cuadrícula por proyecto.
Como desenvuelve los shims .cmd que instala npm e inicia directamente el script que contienen, el análisis de argumentos de cmd.exe no estropea los roles ni los ajustes JSON que llevan & o %.
Para gestionar varios agentes en paralelo, lee agentes de programación en Windows; si te preguntas si pasarte a WSL, WSL o Windows nativo; y para el resumen completo, la página de Windows.