En vivo 18.11 · Cohorte 318 nov, 19:00 MSK — taller práctico gratuito de agentes IA · Cohorte 3 en vivo inicia 23.11Taller 18 nov →Cohorte 3 (23.11)
LanzamientoCódigo / SDK · Listo para usarHabr AI→ original

Configurar Qwen Code: QWEN.md, subagentes y sandbox para dejar de malgastar tokens

Tras la instalación, Qwen Code vuelve a estudiar el repositorio en cada sesión y repite preguntas que bastaría con responder una vez, y tú pagas por ello en tokens. Por ejemplo, no sabe que en el proyecto los paquetes se instalan con pnpm y no con npm, así que lo consulta cada vez. Esos comandos y prohibiciones se anotan en el archivo QWEN.md, que el agente lee al inicio de la sesión. Esta guía, basada en la versión 0.28.0, repasa seis ajustes con los que el agente hace menos preguntas y el gasto baja.

Procesado por IA desde Habr AI; editado por Hamidun News
Configurar Qwen Code: QWEN.md, subagentes y sandbox para dejar de malgastar tokens
Fuente: Habr AI. Collage: Hamidun News.
Escuchar artículo
Ficha técnica y cifras clave
ParámetroDatos
Fuente originalHabr AI ↗
Editor jefe
Dato clave #1QWEN.md se incluye en cada solicitud, así que cada línea de más se paga muchas veces
Dato clave #2El modo Auto revisa cada comando con un modelo: asigna uno barato con /model --fast
Dato clave #3Un subagente revisor sin write_file ni edit no puede modificar el código físicamente

Qwen Code funciona «tal cual» tras la instalación: en cada sesión vuelve a estudiar el repositorio, repite las mismas preguntas y gasta tokens en lo que se podría haber dicho una sola vez. Imagina que en tu proyecto los paquetes se instalan con pnpm y no con npm, y que las pruebas se lanzan con un comando especial. El agente no lo sabe y, en cada sesión, o bien pregunta o bien lo adivina.

Esa información se anota una sola vez en el archivo QWEN.md, es decir, en una nota permanente del proyecto que el agente lee al comienzo de cada sesión. Esta guía se ha contrastado con la documentación de Qwen Code versión 0.

28.0 (noviembre de 2026) y describe seis ajustes: QWEN.md, reglas, modos de confirmación, servidores MCP (herramientas externas), subagentes (ayudantes especializados con permisos recortados) y el sandbox (aislamiento de los comandos del agente).

El objetivo es sencillo: que el agente pregunte menos, gaste menos y no pueda causar daños por accidente. El proyecto cambia rápido, así que, si usas otra versión, consulta qwen --help.

Memoria y reglas: decirlo una sola vez

Los ajustes se guardan en dos lugares: ~/.qwen/settings.json se aplica a ti en todos los proyectos, y .qwen/settings.json, en la raíz del repositorio, solo en ese proyecto; este último se puede subir al repositorio con un commit para que lo tenga todo el equipo. No hace falta guardar ahí las claves de API: para eso existen las variables de entorno o los ajustes de usuario.

QWEN.md es un archivo Markdown normal. Puede haber tres y se cargan todos a la vez: ~/.qwen/QWEN.md para ti en todos los proyectos, QWEN.md en la raíz para todo el equipo y .qwen/QWEN.local.md solo para ti en este proyecto. El archivo local se carga después del común, por lo que sirve para ampliar o sobrescribir las instrucciones del equipo. Tendrás que añadirlo a .gitignore a mano. Si el repositorio ya tiene un AGENTS.md para otras herramientas de IA, Qwen Code también lo leerá.

Lo más rápido para empezar es el comando /init: analiza el código y crea un borrador con los comandos de compilación y las convenciones que haya encontrado. La regla principal es ser breve y concreto. La documentación advierte: cuanto más largo es el archivo, peor lo sigue el modelo. La frase «usa sangría de 2 espacios en TypeScript» funciona; «escribe el código con cuidado», no. Además, QWEN.md se envía en cada solicitud de cada sesión, así que cada línea de más son tokens que pagas muchas veces.

Además del archivo existe la autommemoria: Qwen Code guarda notas por su cuenta en ~/.qwen/projects/<proyecto>/memory/. El comando /remember memoriza al instante, /forget elimina y /memory muestra los archivos cargados. Pero la memoria automática funciona «en la medida de lo posible», así que lo imprescindible escríbelo en QWEN.md.

Si el archivo crece demasiado, parte de las instrucciones se trasladan a reglas: archivos Markdown en .qwen/rules/. Las reglas tienen un campo paths, por ejemplo 'src/*/.tsx'. Así, las instrucciones sobre React solo entran en el contexto cuando el agente abre un archivo que coincide. Mientras edita un Makefile, no ocupan espacio. Una regla sin paths funciona como QWEN.md. Las reglas del proyecto se cargan únicamente si confías en la carpeta (trusted folder).

Confirmaciones, MCP y subagentes

Hay cinco modos de confirmación: Plan (solo lectura), Ask Permissions (pregunta tanto por las ediciones como por los comandos), Auto-Edit (edita archivos por su cuenta y ejecuta comandos con tu consentimiento), Auto (decide un clasificador) y YOLO (lo hace todo solo, únicamente en un entorno aislado). Se cambia con Shift+Tab (en Windows, Tab) o con /approval-mode. En las versiones recientes el modo por defecto es Auto: un modelo clasificador independiente evalúa cada comando, acceso a la red o llamada a una herramienta MCP.

Son solicitudes adicionales a la API. Si no hay un modelo rápido configurado, se usa el principal, y cada comprobación cuesta como una solicitud completa. Por eso conviene asignar uno barato con /model --fast o mediante "fastModel" en los ajustes, o bien cambiar a Auto-Edit.

Los permisos puntuales se definen en el bloque permissions: allow se ejecuta sin preguntar (por ejemplo, git status y pnpm test), ask pregunta siempre (git push) y deny prohíbe por completo (rm -rf y la lectura de .env). El archivo .qwenignore, igual que .agentignore o .aiignore, funciona como .gitignore y ahorra contexto, pero no protege los secretos: no todas las herramientas lo respetan.

MCP (Model Context Protocol) es un estándar abierto para conectar bases de datos, gestores de tareas y documentación. Un servidor se añade con el comando qwen mcp add; la opción --scope project lo guarda en los ajustes del proyecto. Para servicios remotos se recomienda el transporte http; para programas locales y Docker, stdio; sse está obsoleto. Las descripciones de las herramientas también ocupan contexto, así que conecta solo lo necesario y limita el conjunto con includeTools o excludeTools.

Un subagente es un ayudante independiente con sus propias instrucciones, herramientas y contexto. Puede leer cien archivos y el agente principal recibirá solo el resultado. Los archivos están en .qwen/agents/ (los del proyecto tienen prioridad) o en ~/.qwen/agents/. Un revisor con model: fast y las herramientas read_file, grep_search, glob y run_shell_command no puede modificar el código, porque no tiene write_file ni edit. La restricción fiable es la lista tools, no approvalMode: si la sesión principal está en YOLO, un subagente con plan acabará igualmente en YOLO.

Sandbox: lo que el agente podrá hacer aunque no pregunte

Los modos deciden si el agente pregunta; el sandbox determina qué puede hacer incluso cuando no ha preguntado. Si trabajas aunque sea de vez en cuando en Auto o YOLO, lo necesitas. En las últimas versiones para Linux ha aparecido un modo en el que Qwen Code funciona con normalidad, mientras que los comandos y las operaciones con archivos del agente se ejecutan aislados mediante bwrap (Bubblewrap).

Empieza con /init, acorta QWEN.md, traslada las instrucciones específicas a reglas, asigna un modelo rápido con /model --fast, reparte los comandos entre allow y deny, crea un revisor de solo lectura y activa el sandbox.

Historia

Preguntas frecuentes sobre la noticia

¿Qué se sabe sobre Memoria y reglas: decirlo una sola vez?

Los ajustes se guardan en dos lugares: ~/.qwen/settings.json se aplica a ti en todos los proyectos, y .qwen/settings.json, en la raíz del repositorio, solo en ese proyecto; este último se puede subir al repositorio con un commit para que lo tenga todo el equipo. No hace falta guardar ahí las claves de API: para eso existen las variables de entorno o los ajustes de usuario. QWEN.md es un archivo Markdown normal.

¿Qué se sabe sobre Confirmaciones, MCP y subagentes?

Hay cinco modos de confirmación: Plan (solo lectura), Ask Permissions (pregunta tanto por las ediciones como por los comandos), Auto-Edit (edita archivos por su cuenta y ejecuta comandos con tu consentimiento), Auto (decide un clasificador) y YOLO (lo hace todo solo, únicamente en un entorno aislado). Se cambia con Shift+Tab (en Windows, Tab) o con /approval-mode.

¿Qué se sabe sobre Sandbox: lo que el agente podrá hacer aunque no pregunte?

Los modos deciden si el agente pregunta; el sandbox determina qué puede hacer incluso cuando no ha preguntado. Si trabajas aunque sea de vez en cuando en Auto o YOLO, lo necesitas. En las últimas versiones para Linux ha aparecido un modo en el que Qwen Code funciona con normalidad, mientras que los comandos y las operaciones con archivos del agente se ejecutan aislados mediante bwrap (Bubblewrap).

ZK
Zhemal Khamidun — CPO de Alpina Digital, product manager de AlpinaGPT. Crea productos de IA desde 2019. Hamidun News es un proyecto personal que creció hasta ser un agregador en producción con más de 6.000 lectores.
✦ Unified AI Workspace · Nomad

Test Frontier LLMs & Autonomous Agents in One Workspace

Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.

Try Nomad AI →Launch Nomad Agent
¿Qué te parece?
Cargando comentarios…