# Cómo Instalar Qwen Code CLI: Tutorial Paso a Paso para el Agente de Programación con IA en Terminal

Aprende a instalar Qwen Code CLI, el agente de programación con IA de código abierto para tu terminal. Instrucciones paso a paso para npm, script de instalación rápida, Homebrew y solución de problemas en Windows, macOS y Linux.

Canonical URL: https://a2a-mcp.org/blog/qwen-cli-install-es

Language: es

Published: 2026-04-07

Updated: 2026-04-07

## Requisitos Previos

Antes de instalar **Qwen Code CLI** (el agente de codificación con IA basado en terminal, oficial, impulsado por los modelos Qwen), asegúrate de tener lo siguiente:

- **Node.js** versión 20 o superior (recomendado: la última versión LTS). Descárgalo desde [nodejs.org](https://nodejs.org).
- Una terminal o símbolo del sistema con privilegios administrativos en Windows.
- Conexión a Internet para descargar paquetes y modelos.
- Opcional pero recomendado: Git (para instalación manual desde el código fuente) y Homebrew en macOS/Linux.

**Verifica la instalación de Node.js**:

```bash
node --version
npm --version
```

La salida esperada debe mostrar versiones como `v20.x.x` o superior.

## Paso7741: Elige Tu Método de Instalación

Qwen Code CLI ofrece múltiples formas de instalación. El **script de instalación rápida** es recomendado para la mayoría de usuarios, ya que maneja las dependencias automáticamente.

### Instalación Rápida (Recomendada)

**Linux / macOS**:

```bash
bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)"
```

**Windows (Ejecuta el Símbolo del sistema como Administrador)**:

```cmd
curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat
```

Después de ejecutarlo, reinicia tu terminal para actualizar la variable PATH.

## Paso 2: Instalación Manual vía npm

Si prefieres un control manual:

```bash
npm install -g @qwen-code/qwen-code@latest
```

Esto instala el comando `qwen` globalmente.

**En macOS/Linux con sudo** (si surgen problemas de permisos):

```bash
sudo npm install -g @qwen-code/qwen-code@latest
```

## Paso 3: Instalación vía Homebrew (macOS & Linux)

```bash
brew install qwen-code
```

## Paso 4: Verifica la Instalación

Ejecuta el siguiente comando para confirmar que la instalación fue exitosa:

```bash
qwen --version
```

Deberías ver una salida similar a:

```
Qwen Code CLI v0.x.x
```

## Paso 5: Primer Lanzamiento y Autenticación

Lanza la CLI interactiva:

```bash
qwen
```

En el primer inicio, la CLI te pedirá que te autentiques con tu cuenta Qwen (abre el navegador para un inicio de sesión con un clic). Después de iniciar sesión, aplica la configuración predeterminada y entra en la interfaz de terminal interactiva.

Navega primero al directorio de tu proyecto para obtener mejores resultados:

```bash
cd /path/to/your/project
qwen
```

Dentro de la sesión, usa comandos como `/help`, `/model` para cambiar de modelo, o referencia archivos con `@nombrearchivo`.

## Paso 6: Instalación Manual desde el Código Fuente (Avanzado)

Para desarrolladores que quieran los cambios más recientes no publicados:

```bash
git clone https://github.com/QwenLM/qwen-code.git
cd qwen-code
npm install
npm install -g .
```

Luego verifica con `qwen --version`.

## Problemas comunes y solución de problemas

- **Comando 'qwen' no encontrado**: Reinicia tu terminal o ejecuta `hash -r` (Linux/macOS). En Windows, cierra y vuelve a abrir el Símbolo del sistema. Asegúrate de que el directorio global de binarios de Node.js esté en tu PATH.

- **Errores de permisos durante npm install**: Usa `sudo` en Linux/macOS o ejecuta el Símbolo del sistema como Administrador en Windows.

- **Versión de Node.js demasiado antigua**: Actualiza a Node 20+ usando `nvm` o el instalador oficial.

- **Problemas de red con recursos de Aliyun**: Prueba el método npm como alternativa.

- **La instalación falla en Termux o ciertas distribuciones de Linux**: Usa el flag `--ignore-scripts`: `npm install -g @qwen-code/qwen-code@latest --ignore-scripts`.

- **La autenticación no funciona**: Asegúrate de que tu navegador permita ventanas emergentes y de que tengas una cuenta válida de Qwen.

Para problemas persistentes, consulta el repositorio oficial de GitHub: https://github.com/QwenLM/qwen-code.

## Próximos pasos

- Explora la interfaz interactiva: Escribe `/help` para ver los comandos de barra disponibles.
- Prueba la programación agéntica: Pídele a la CLI que refactorice código, explique archivos o automatice tareas usando lenguaje natural.
- Configura modelos: Usa `/model` para seleccionar Qwen3-Coder u otros backends compatibles (incluyendo Ollama local).
- Integra con VS Code: Instala la extensión Qwen Code Companion para una integración fluida con el editor.
- Personaliza ajustes: Edita `~/.qwen/settings.json` para temas, modelos predeterminados y opciones avanzadas.

Ahora estás listo para usar Qwen Code CLI como un poderoso compañero de programación con IA directamente en tu terminal. Comienza con indicaciones simples como "Explica esta base de código" o "Refactoriza esta función para mejor rendimiento" dentro de tu carpeta de proyecto.

¡Feliz codificación!