Objetivo del tema
Comprender cómo integrar Qwen Code con entornos gráficos de desarrollo, qué diferencias existen entre la extensión de VS Code y las integraciones por ACP en JetBrains y Zed, y cómo combinar la potencia del CLI con una experiencia visual más cómoda para revisar contexto, conversaciones y cambios de código.
Este tema se apoya en la documentación oficial disponible al 11 de abril de 2026, especialmente en Visual Studio Code, JetBrains IDEs, Zed IDE y la guía de Troubleshooting.
Qwen Code nació como una herramienta centrada en la terminal. Esa sigue siendo su base conceptual. Sin embargo, la documentación actual deja claro que también puede integrarse con editores e IDEs para ofrecer una experiencia más visual y más cercana al flujo cotidiano de muchos desarrolladores.
Trabajar dentro del IDE aporta varias ventajas:
La integración con IDE no reemplaza al CLI. Lo complementa. El valor real aparece cuando combinás conversación, contexto visual y ejecución en el mismo flujo de trabajo.
La documentación muestra que hoy conviene distinguir dos enfoques principales:
| Entorno | Tipo de integración | Idea central |
|---|---|---|
| VS Code | Extensión Qwen Code Companion | Experiencia gráfica nativa con sidebar y sesiones desde el editor. |
| JetBrains y Zed | Agent Client Protocol (ACP) | El IDE habla con Qwen Code como agente externo ejecutado con --acp. |
Esta diferencia importa mucho porque cambia la instalación, el tipo de experiencia y también la forma en que se resuelven problemas.
La documentación de VS Code describe una extensión beta que ofrece una interfaz gráfica integrada directamente en el editor. Se accede mediante un icono lateral de Qwen y permite trabajar con varias sesiones, historial y cambios aplicados en tiempo real.
Entre las funciones destacadas de la extensión aparecen estas:
Esto vuelve a VS Code la opción más amigable para usuarios que prefieren una interfaz gráfica completa por encima de la interacción puramente terminal.
La documentación actual indica un requisito mínimo claro:
Visual Studio Code 1.85.0 o superior
Ese dato es importante porque muchos problemas de instalación se deben simplemente a una versión del editor demasiado antigua.
La forma oficial más directa consiste en instalar la extensión desde el marketplace de Visual Studio Code.
1. Abrí VS Code
2. Buscá la extensión oficial de Qwen Code en el Marketplace
3. Instalála
4. Abrí el panel lateral de Qwen Code
La documentación de overview también la presenta como Qwen Code Companion. En la práctica, el usuario debe pensarla como la pieza que conecta la experiencia visual del editor con el motor operativo de Qwen Code.
Aunque la documentación más reciente separa algunas páginas por editor, la guía general de integración y troubleshooting sigue mencionando comandos muy útiles desde el propio CLI:
/ide install
/ide enable
/ide disable
/ide status
Su función práctica es esta:
/ide install: intenta instalar o reinstalar el companion adecuado/ide enable: activa la conexión con el editor/ide disable: desactiva la integración/ide status: muestra el estado de conexión y el contexto recibido desde el IDEEstos comandos son especialmente útiles cuando el usuario trabaja en VS Code y nota que el companion no conecta bien con la sesión del CLI.
La documentación de integración explica que el companion del editor puede aportar contexto adicional a Qwen Code. Ese contexto incluye, entre otros elementos:
Esta es una diferencia importante frente a una sesión abierta en una terminal aislada. Cuando el IDE colabora correctamente, Qwen Code entiende mejor qué parte del proyecto estás mirando exactamente en ese momento.
La familia JetBrains no usa el mismo companion visual que VS Code. En cambio, la documentación oficial explica una integración a través de ACP, es decir, Agent Client Protocol.
La idea es que el IDE actúa como cliente y Qwen Code como agente externo. Para eso, Qwen Code debe ejecutarse con el argumento --acp.
La documentación destaca estas capacidades en JetBrains:
#Según la documentación oficial, hace falta:
En esta categoría entran entornos como IntelliJ IDEA, WebStorm o PyCharm, siempre que la versión usada soporte el protocolo requerido.
La documentación actual marca este camino como el recomendado:
1. Instalar Qwen Code CLI
2. Abrir la ventana AI Chat en JetBrains
3. Elegir Add ACP Agent
4. Instalar Qwen Code desde ACP Registry
Este método simplifica mucho el alta del agente porque evita editar configuraciones manuales. Si el IDE ya trae soporte ACP maduro, suele ser el mejor camino.
Para versiones más antiguas o entornos donde el registro ACP no esté disponible, la documentación también da un método manual. La configuración base es esta:
{
"agent_servers": {
"qwen": {
"command": "/ruta/al/ejecutable/qwen",
"args": ["--acp"],
"env": {}
}
}
}
El punto más importante es ese --acp. Sin ese argumento, el IDE no se conectará al agente como espera el protocolo.
Zed también usa una integración basada en ACP. La documentación explica que el editor puede trabajar con asistentes de programación IA de forma nativa y que Qwen Code puede sumarse como agente personalizado o instalarse desde el registro ACP.
Las funciones destacadas son muy similares a las de JetBrains:
@La diferencia más visible para el usuario es la sintaxis de mención de archivos. En Zed, la documentación habla de @; en JetBrains, de #.
La guía oficial de Zed indica dos requisitos básicos:
La ruta recomendada hoy por la documentación es instalar Qwen Code desde el registro ACP del propio editor:
1. Instalar Qwen Code CLI
2. Abrir Zed
3. Ir a Configuración
4. Elegir Agregar agente
5. Instalar desde el registro ACP
6. Buscar Qwen Code e instalar
Esto deja la integración más ordenada y evita errores de sintaxis en configuraciones manuales.
Si hace falta configurar el agente a mano, la documentación ofrece una definición como esta:
"Qwen Code": {
"type": "custom",
"command": "qwen",
"args": ["--acp"],
"env": {}
}
De nuevo aparece la misma idea central: Zed no “embebe” a Qwen Code como biblioteca, sino que se conecta a un proceso agente ejecutado con el modo ACP.
| Editor | Modelo principal | Referencia de archivos | Instalación recomendada |
|---|---|---|---|
| VS Code | Companion / extensión gráfica | @ y adjuntos desde interfaz |
Marketplace |
| JetBrains | ACP | # |
ACP Registry |
| Zed | ACP | @ |
ACP Registry |
En la práctica, VS Code ofrece hoy la experiencia más cercana a una extensión dedicada. JetBrains y Zed, en cambio, dependen más claramente de la infraestructura ACP del editor.
Uno de los beneficios más fuertes de usar Qwen Code dentro de un editor es la revisión de cambios. La guía de integración explica que el usuario puede aceptar o rechazar diffs desde la propia interfaz del IDE, sin depender únicamente de la salida del terminal.
En el caso de VS Code, la Command Palette también expone acciones como:
Qwen Code: RunQwen Code: Accept DiffQwen Code: Close Diff EditorEsto reduce fricción cuando querés inspeccionar cambios sugeridos antes de aceptarlos. Es una ventaja importante frente al uso exclusivo del CLI.
La documentación de troubleshooting y de integración menciona varias causas típicas cuando el IDE no logra comunicarse con Qwen Code.
| Problema | Causa probable | Primer paso razonable |
|---|---|---|
| La extensión o el agente no aparecen | Versión antigua del editor o instalación incompleta. | Verificar versión mínima, reinstalar y reiniciar el editor. |
| Qwen Code no responde dentro del editor | La CLI no funciona correctamente fuera del IDE. | Probar primero qwen y qwen --version en una terminal normal. |
| El companion no conecta | El terminal integrado no heredó variables necesarias. | Reabrir el terminal integrado y, si hace falta, reinstalar con /ide install. |
| Se informa desajuste de directorio | Qwen Code se ejecuta fuera del mismo root abierto en el IDE. | Hacer cd al mismo proyecto y relanzar la sesión. |
| No funciona con múltiples carpetas abiertas | La integración requiere un único workspace raíz. | Abrir una sola carpeta y reiniciar la conexión. |
La guía de troubleshooting agrega un detalle importante para quienes trabajan dentro de contenedores: si Qwen Code corre en Docker y el companion del IDE corre en la máquina host, hay que verificar que host.docker.internal resuelva correctamente. Si no, la conexión puede fallar aunque todo lo demás parezca bien instalado.
Este punto suele afectar más a equipos avanzados, pero vale la pena mencionarlo porque el error es poco evidente para quien recién empieza.
No existe una respuesta universal, pero la documentación sugiere un criterio bastante razonable:
La elección correcta no depende solo del agente, sino del editor donde tu equipo ya vive a diario.
qwen --acp.Qwen Code puede trabajar muy bien desde la terminal, pero sus integraciones con IDE agregan una capa visual y contextual que vuelve el flujo mucho más cómodo para muchas personas y equipos.
En este tema vimos las ideas centrales:
qwen --acp.Con esta base, el siguiente paso natural es estudiar el SDK de TypeScript y los desarrollos programáticos, donde Qwen Code deja de integrarse solo con editores y empieza a incrustarse en herramientas propias.