Qwen Code: cómo instalar y usar el agente de programación de código abierto para la terminal

Una guía paso a paso para instalar Qwen Code, conectar un modelo (incluido uno local) y usar Plan Mode y las aprobaciones con seguridad, basada en la propia documentación del proyecto.

Graphic of a code card showing a terminal command to install Qwen Code, the open-source terminal coding agent.

Qwen Code nació como un proyecto basado en Gemini CLI de Google, y hoy tiene más de 30.000 estrellas propias en GitHub. El README explica que el proyecto se basó originalmente en Gemini CLI v0.8.2, dejó de sincronizarse con el original a partir de v0.1 y se convirtió en un agente de programación independiente y compatible con varios protocolos.

Puntos clave

  • Qwen Code es un agente de programación de código abierto para la terminal, con licencia Apache-2.0, que empezó como fork de Gemini CLI.
  • Instálalo con el script independiente, con npm y Node.js 22 o posterior, o con Homebrew, y luego ejecuta /auth para conectar un modelo.
  • Ninguna opción de inicio de sesión se describe como gratuita, así que usa un servidor local de Ollama, vLLM o LM Studio si quieres costo cero.
  • Empieza los proyectos nuevos en Plan Mode, de solo lectura, revisa con /diff y revierte con /restore.

Esta guía muestra cómo instalar Qwen Code, iniciar sesión (o conectarlo a un modelo local gratuito) y usarlo con seguridad en un proyecto real. Todo lo que sigue sale del README y la documentación del propio proyecto en GitHub, revisados el 15 de noviembre de 2026. No ejecutamos ninguno de los comandos para este artículo, así que pruébalos primero en una carpeta desechable.

Qué necesitas

  • Una terminal en macOS, Linux o Windows
  • Node.js 22 o posterior, si eliges la vía de npm
  • Un proyecto de código con el que trabajar (lo ideal es un repositorio de pruebas)
  • Una forma de pagar o alojar un modelo: una suscripción de Qwen, una clave de API o un servidor de modelos local
Esquema de las cinco opciones de inicio de sesión de Qwen Code, desde Qwen Account hasta un proveedor de modelo local personalizado

Qué es Qwen Code

Es un agente de programación de código abierto que se ejecuta en tu terminal, lee tu repositorio, edita archivos y ejecuta comandos. GitHub indica Apache-2.0 como licencia, y el README dice que funciona con las API de OpenAI, Anthropic, Gemini y Qwen, además de cualquier proveedor externo o modelo local como Ollama o vLLM. A 15 de noviembre de 2026, la última etiqueta de versión es v0.27.4.

El proyecto también publica su propio benchmark: en SWE-bench Verified, siete versiones de Qwen Code obtuvieron una media de entre el 76,40 % y el 77,80 % con el mismo modelo, Qwen 3.7 Max. Es la evaluación de los propios mantenedores, no una prueba independiente.

En cifras

30.000estrellas en GitHub, más de

77,80 %mejor media en SWE-bench, según el propio proyecto

v0.27.4última etiqueta de versión

Paso a paso

1. Instálalo

El README ofrece tres vías. La primera es un instalador de una sola línea para Linux y macOS:

Terminal
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

Pasar un script directamente a tu shell es una cuestión de confianza. El instalador está alojado en una dirección de almacenamiento de Alibaba Cloud, así que, si lo prefieres, usa npm o Homebrew:

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

O, en macOS y Linux, con Homebrew:

Terminal
brew install qwen-code

Para Windows, el README incluye un instalador de PowerShell. Tras una instalación independiente, reinicia la terminal para que las variables de entorno surtan efecto.

2. Ábrelo dentro de un proyecto

Terminal
cd ~/projects/my-app
qwen

Deberías ver una sesión interactiva en la terminal. El README también menciona una rama «1.0 Preview», pero estas instrucciones son para la versión principal.

3. Inicia sesión o conecta un modelo

Escribe /auth. La documentación enumera cinco opciones principales:

  1. Qwen Account with Subscription: inicio de sesión en el navegador con una suscripción Plus o Pro.
  2. QwenCloud: un Token Plan o una Standard API Key de pago por uso.
  3. Alibaba ModelStudio: Coding Plan, Token Plan o Standard API Key.
  4. Third-party Providers: una lista integrada que incluye DeepSeek, Kimi, OpenRouter y otros, con una clave de API.
  5. Custom Provider: un servidor local, un proxy o un proveedor no compatible.

La documentación actual no describe ninguna de esas opciones como gratuita. Para mantener el costo en cero, usa un modelo local. La documentación muestra que Ollama, vLLM y LM Studio funcionan a través de una dirección compatible con OpenAI. Nuestra guía para ejecutar un modelo de IA con Ollama cubre la parte del servidor. Después guarda una configuración en ~/.qwen/settings.json, adaptada del propio ejemplo de la documentación:

Código
{
  "env": { "OLLAMA_API_KEY": "ollama" },
  "modelProviders": {
    "openai": [
      {
        "id": "your-model-name",
        "name": "My local model",
        "envKey": "OLLAMA_API_KEY",
        "baseUrl": "http://localhost:11434/v1"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "your-model-name" }
}

Sustituye your-model-name por el nombre exacto del modelo que indica tu servidor. La documentación dice que model.name debe coincidir con uno de los valores id. Después de guardar, ejecuta qwen.

4. Haz tu primera pregunta

El README sugiere empezar con un prompt seguro, de solo lectura:

Código
Explain this repository and show me where to start.

Luego ejecuta /init, que según la documentación analiza el directorio actual y crea un archivo de contexto inicial. Qwen Code carga automáticamente tus instrucciones de QWEN.md y AGENTS.md. Si ya usas archivos de skills, nuestra guía sobre agent skills en Claude Code explica la idea, y Qwen Code incluye su propio panel /skills en la documentación.

5. Decide cuánta libertad le das

Qwen Code tiene cinco modos de permisos: Plan, Ask Permissions, Auto-Edit, Auto y YOLO. Pulsa Shift+Tab (Tab en Windows) para pasar de uno a otro. La documentación dice que Auto, en el que un clasificador aprueba las acciones seguras y bloquea las arriesgadas, es el predeterminado, pero la misma página también menciona Ask Permissions como modo inicial, así que revisa la barra de estado. Para un proyecto nuevo, empieza en Plan Mode:

Código
/plan refactor the settings page

Plan Mode es de solo lectura, así que no se edita ni se ejecuta nada. Escribe /plan exit para volver a tu modo anterior. Reserva YOLO para proyectos de confianza, como aconseja la documentación.

6. Revisa y deshaz

Usa /diff para abrir un visor interactivo de los cambios sin confirmar. Si algo salió mal, /restore enumera los puntos de control y devuelve los archivos del proyecto al estado anterior a la ejecución de una herramienta.

7. Úsalo en scripts

El README dice que el modo headless funciona desde scripts y CI:

Terminal
qwen -p "Summarize the repository layout."
Diagrama de flujo: instalar Qwen Code, conectar un modelo, planificar en modo de solo lectura y revisar los cambios

Errores comunes y soluciones

  • qwen: command not found. Reinicia la terminal después de instalar, como indica el README. Si usaste npm, confirma que Node.js es la versión 22 o posterior.
  • El inicio de sesión en el navegador no funciona. En CI o en contenedores sin supervisión, la documentación de autenticación recomienda usar un método con clave de API y variables de entorno.
  • qwen auth no hace nada útil. Ese comando se eliminó. Ejecuta qwen y luego /auth. Ejecuta /doctor para comprobar tu autenticación actual.
  • El modelo local agota el tiempo de espera. Confirma que la baseUrl termina en /v1 y que el servidor está en marcha. Para servidores lentos, la documentación describe un ajuste streamIdleTimeoutMs.
  • Dudas sobre la seguridad del daemon. Si usas qwen serve o qwen daemon start, ten en cuenta que, según el README, por defecto escucha en loopback sin autenticación bearer, así que cualquier proceso local que pueda alcanzarlo puede usar toda la API, incluida la ejecución de código. En equipos compartidos, define QWEN_SERVER_TOKEN y usa --require-auth.

¿Sabías que…?

Por defecto, el daemon qwen serve escucha en loopback sin autenticación bearer, así que cualquier proceso local que pueda alcanzarlo puede usar toda la API, incluida la ejecución de código. En equipos compartidos, define QWEN_SERVER_TOKEN y usa –require-auth.

¿Vale la pena probarlo?

Si te gusta el flujo de trabajo de Claude Code o Gemini CLI y quieres algo que puedas conectar a tu propio modelo, Qwen Code está a una instalación rápida de distancia. Empieza en Plan Mode, ten a mano un commit de Git y toma las cifras del benchmark como datos de los propios mantenedores hasta que lo pruebes tú.

Preguntas frecuentes

¿Qwen Code es gratis?

La herramienta en sí es de código abierto con licencia Apache-2.0, pero la documentación actual no describe como gratuita ninguna de las opciones de inicio de sesión de /auth. Para mantener el costo en cero, conéctala a un modelo local con Ollama, vLLM o LM Studio.

¿Cómo instalo Qwen Code?

El README ofrece tres vías: un instalador independiente de una línea para Linux y macOS, npm install -g @qwen-code/qwen-code@latest con Node.js 22 o posterior, o brew install qwen-code. Para Windows hay un instalador de PowerShell. Reinicia la terminal después.

¿Qwen Code puede usar un modelo local con Ollama?

Sí. Guarda un ~/.qwen/settings.json que apunte un proveedor compatible con OpenAI a http://localhost:11434/v1 y asegúrate de que model.name coincida con uno de los valores id del proveedor. Luego ejecuta qwen.

¿Qué es Plan Mode en Qwen Code?

Plan Mode es uno de los cinco modos de permisos y es de solo lectura, así que no se edita ni se ejecuta nada. Actívalo con /plan seguido de tu tarea y escribe /plan exit para volver a tu modo anterior.

Test rápido

¿En qué proyecto se basó originalmente Qwen Code?

  • Claude Code
  • Gemini CLI
  • Ollama

El README dice que se basó originalmente en Gemini CLI v0.8.2.

¿Qué modo es de solo lectura?

  • Plan
  • YOLO
  • Auto-Edit

La documentación dice que Plan Mode no edita ni ejecuta nada.

¿Qué comando devuelve los archivos del proyecto a un punto de control?

  • /diff
  • /init
  • /restore

/restore enumera los puntos de control y devuelve los archivos al estado anterior a la ejecución de una herramienta.

Fuentes

Enlaces revisados por última vez el 15 de noviembre de 2026.

Escrito por Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

Acerca de Mindloop Experience

Respuestas

Escribe una respuesta

Más de Mindloop Experience

Ver todo de Mindloop Experience

Puedes aplaudir hasta 50 veces.