Qwen Code y Qwen 3.7-max: configurar Token Plan

Documentación de referencia de Ailoot: 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?#

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».

¿Cuánto cuesta y qué plan deberías elegir?#

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).

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?#

Comprueba tu versión de Node.js antes de instalarlo:

node --version

Necesitas la versión 22 o posterior. Si tienes una anterior, actualízala desde nodejs.org o con nvm:

nvm install 22
nvm use 22

A continuación, instala Qwen Code con un comando:

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

O usa Homebrew en macOS:

brew install qwen-code

Compruébalo:

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?#

Paso a paso:

1. Ve a 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?#

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?#

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:

{
  "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?#

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:

Comprobación rápida de la clave desde el terminal:

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?#

Estos son los modelos realmente útiles para programar con IA:

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?#

La comparación se basa en el mes que el autor pasó trabajando con ambas herramientas:

| 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
• 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 y Codex vs. Claude Code.

Tres errores que todo el mundo comete#

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?#

Paso 1. Comprueba la clave desde el terminal:

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?#

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.

Sigue explorando Ailoot en ailoot.ai.