Guía de Instalación de Qwen Code CLI: Configuración Rápida en Windows, macOS y Linux (2026)

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

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

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:

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

Esto instala el comando qwen globalmente.

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

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

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

brew install qwen-code

Paso 4: Verifica la Instalación

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

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:

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:

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:

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!