Cómo ejecutar Qwen Code en la terminal y configurar el modo de edición

La pregunta suena así: ¿cómo conseguir que Qwen funcione bien en la consola y escriba código por su cuenta? Normalmente, detrás hay una decepción: alguien instaló Qwen Code, hizo una pregunta y recibió como respuesta texto y un fragmento de código que tuvo que copiar a mano, aunque le habían prometido un agente que entraría en el proyecto y lo haría todo por sí mismo.

Eso es exactamente Qwen Code: un agente completo. Puede abrir y editar archivos, y ejecutar comandos por su cuenta. Su comportamiento depende del modo de aprobación activo: Ask Permissions solicita confirmación; Auto-Edit y Auto permiten más autonomía. Comprueba la barra de estado sin suponer que un modo llamado Default sea la opción inicial. A continuación, en orden: instalación, inicio en un proyecto, conexión de un modelo después de los cambios de abril y cambio a un modo en el que el agente edita código sin hacer preguntas innecesarias. Todo se verificó con la documentación oficial de Qwen a fecha de 30 de agosto de 2026.

Recursos prácticos sobre modelos y agentes: documentación de Ailoot.

¿Qué significa que «Qwen Code escribe código por su cuenta»?#

La diferencia es sencilla. Un chat en el navegador responde a una pregunta con texto. Lees la respuesta, copias el código, lo pegas en tu archivo, lo ejecutas tú mismo, detectas el error por tu cuenta y lo llevas de vuelta al chat. Eres el mensajero entre el chat y el proyecto.

Un agente funciona de otra manera. Le das una tarea en lenguaje sencillo: «añade un formulario de comentarios», «corrige este error». Entonces examina la estructura del proyecto, encuentra los archivos pertinentes, hace los cambios y ejecuta una comprobación. La documentación lo explica claramente: el agente crea un plan, escribe código y se asegura de que funcione.

De ahí viene la confusión de la pregunta. «Qwen no escribe código por su cuenta» casi siempre significa una de estas dos cosas: la persona tiene abierto un chat en el navegador en vez del agente de terminal, o el agente está en marcha, pero configurado en un modo que pide permiso para cada edición. El primer caso se resuelve instalando Qwen Code; el segundo, cambiando de modo. A continuación se explican ambas soluciones.

¿Cómo se instala Qwen Code en la terminal?#

La vía rápida es el instalador oficial, que selecciona automáticamente la versión adecuada para tu sistema.

En macOS y Linux, abre la terminal y pega esta línea:

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

En Windows, haz lo mismo con este comando de PowerShell:

irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

La segunda opción es npm, si ya lo tienes instalado. Se requiere Node.js versión 22 o posterior:

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

Después de la instalación, reinicia la terminal. El instalador añade el comando qwen a las rutas del sistema, y la terminal no lo reconocerá hasta que la reinicies: ese es el motivo más frecuente de «lo he instalado, pero no encuentra el comando». Para comprobar que todo se instaló, ejecuta:

qwen --version

Si aparece un número de versión, el agente está instalado y listo para iniciarse en tu proyecto.

¿Cómo se inicia Qwen Code en un proyecto?#

Primero, ve a la carpeta que contiene tu código. Esto es importante: el agente trabaja en la carpeta desde la que se inició y solo ve su contenido.

cd path-to-your-project
qwen

La interfaz del agente se abrirá directamente en la terminal. La primera vez, te ofrecerá conectar un modelo; esto se explica en la siguiente sección. Cuando el modelo esté conectado, puedes darle una tarea en lenguaje sencillo para ver a qué puede acceder:

what does this project do?

El agente leerá los archivos, entenderá la estructura y te dará una respuesta útil. Después, puedes pedirle que escriba y edite código: «añade un botón para cerrar sesión», «divide este archivo en dos», «averigua por qué falla la prueba». Encontrará los lugares pertinentes y hará los cambios por sí mismo.

También hay una segunda forma de iniciarlo: con un solo comando, sin la interfaz. Es útil para scripts y tareas automatizadas:

qwen -p "reread README and update the list of commands"

Esto ejecuta la tarea y termina, sin mantener una conversación. No lo necesitas para dar los primeros pasos, pero conviene tenerlo presente para más adelante.

¿Por qué está en marcha el agente, pero no hace nada por su cuenta?#

El primer obstáculo es el acceso al modelo. Antes, Qwen Code ofrecía acceso gratuito: iniciabas sesión con una cuenta de qwen.ai y el agente funcionaba sin tarjeta. Ese acceso se llamaba Qwen OAuth y se interrumpió. La documentación de autorización lo dice claramente: el nivel gratuito de Qwen OAuth se suspendió el 15 de abril de 2026; es posible que los inicios de sesión guardados anteriormente sigan funcionando durante un breve tiempo, pero el servidor rechaza las solicitudes nuevas. También se eliminó del menú la opción «iniciar sesión con qwen.ai».

Por tanto, para que el agente pueda empezar a razonar sobre una tarea, necesitas conectar un modelo. En la siguiente sección se explican las opciones de conexión, tanto de pago como locales y gratuitas.

El segundo motivo es menos evidente y más frustrante. El modelo está conectado, el agente responde, pero no edita ningún archivo: solo muestra lo que piensa hacer y espera. Es el comportamiento esperado en Ask Permissions, que pide confirmación antes de ediciones y comandos; no demuestra un modo inicial universal. Para que trabaje por su cuenta, tienes que cambiar de modo. Esto se explica dos secciones más abajo, donde encontrarás la respuesta a la pregunta original.

¿Cómo se conecta un modelo ahora que se ha cerrado el acceso gratuito?#

En el agente, escribe el comando:

/auth

Se abrirá un menú con tres opciones principales. Esto es lo que hace cada una.

Alibaba ModelStudio es la opción oficial de los creadores de Qwen. Ofrece un Coding Plan con precio fijo y cuota semanal para desarrolladores individuales, un Token Plan con pago por uso para equipos y la opción de conectar una clave de ModelStudio que ya tengas. Es acceso de pago al modelo «nativo» de Qwen.

Los proveedores externos te permiten elegir un proveedor integrado y conectarte con una clave. La lista oficial incluye DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope y otros. Obtén una clave del proveedor, introdúcela y el agente utilizará el modelo de ese proveedor.

Custom Provider conecta tu propio servidor, proxy o motor local. Aquí es donde puedes conectar un modelo que se ejecute en tu ordenador mediante Ollama. Esta opción admite los formatos OpenAI, Anthropic y Gemini, así que funciona con casi cualquier método de acceso.

También puedes introducir manualmente la clave y la configuración en el archivo ~/.qwen/settings.json. Incluye el campo modelProviders (los modelos disponibles), env (las propias claves), security.auth.selectedType (el protocolo que se activa al iniciar) y model.name (el modelo predeterminado). Entonces qwen se iniciará con esa configuración y no preguntará nada. Para empezar, es más sencillo usar /auth; puedes volver al archivo cuando quieras guardar toda la configuración.

Para ver qué siguió siendo gratuito después de abril, consulta el artículo sobre Qwen Code gratuito.

¿Qué modo debes activar para que el agente edite código por su cuenta?#

Esta es la idea central: el modo de acceso determina cuánta autonomía tiene el agente. Hay cinco modos, del más prudente al más permisivo.

Si el agente solo te muestra los cambios y espera, probablemente está en el modo Ask Permissions (llamado Default en versiones anteriores). En ese caso, tienes que confirmar manualmente cada edición y cada comando, lo que da la impresión de que no hace nada por su cuenta.

Para que edite archivos sin preguntarte, cambia a Auto-Edit. Las ediciones se harán automáticamente, pero el agente seguirá preguntando antes de ejecutar comandos: una protección razonable contra la ejecución accidental de rm en el lugar equivocado.

Auto utiliza un evaluador interno para las acciones que necesitan evaluación. Elígelo expresamente tras comprobar versión y estado activo; el nombre default conservado en la configuración de Ask Permissions es de compatibilidad, no prueba del modo de arranque.

YOLO es el modo más permisivo. El agente edita archivos y ejecuta comandos por su cuenta, sin preguntar nada. La documentación indica que solo debe usarse en proyectos personales de confianza y en flujos de trabajo automatizados. En un proyecto de trabajo es fácil obtener un resultado no deseado, así que actívalo solo con la cabeza despejada y, preferiblemente, sobre una copia.

¿Cómo se cambia de modo durante una sesión?#

Puedes cambiar de modo sobre la marcha, incluso en mitad de una tarea. Pulsa Shift+Tab para avanzar al modo siguiente. En Windows, la tecla Tab normal hace lo mismo. El ciclo es: Plan, confirmaciones, ediciones automáticas, Auto, YOLO y vuelta a Plan.

El modo actual siempre aparece en la línea de estado, en la parte inferior de la interfaz. Acostúmbrate a comprobarlo antes de asignar una tarea importante al agente, para no iniciar YOLO cuando solo querías revisar un plan.

Un flujo adecuado para principiantes tiene tres pasos:

1. Inicia el agente en modo Plan y pídele que analice la tarea y proponga un plan. No tocará nada: solo leerá el código y describirá lo que pretende hacer.
2. Lee el plan y, si estás de acuerdo, cambia a Auto-Edit o Auto pulsando Shift+Tab.
3. Dile que siga adelante. El agente editará los archivos por su cuenta mientras tú supervisas los resultados.

Este enfoque elimina el principal temor de quienes empiezan: que el agente lo estropee todo enseguida. Primero revisas el plan en un modo seguro y solo después le permites continuar.

El enfoque completo del vibe coding se basa en el método; la herramienta es secundaria. Qwen, Claude o cualquier otro: puedes cambiar el modelo que funciona por debajo. Tres fundamentos ayudan a mantener los resultados al cambiar de modelo: un clon de IA, un Second Brain e ingeniería del contexto. En conjunto, producen resultados previsibles; no dependen de la suerte de un único intento.

Un modelo local sin tarjeta#

Instala un modelo abierto en tu ordenador mediante Ollama o vLLM y conéctalo como Custom Provider desde el menú /auth. Después, el agente usará un modelo de tu propio equipo en vez de la nube de Alibaba. No hacen falta tarjeta ni claves, y no hay límite de solicitudes. Para ver qué modelos abiertos pueden programar, consulta esta reseña de modelos gratuitos para programar.

La contrapartida es el hardware. Un modelo que escribe código razonablemente bien ocupa mucha memoria de vídeo. Es viable en un ordenador para juegos con una tarjeta gráfica potente, pero quizá no quepa en un portátil normal. También es posible que tarde tanto en razonar cada respuesta que resulte más fácil buscar otra opción.

Otra ventaja de ejecutarlo localmente es la privacidad de los datos. Todo tu código se queda en tu ordenador; no se envía nada al servidor de otra persona. En un proyecto sensible, eso importa más que ahorrar en una suscripción.

¿Qué puedes hacer para que el agente no estropee el proyecto?#

Un agente autónomo es práctico siempre que haga lo que quieres. Para evitar que un paso en falso te salga caro, adopta tres hábitos.

Primero, usa git. Si el proyecto está bajo control de versiones, puedes ver cada cambio del agente y deshacer cualquiera de ellos. Sin git, un agente autónomo sí es arriesgado: cambia algo y no hay forma de restaurar la versión anterior. Con git, basta un comando corto para revertirlo.

Segundo, empieza en modo Plan. Antes de asignarle una tarea importante, pídele que elabore un plan en un modo en el que no tocará nada. Léelo y asegúrate de entender lo que pretende hacer; después, pasa a las ediciones.

Tercero, ten cuidado con YOLO. En este modo, el agente ejecuta comandos por su cuenta, incluso los que borran archivos. Es demasiado arriesgado para un proyecto de trabajo. Reserva YOLO para copias de prueba y tareas pequeñas en las que no importe que algo salga mal.

Estos tres hábitos responden al temor principal: «Programé con vibe coding y lo estropeé todo». Para saber más sobre cómo revertir cambios en vibe coding, consulta esta reseña aparte. Trata sobre Claude Code, pero el principio de usar git es exactamente el mismo.

¿Por dónde empezar con tu tarea?#

Este es el proceso completo en una lista breve. Síguela de arriba abajo:

1. Instala Qwen Code con un comando y reinicia la terminal.
2. Ve a la carpeta del proyecto con cd y ejecuta qwen.
3. Conecta un modelo mediante /auth: un plan de pago o un modelo local a través de Ollama si no puedes pagar con tarjeta.
4. Asígnale una tarea al agente en modo Plan y lee su plan.
5. Cambia a Auto-Edit o Auto con Shift+Tab y deja que trabaje.
6. Mantén el proyecto bajo git para poder deshacer cualquier edición.

En resumen, «Qwen no escribe código por su cuenta» casi siempre significa que no hay ningún modelo conectado o que el agente está en modo de confirmación. Resuelve lo primero desde el menú /auth y lo segundo pulsando Shift+Tab hasta llegar a Auto-Edit. Después, el agente sí trabaja por su cuenta en la terminal.

Si quieres comparar Qwen con otros agentes para tu tarea, consulta esta reseña de alternativas a Claude Code. Qwen aparece junto a los demás, para que puedas ver cuál conviene para cada caso.

El enfoque completo del vibe coding se basa en el método, y el agente concreto va en segundo lugar: un clon de IA más un Second Brain más ingeniería del contexto. Puedes cambiar la herramienta subyacente; el método sigue siendo el mismo. Recursos prácticos: documentación de Ailoot.

Más recursos y herramientas: Ailoot.