# Qwen Code y Qwen 3.7-max: configurar Token Plan > Instalar Qwen Code con Node.js 22, conectar el Token Plan internacional y evitar tres errores que provocan errores 401: la dirección de la API, la clave y la asignación de la plaza. Source: https://ailoot.ai/blog/es/qwen-code-token-plan-setup/ Canonical: https://ailoot.ai/blog/es/qwen-code-token-plan-setup/ Language: es Publisher: Ailoot (https://ailoot.ai/) Translation: guide-207 Revision: sha256-835acf8161d6fb74d57f59f2d20d7e7582482026ab90ad54029f208b9c3da0f1 Documentación de referencia de Ailoot: [ailoot.ai/docs/](https://ailoot.ai/docs/). **Actualizado el 03.10.2026:** desde la publicación han cambiado tres cosas. Alibaba cerró Coding Plan a nuevas compras: el nivel Lite ya en marzo, y Pro está agotado. Token Plan pasó de una cuota semanal a una mensual. Se ha lanzado un modelo más reciente, Qwen3.8-max. También corregí un error en la descripción de la clave de Token Plan: es importante para ese mismo error 401 y lo explico más abajo. ## ¿Qué es Qwen Code y por qué no es simplemente otra copia?
Punto clave Qwen Code es un agente de IA de código abierto para terminal, creado por Alibaba, que funciona como Claude Code: se ejecuta en el terminal de VS Code, lee tu proyecto, escribe código y ejecuta comandos. La diferencia principal es que permite acceder a una docena de modelos con una sola suscripción, incluidos Qwen 3.7, DeepSeek V4 y Kimi K2.
Cuando oí hablar de Qwen Code por primera vez, pensé: «Otro clon de Claude Code que fallará en el segundo prompt». Me equivocaba. Alibaba no copió la interfaz: creó su propio agente CLI desde cero, pero con compatibilidad total con la API de OpenAI. Eso significa que puedes ejecutar en él no solo modelos de Qwen, sino también DeepSeek, GLM, Kimi e incluso Claude mediante la API de Anthropic. Esto es lo que realmente puede hacer: - Lee la estructura del proyecto y entiende el contexto (como Claude Code con `CLAUDE.md`) - Ejecuta comandos de shell, edita archivos y crea commits - Admite Skills y SubAgents - Funciona en VS Code mediante el terminal integrado o una extensión - Cambia entre modelos con un solo comando `/model` Tiene una desventaja, pero es importante: **el nivel gratuito se cerró el 15 de abril de 2026**. Antes, Qwen OAuth te daba 100 solicitudes gratuitas al día; ahora solo quedan opciones de pago. Aun así, incluso Qwen Code de pago cuesta bastante menos que una suscripción Claude Pro. Si ahora estás eligiendo entre herramientas, cubrí todas las opciones en la guía [«Con qué programar en 2026: 8 herramientas de IA»](https://ailoot.ai/blog/es/ai-coding-tools/). ## ¿Cuánto cuesta y qué plan deberías elegir?
Punto clave Alibaba ofrece tres opciones de pago: pago por token, la suscripción Coding Plan y la suscripción Token Plan. Para programar con IA a diario, Token Plan es la mejor opción: una cuota mensual fija, más de 10 modelos y sin necesidad de contar tokens.
La confusión sobre los planes es el mayor quebradero de cabeza al configurar Qwen Code. Alibaba usa nombres distintos en diferentes partes de la consola, e incluso la extensión de VS Code muestra opciones equivocadas. Así es como funciona realmente (comprobado con la documentación de Alibaba Cloud, actualizada allí el 28.09.2026). | Plan | Qué es | Para quién | Coste aproximado | |----|----|----|----| | **Pay-as-you-go** | Pagas por separado cada millón de tokens | Uso ocasional, para probarlo | 0,30–1,20 $ por millón de tokens | | **Coding Plan** | Suscripción para particulares, con una cuota mensual (la cuota semanal se discontinuó el 22.09.2026) | Actualmente no disponible para nuevos suscriptores: el nivel Lite dejó de estar disponible para compra el 20.03.2026 y Pro está agotado | Actualmente no disponible para nuevas cuentas | | **Token Plan Team Edition, Standard Seat** | 25.000 Credits por plaza al mes, más de 10 modelos | Programación diaria con IA y cambios de modelo | 20 $/plaza al mes en promoción (precio habitual: 30 $) | Según la experiencia descrita por el autor, se eligió **Token Plan** porque una suscripción da acceso a Qwen 3.7-max (y al más reciente Qwen3.8-max), DeepSeek V4 Pro y GLM-5. Todos los modelos consumen del mismo fondo de Credits. Cambia de uno a otro con el comando `/model`: no necesitas comprar una clave distinta para cada proveedor. **Importante:** Coding Plan y Token Plan son **productos diferentes** con direcciones de API distintas. Una clave de Coding Plan tiene el prefijo `sk-sp-`. Una clave de Token Plan no tiene ningún prefijo: así la describe la documentación oficial de Qwen Code. Si confundes la dirección o la clave de un producto con los del otro, recibirás un error 401. Y como Coding Plan ya no admite nuevas compras, actualmente Token Plan es la única opción que funciona para la mayoría de los lectores. ## ¿Cómo se instala Qwen Code?
Punto clave Hay dos opciones: mediante npm (`npm install -g @qwen-code/qwen-code@latest`) o Homebrew (`brew install qwen-code`). Necesitas Node.js 22 o posterior. Después de instalarlo, ejecuta `qwen` en el terminal.
Comprueba tu versión de Node.js antes de instalarlo: ```bash node --version ``` Necesitas **la versión 22 o posterior**. Si tienes una anterior, actualízala desde [nodejs.org](https://nodejs.org/en/download) o con `nvm`: ```bash nvm install 22 nvm use 22 ``` A continuación, instala Qwen Code con un comando: ```bash npm install -g @qwen-code/qwen-code@latest ``` O usa Homebrew en macOS: ```bash brew install qwen-code ``` Compruébalo: ```bash qwen --version ``` Si muestra una versión, ya está listo. Inicia Qwen Code con el comando `qwen` en el terminal. En VS Code, abre el terminal integrado (Ctrl+`) y escribe `qwen\`. También hay una **extensión para VS Code**: `Qwen Code Companion`, de QwenLM, en el marketplace. Añade una barra lateral de chat, como GitHub Copilot. Yo uso esa: es más práctica que el terminal sin más. ## ¿Dónde crear una cuenta y comprar Token Plan para Qwen Code?
Punto clave Regístrate en la consola internacional de Alibaba Cloud (modelstudio.console.alibabacloud.com), añade una tarjeta aceptada por el proveedor y suscríbete a Token Plan. Todo el proceso lleva 10 minutos.
Paso a paso: 1. Ve a [modelstudio.console.alibabacloud.com](https://modelstudio.console.alibabacloud.com/) 2. Haz clic en **Free Sign Up**, arriba a la derecha 3. Introduce tu correo electrónico (Gmail funciona) y confirma el código que recibas 4. Añade tu número de teléfono 5. Añade una tarjeta aceptada por el proveedor. Alibaba cobrará 1 $ para verificarla y te lo devolverá en 1–3 días. 6. En la consola, busca la sección **ModelStudio** y, dentro de ella, la pestaña **Token Plan** 7. Elige el nivel **Standard** (el mínimo para empezar) 8. Confirma el pago Después de la compra, llegarás a la página **My Subscriptions**. Allí verás: - **Standard Seat: 0/1**: significa que has comprado una plaza, pero aún no te la has asignado - Haz clic en **Assign**, selecciona tu cuenta y confirma - Debería cambiar a **1/1** La clave de API no funcionará si no haces esto. Según la experiencia descrita por el autor, este paso le llevó 20 minutos. ## ¿Dónde se obtiene la clave de API y la dirección correcta?
Punto clave La clave de API y la dirección de la API (Base URL) están en la página Management Platform. Para Token Plan internacional, la dirección es `https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`. No la confundas con la dirección habitual de DashScope: la clave de Token Plan no funcionará allí.
En la página **My Subscriptions**, haz clic en el botón grande morado **Go to Management Platform**. Se abrirá un panel aparte. Selecciona **Overview** en el menú de la izquierda. En esta página verás dos secciones: **Plan-specific API Key**: tu clave personal. Está oculta tras asteriscos. Haz clic en el **icono de copiar** que aparece junto a ella (no la selecciones con el ratón: se copiarán los asteriscos). Las claves de Token Plan no tienen prefijo. No es un error en las instrucciones: así las describe la documentación oficial de Qwen Code. Si ves `sk-sp-`, es una clave de **Coding Plan**, de otro producto; has copiado la clave equivocada. **Plan-specific Base URL**: dos opciones: - Para herramientas compatibles con OpenAI (Qwen Code): `https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1` - Para herramientas compatibles con Anthropic: `https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic` Recuerda: **solo estas direcciones funcionan con una clave de Token Plan**. La dirección estándar `dashscope-intl.aliyuncs.com` es para claves normales (Pay-as-you-go), mientras que `coding-intl.dashscope.aliyuncs.com` es la dirección de Coding Plan. Si usas una clave de Token Plan con cualquiera de las dos, recibirás un error 401. ## ¿Cómo se conecta a VS Code?
Punto clave Configura la extensión de VS Code mediante el archivo `~/.qwen/settings.json`. Tienes que introducir la clave, la dirección API correcta y el modelo. Aquí tienes una configuración lista para usar: cópiala y sustituye la clave por la tuya.
Si instalaste la extensión **Qwen Code Companion** desde el marketplace de VS Code: 1. Abre la paleta de comandos (Cmd+Shift+P) 2. Escribe **Qwen Code: Choose Provider** 3. Si aparece un menú de opciones, **no elijas Coding Plan** (es un producto distinto). Elige **Standard API Key** 4. Pega la clave de Management Platform: las claves de Token Plan no tienen un prefijo fijo 5. Región: **Singapur** 6. Modelo: `qwen3.7-max` Si después aparece un error, **configúralo manualmente mediante el archivo**. A veces la extensión completa la dirección equivocada. Abre o crea el archivo `~/.qwen/settings.json` y pega lo siguiente: ```json { "env": { "TOKEN_PLAN_API_KEY": "YOUR-KEY-FROM-MANAGEMENT-PLATFORM" }, "modelProviders": { "openai": [ { "id": "qwen3.7-max", "name": "qwen3.7-max", "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1", "envKey": "TOKEN_PLAN_API_KEY", "generationConfig": { "extra_body": { "enable_thinking": true }, "contextWindowSize": 262144 } }, { "id": "qwen3.6-plus", "name": "qwen3.6-plus", "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1", "envKey": "TOKEN_PLAN_API_KEY", "generationConfig": { "extra_body": { "enable_thinking": true }, "contextWindowSize": 1000000 } }, { "id": "deepseek-v4-pro", "name": "deepseek-v4-pro", "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1", "envKey": "TOKEN_PLAN_API_KEY", "generationConfig": { "extra_body": { "enable_thinking": true }, "contextWindowSize": 1000000 } } ] }, "security": { "auth": { "selectedType": "openai" } }, "model": { "name": "qwen3.7-max" } } ``` Sustituye `YOUR-KEY-FROM-MANAGEMENT-PLATFORM` por tu clave de Management Platform. Reinicia VS Code. Listo. ## ¿Por qué aparece un error 401 y cómo se soluciona?
Punto clave En el 90 % de los casos, un error 401 al configurar Qwen Code significa que la dirección de la API o la clave es incorrecta. Token Plan, Coding Plan y Pay-as-you-go usan direcciones distintas, y sus claves no son intercambiables.
El autor describió los errores que encontró durante la configuración. Esta es la lista completa de las causas de los errores 401 y cómo comprobarlas: | Síntoma | Causa | Solución | |----|----|----| | `invalid_api_key` | Se envía una clave de Token Plan a la dirección de DashScope (o al revés) | Comprueba la Base URL. Para Token Plan: `token-plan.ap-southeast-1...`; para Coding Plan: `coding-intl.dashscope...` | | `invalid access token` | No se ha asignado el Standard Seat (0/1) | Ve a My Subscriptions, haz clic en Assign y comprueba que aparezca 1/1 | | `invalid_api_key` | La extensión de VS Code generó su propia clave mediante el flujo de autenticación, en lugar de usar Token Plan | Abre `~/.qwen/settings.json` y comprueba que la clave coincida con la que aparece en Management Platform (no la confundas con la clave de Coding Plan, que tiene el prefijo `sk-sp-`) | | `invalid_api_key` | Se copió un espacio o un salto de línea junto con la clave | Elimina la clave y vuelve a copiarla con el icono de copiar (no la selecciones con el ratón) | | `model not found` | El modelo no está incluido en tu plan | Comprueba la lista Available Models en la página de suscripción | | `Insufficient quota` | Se han agotado los Credits | Comprueba Usage en My Subscriptions. Si está al 100 %, espera a que se restablezca o compra un Boost Pack | **Comprobación rápida de la clave desde el terminal:** ```bash curl -s -o /dev/null -w "%{http_code}" -X POST \ "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"qwen3.7-max","messages":[{"role":"user","content":"hi"}],"max_tokens":5}' ``` Si devuelve `200`, la clave funciona y el problema está en la configuración de la extensión. Si devuelve `401`, la clave o la dirección es incorrecta. ## ¿Qué modelos están disponibles y cuál deberías elegir?
Punto clave Token Plan ofrece más de 10 modelos de 5 proveedores; el nuevo modelo insignia Qwen3.8-max se añadió en agosto de 2026. Para programar con IA, el principal modelo de uso general es qwen3.6-plus (un equilibrio entre precio y calidad). Para tareas complejas, usa qwen3.7-max o el más reciente qwen3.8-max. Para ediciones rápidas, usa qwen3.6-flash.
Estos son los modelos realmente útiles para programar con IA: | Modelo | Cuándo usarlo | Consumo de Credits | |----|----|----| | **qwen3.8-max** | El nuevo modelo insignia de Alibaba (lanzado en agosto de 2026), máxima calidad en tareas complejas | Alto: los Credits se agotan más rápido que con 3.7-max | | **qwen3.7-max** | Arquitectura compleja, refactorización de un proyecto grande, generación desde cero | Alto: la cuota se agota en una semana si programas a diario | | **qwen3.6-plus** | Modelo de uso diario: ediciones, mejoras, revisiones y explicaciones | Medio: suficiente para un mes dedicándole 2–4 horas al día | | **qwen3.6-flash** | Ediciones rápidas, preguntas sencillas y formato | Bajo | | **deepseek-v4-pro** | Alternativa a Qwen: a veces mejor para tareas algorítmicas y matemáticas | Medio | | **kimi-k2.6** | Contexto largo: leer grandes bases de código y analizar documentación | Medio | Cambia de modelo directamente en tu sesión de Qwen Code con el comando `/model`: no hace falta modificar la configuración ni reiniciar. **Yo empezaría con `qwen3.6-plus`.** Si al cabo de una semana notas que la cuota se agota demasiado rápido, cambia a `qwen3.6-flash` para las tareas habituales y reserva `qwen3.7-max` para las tareas complejas. ## Qwen Code o Claude Code: ¿cuál deberías usar?
Punto clave Claude Code produce mejor código y entiende mejor el contexto. Qwen Code cuesta menos y te da acceso a varios modelos con una suscripción. La combinación ideal: Claude Code para el trabajo principal y Qwen Code para tareas paralelas y experimentos.
La comparación se basa en el mes que el autor pasó trabajando con ambas herramientas: | Criterio | Claude Code | Qwen Code | |----|----|----| | Calidad del código | Mejor: desde entonces, Anthropic ha lanzado modelos más recientes (Opus 5.5, 22.09.2026); la diferencia no se ha reducido | Buena, pero incluso el nuevo modelo insignia Qwen3.8-max queda por detrás de los mejores modelos de Anthropic en pruebas independientes | | Comprensión del proyecto | `CLAUDE.md` + lectura profunda del árbol = funciona como una persona | Mecánica similar, pero menos refinada | | Precio | Claude Pro: 20 $/mes (Max: 100–200 $/mes para programar intensivamente) | Token Plan Standard desde 20 $/mes, incluye más de 10 modelos | | Selección de modelos | Solo Claude (Opus/Sonnet/Haiku) | Qwen + DeepSeek + GLM + Kimi + MiniMax | | Código abierto | No (código cerrado) | Sí (licencia MIT) | | Extensión de VS Code | Nativa, estable | Disponible, pero poco pulida; a veces da problemas con las claves | **Cuándo Qwen Code es una mejor opción:** - Necesitas acceder a varios modelos (DeepSeek para matemáticas, Kimi para contexto largo) - Estás probando distintos enfoques para una misma tarea - Tienes un presupuesto limitado, pero programas a diario - Quieres una herramienta de código abierto que puedas personalizar **Cuándo Claude Code es indispensable:** - En un proyecto crítico, donde la calidad del código equivale a dinero - Al trabajar con un gran proyecto heredado (Opus conserva mejor el contexto); expliqué aparte [cómo evitar agotar los límites de Claude Code](https://ailoot.ai/blog/es/claude-code-token-limits-saving/) - Si necesitas una extensión de VS Code estable que no requiera configuración manual La combinación descrita según la experiencia del autor: **Claude Code para el proyecto principal**, **Qwen Code para experimentos y tareas paralelas**, donde puedes probar rápidamente una idea con un modelo más barato. Para una comparación detallada con otras herramientas, consulta [Cursor vs. Claude Code](https://ailoot.ai/blog/es/cursor-vs-claude-code/) y [Codex vs. Claude Code](https://ailoot.ai/blog/es/codex-vs-claude-code-choice/). ## Tres errores que todo el mundo comete
Punto clave Token Plan y Coding Plan son productos distintos con direcciones diferentes. La extensión de VS Code rellena una clave incorrecta. Tienes que asignar la plaza manualmente. Estos tres errores pueden hacerte perder desde 30 minutos hasta varias horas: me encontré con los tres y anoté las soluciones.
### Error 1: Token Plan ≠ Coding Plan Alibaba llama a estos productos de formas distintas en diferentes secciones de la consola. La opción «Coding Plan» de la extensión de VS Code **no es Token Plan**. Ten en cuenta que, desde el 20.03.2026, Coding Plan Lite está cerrado a nuevas compras y Pro está agotado. Si aún no lo tienes, solo puedes elegir Token Plan. Tienen direcciones de API distintas: - **Token Plan**: `https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1` - **Coding Plan**: `https://coding-intl.dashscope.aliyuncs.com/v1` Si compraste Token Plan pero configuraste la extensión como Coding Plan, recibirás un error 401. Y viceversa. ### Error 2: la extensión de VS Code genera su propia clave Al configurar la extensión desde su interfaz gráfica (Cmd+Shift+P - Qwen Code: Choose Provider), a veces genera **su propia clave mediante la API de autenticación de Alibaba**. Esta clave tiene un formato distinto y no está vinculada a tu suscripción de Token Plan. Solución: después de configurarla mediante la interfaz gráfica, abre `~/.qwen/settings.json` y asegúrate de que la clave en `env` coincida con la que aparece en **Management Platform** (Overview - Plan-specific API Key). Si no coincide, sustitúyela manualmente. ### Error 3: no se ha asignado el Standard Seat Después de comprar Token Plan, verás **Standard Seat: 0/1** en la página My Subscriptions. Esto significa que has comprado la plaza, pero **no está vinculada a tu cuenta**. La clave de API no funcionará hasta que hagas clic en **Assign**. Según la experiencia del autor, tardó 20 minutos en depurar el error 401 antes de darse cuenta de esta línea. ## ¿Cómo se comprueba que todo funciona?
Punto clave Dos pasos: primero comprueba la clave con curl en el terminal (debería devolver 200) y luego escribe cualquier prompt en Qwen Code. Si curl funciona, pero la extensión no, el problema está en la configuración del archivo `~/.qwen/settings.json`.
**Paso 1. Comprueba la clave desde el terminal:** ```bash curl -X POST \ "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions" \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"qwen3.6-plus","messages":[{"role":"user","content":"Hello"}]}' ``` Si la respuesta contiene texto del modelo, la clave y la dirección funcionan. **Paso 2. Compruébalo en Qwen Code:** Abre VS Code, abre el terminal integrado y escribe `qwen`. Si se inicia, escribe algo: ``` ¿Qué es este proyecto en esta carpeta? ``` Qwen Code leerá la estructura y responderá. Si lo hace, la configuración está completa. **Paso 3. Comprueba el consumo de Credits:** Cinco minutos después de tus primeras solicitudes, ve a Management Platform - Overview - Usage Consumption. El porcentaje debería ser distinto de cero. Si sigue en 0 % después de más de 10 solicitudes, estás usando la dirección equivocada (las solicitudes no pasan por la suscripción: van a Pay-as-you-go o a ninguna parte). ## ¿Qué sigue?
Punto clave Qwen Code ya está configurado y puedes empezar a programar con IA. Pero la herramienta es solo el principio. La diferencia entre «he instalado el CLI» y «estoy creando un producto con IA» está en la metodología para trabajar con el contexto.
Has instalado Qwen Code y funciona. Puedes abrir cualquier proyecto y empezar a desarrollarlo mediante un diálogo con la IA. La siguiente pregunta es: ¿por qué el mismo prompt en Qwen Code produce un resultado excelente en un proyecto y un desastre en otro? Todo depende del contexto. Si el proyecto tiene una estructura `business/` con la audiencia, los productos y los objetivos, la IA trabaja como un socio. Si la carpeta está vacía, alucina.
### Fuentes - [Qwen Code en GitHub](https://github.com/QwenLM/qwen-code): código fuente y documentación, consultados el 03.10.2026 - [Alibaba Cloud ModelStudio](https://modelstudio.console.alibabacloud.com/): consola para gestionar suscripciones y claves - [Resumen de Token Plan](https://www.alibabacloud.com/help/en/model-studio/token-plan-overview): planes actuales y estado de Coding Plan, actualizado por Alibaba el 28.09.2026, consultado el 03.10.2026 - [Documentación de Qwen Code: autenticación](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/): formatos de las claves de Token Plan y Coding Plan, consultada el 03.10.2026
Sigue explorando Ailoot en [ailoot.ai](https://ailoot.ai/). ## Preguntas sobre Qwen Code ### ¿Qué compruebo primero si una clave de Token Plan devuelve 401? Confirma que la clave y la Base URL pertenecen a Token Plan y no a Coding Plan o DashScope normal. Copia la clave con el botón de la consola y comprueba que el Standard Seat comprado esté asignado. Compara después los ajustes guardados en la extensión con esa misma configuración. ### ¿Una solicitud correcta en terminal demuestra que la extensión de VS Code está configurada? No. Verifica la clave, el endpoint y el modelo usados en esa solicitud. Prueba un prompt por separado en Qwen Code y compara su Base URL y clave guardadas con la solicitud que funciona. Comprueba también el consumo en la suscripción prevista. ## Ailoot · La empresa y su cartera de proyectos Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI. La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes. Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.