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

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:
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:
npm install -g @qwen-code/qwen-code@latest
O, en macOS y Linux, con Homebrew:
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
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:
- Qwen Account with Subscription: inicio de sesión en el navegador con una suscripción Plus o Pro.
- QwenCloud: un Token Plan o una Standard API Key de pago por uso.
- Alibaba ModelStudio: Coding Plan, Token Plan o Standard API Key.
- Third-party Providers: una lista integrada que incluye DeepSeek, Kimi, OpenRouter y otros, con una clave de API.
- 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:
{
"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:
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:
/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:
qwen -p "Summarize the repository layout."

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 authno hace nada útil. Ese comando se eliminó. Ejecutaqweny luego/auth. Ejecuta/doctorpara comprobar tu autenticación actual.- El modelo local agota el tiempo de espera. Confirma que la
baseUrltermina en/v1y que el servidor está en marcha. Para servidores lentos, la documentación describe un ajustestreamIdleTimeoutMs. - Dudas sobre la seguridad del daemon. Si usas
qwen serveoqwen 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, defineQWEN_SERVER_TOKENy 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.





Escribe una respuesta