# Instalar agentes de programación en Windows

URL: https://agentvera.dev/es/blog/install-coding-agents-on-windows/ · Publicado: 2026-11-01

Comandos de instalación en Windows de Claude Code, Codex, Gemini CLI, Copilot CLI, Cursor y 9 agentes más: PowerShell, winget, npm, Node.js, PATH y errores frecuentes.

**En resumen:**

- Claude Code, Cursor CLI, Kiro y Droid se instalan en PowerShell con un script de una línea; Codex, Gemini CLI, Copilot CLI, Qwen Code y Cline, con npm.
- Los agentes que se instalan con npm necesitan Node.js 20 o superior; después de instalar, abre una terminal nueva para que se actualice el PATH.
- Claude Code ya funciona sin Git for Windows; si no hay Git Bash, ejecuta los comandos de shell con PowerShell.

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.

```powershell
winget install OpenJS.NodeJS.LTS
node -v
```

**Git 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.

```powershell
winget install Git.Git
```

**Windows 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.

```powershell
winget install Microsoft.PowerShell
```

## Comandos 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

```powershell
irm https://claude.ai/install.ps1 | iex
claude
```

Funciona 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](/es/blog/how-to-use-claude-code/).

### Codex

```powershell
npm i -g @openai/codex
codex
```

La 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](/es/blog/how-to-use-codex-cli/).

### Gemini CLI

```powershell
npm i -g @google/gemini-cli
gemini
```

Tiene una cuota gratuita al iniciar sesión con una cuenta de Google. Más detalles: [cómo usar Gemini CLI](/es/blog/how-to-use-gemini-cli/).

### Copilot CLI

```powershell
npm i -g @github/copilot
copilot
```

También se puede instalar con winget. Necesita una suscripción a GitHub Copilot y PowerShell 6 o superior.

### Cursor CLI

```powershell
irm 'https://cursor.com/install?win32=true' | iex
```

El comando es `agent` (en versiones antiguas, `cursor-agent`). Inicias sesión con tu cuenta de Cursor.

### opencode

```powershell
scoop install opencode
```

choco 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:

```powershell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
```

o 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](/es/features/workspace/) 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](/es/blog/coding-agents-on-windows/); si te preguntas si pasarte a WSL, [WSL o Windows nativo](/es/blog/wsl-vs-native-windows-coding-agents/); y para el resumen completo, la [página de Windows](/es/windows/).

## Preguntas frecuentes

**¿Cómo instalo Codex en Windows?** Instala Node.js 20 o superior y luego ejecuta npm i -g @openai/codex en PowerShell. La primera vez que lo abres, el comando codex te pide iniciar sesión con tu cuenta de ChatGPT. Codex funciona de forma nativa en Windows con su propio sandbox; no necesita WSL.

**¿Cómo instalo Claude Code en Windows?** Ejecuta irm https://claude.ai/install.ps1 | iex en PowerShell. También puedes instalarlo con winget install Anthropic.ClaudeCode o con npm. Requiere Windows 10 1809 o superior.

**¿Claude Code necesita Git for Windows?** Ya no. Si Git for Windows está instalado, Claude Code usa Git Bash para los comandos de shell; si no, usa PowerShell. Aun así, si usas git en tu proyecto, tiene sentido instalarlo.

**¿Qué hago si el comando no se reconoce después de instalarlo?** Abre una terminal nueva; si la instalación cambió el PATH, las terminales abiertas no lo ven. where claude o where codex muestran dónde se encuentra el comando. Si lo instalaste con npm, comprueba que la carpeta de npm prefix -g está en el PATH.

**PowerShell no me deja ejecutar scripts, ¿qué hago?** Los shims .ps1 que instala npm pueden chocar con la directiva de ejecución. Puedes permitir scripts locales solo para tu usuario con Set-ExecutionPolicy -Scope CurrentUser RemoteSigned o llamar al comando con la extensión .cmd, por ejemplo claude.cmd.

---

**Sobre AgentVera.** AgentVera es una app de escritorio para macOS, Windows y Linux, desarrollada por Solviera Teknoloji. Ejecuta 18 agentes de programación con IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) en paralelo, por proyecto, en terminales reales con las instalaciones y sesiones de CLI del propio usuario. El plan gratuito tiene agentes ilimitados. Descargar: https://agentvera.dev/es/download/ · Precios: https://agentvera.dev/es/pricing/