Qwen4-Max-Preview: Claude Code, configuración y fin el 25 de noviembre
Prueba Qwen4-Max-Preview con una clave específica de Token Plan y el endpoint correcto. Configura Claude Code, OpenCode o Qwen Code, comprueba la lectura de un archivo y reserva tokens para el razonamiento y la respuesta. Prepara una ruta independiente con pago por uso antes de la retirada. Incluye precios de suscripción, restricciones de uso y una alternativa con Qwen3.8-Max.
Índice
Usa Qwen4-Max-Preview para una prueba interactiva de programación con duración limitada, no como backend de una aplicación. Conéctate mediante Token Plan con su clave específica y selecciona qwen4-max-preview de forma explícita, sin depender de la selección automática. Prepara una alternativa antes del 25 de noviembre de 2026, 24:00 UTC+8, cuando termina el periodo documentado de la versión preliminar.
La disponibilidad, la configuración y los precios que siguen corresponden al 2026-11-12.
¿Qué acceso hay y cuándo termina?
Qwen4-Max-Preview está disponible mediante Token Plan Personal y Team, sin acceso de pago por uso. El periodo preliminar va del 11 de noviembre de 2026 a las 10:00 al 25 de noviembre de 2026 a las 24:00. Ambos horarios corresponden a UTC+8. Alibaba indica que el modelo no cambiará durante este periodo y se retirará después.
El cierre equivale al 26 de noviembre a las 00:00 UTC+8, o al 25 de noviembre a las 16:00 UTC. No establece una fecha de lanzamiento para un modelo sustituto.
El modelo tiene una ventana de contexto de 1M tokens y una salida máxima de 393,216 tokens. El razonamiento y la respuesta final comparten ese límite de salida. Acepta texto, imágenes y vídeo, y admite llamadas a funciones y salida estructurada.
Alibaba documenta compatibilidad con Chat Completions, Responses y Anthropic Messages. Eso no significa que todos los clientes permitan usar todas las capacidades del modelo. Compara tareas con Qwen3.8-Max; no des por establecida una clasificación de rendimiento.
Que Token Plan y Qwen Chat muestren el mismo nombre de modelo no demuestra que usen la misma configuración de servicio o de herramientas. Compara resultados en el mismo cliente, con las mismas herramientas, instrucciones y presupuesto de salida.
¿Cuánto cuesta Token Plan y qué usos permite?
Presupuesta una suscripción, no una tarifa de Qwen4 por millón de tokens. La descripción de Personal Edition publica estos precios mensuales para nuevas suscripciones, sin ofertas iniciales:
| Plan Personal | Precio mensual de lista, USD | Cuota mensual |
|---|---|---|
| Lite | $6 | 20,000 Credits |
| Essential | $10 | 45,000 Credits |
| Standard | $18 | 80,000 Credits |
| Pro | $43 | 200,000 Credits |
Credits es la unidad de facturación de la suscripción, no una cantidad fija de tokens. Comprueba el consumo real después de la tarea de prueba. No conviertas esta tabla en una supuesta tarifa de tokens de API.
Las preguntas frecuentes de Personal indican que las llamadas se bloquean al agotar la cuota aplicable. El exceso no pasa automáticamente a pago por uso. Comprar paquetes adicionales y renovar la suscripción son decisiones independientes.
Personal Edition no admite actualmente la cancelación de la suscripción. No asumas que la retirada de la versión preliminar cancela tu suscripción o te da derecho a un reembolso. Revisa la configuración de renovación antes de comprar solo para esta prueba.
Ambas ediciones limitan el acceso al uso interactivo en herramientas de programación y agentes. Los scripts automatizados, los backends de aplicaciones y las tareas por lotes no interactivas quedan fuera del uso documentado. La política de Team Edition establece el mismo límite.
Las llamadas a herramientas que hace un agente durante una sesión interactiva no equivalen a un script de evaluación programado. Usa los ejemplos siguientes de forma interactiva. No conviertas la clave de Token Plan en una credencial genérica para un backend.
Consigue la clave específica antes de configurar el cliente
Usa una clave de Token Plan con un endpoint de Token Plan. Una clave estándar de Model Studio o una de Coding Plan no sirve como sustituto.
Para Personal Edition, suscríbete y genera la clave en My Subscription, dentro de la consola de Token Plan. Sigue la guía de inicio de Personal.
En Team Edition, un administrador debe asignar un puesto a tu cuenta antes de generar su clave. La guía de inicio de Team sitúa este paso en Member Management.
Los ejemplos presuponen que ya tienes el cliente instalado y usas Bash en macOS o Linux. Abre una terminal nueva. Ejecuta el comando, pega tu clave y pulsa Enter:
read -rs TOKEN_PLAN_API_KEY && export TOKEN_PLAN_API_KEYEl comando no muestra la clave introducida. Inicia el cliente desde esta terminal para que reciba la variable exportada.
Configura Claude Code y comprueba que lee un archivo
Asigna Qwen4-Max-Preview a la opción Opus y selecciónala de forma explícita. La configuración de Claude Code de Alibaba utiliza las siguientes asignaciones para Token Plan.
Ejecuta estos comandos desde un repositorio que contenga README.md:
unset ANTHROPIC_API_KEY
export ANTHROPIC_AUTH_TOKEN="$TOKEN_PLAN_API_KEY"
export ANTHROPIC_BASE_URL="https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic"
export ANTHROPIC_MODEL="auto"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3.6-flash"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.8-flash"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen4-max-preview"
export CLAUDE_CODE_SUBAGENT_MODEL="auto"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="983616"
claude --model opusEn Claude Code, la URL base termina en /apps/anthropic. No añadas /v1.
El argumento --model opus selecciona el modelo principal asignado a ese alias. Así lo establecen las reglas de selección de modelos y alias de Claude Code.
Las demás asignaciones permiten utilizar otros modelos para tareas auxiliares. En particular, CLAUDE_CODE_SUBAGENT_MODEL="auto" no fija Qwen4-Max-Preview para todos los subagentes. No presentes una sesión entera con varios modelos como una prueba exclusiva de Qwen4.
Introduce esta instrucción en la sesión interactiva:
Read README.md using the file tool. Quote its first heading and summarize the project in two sentences. Do not modify files.Comprueba que aparece una operación de lectura y que el encabezado citado coincide con el del archivo real. Después revisa el consumo de Token Plan durante ese periodo. Un saludo genérico verifica menos que un ciclo completo de llamada a una herramienta.
A continuación, prueba un cambio acotado que tenga un test de aceptación conocido. Registra el modelo seleccionado, el nivel de razonamiento, el tiempo transcurrido, el resultado del test y los Credits consumidos.
Si Claude Code parece seguir usando otro proveedor, aplica el procedimiento para verificar la ruta activa antes de evaluar el modelo.
Corrige la salida truncada sin confundirla con el contexto
Aumenta el presupuesto de salida cuando una respuesta larga se corte. Alibaba recomienda específicamente CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000 para este modelo.
Sal del cliente y vuelve a iniciarlo desde la misma terminal de Bash:
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000
claude --model opusEste ajuste es distinto de CLAUDE_CODE_MAX_CONTEXT_TOKENS="983616". Ninguno garantiza una respuesta de 393,216 tokens. El máximo del modelo, la configuración del cliente y el presupuesto de la petición son límites diferentes.
Usa OpenCode o Qwen Code como alternativa
Aplica la configuración del cliente que vayas a utilizar; sus URL base no son intercambiables. Guarda una copia de seguridad de la configuración existente y conserva los ajustes ajenos a estos ejemplos.
OpenCode: conserva el /v1 final del adaptador
Usa la configuración del adaptador Anthropic de Alibaba en ~/.config/opencode/opencode.json.
El ejemplo utiliza el esquema de proveedores V1 publicado por Alibaba. La documentación de migración de OpenCode V2 indica que sigue aceptando las configuraciones V1 compatibles. No mezcles campos nativos de V2 dentro de este objeto de proveedor.
{
"$schema": "https://opencode.ai/config.json",
"model": "bailian-token-plan/qwen4-max-preview",
"provider": {
"bailian-token-plan": {
"npm": "@ai-sdk/anthropic",
"options": {
"baseURL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic/v1",
"apiKey": "{env:TOKEN_PLAN_API_KEY}"
},
"models": {
"qwen4-max-preview": {
"name": "Qwen4-Max-Preview",
"modalities": {
"input": ["text", "image"],
"output": ["text"]
},
"limit": {
"context": 1000000,
"output": 131072
}
}
}
}
}
}El /v1 final es intencional para este adaptador, como muestra la guía de OpenCode de Alibaba. No copies aquí la URL base más corta de Claude Code.
El valor de salida 131072 procede de la entrada del modelo en la configuración de OpenCode de Alibaba. Es un ajuste del cliente, no una modificación del máximo publicado de 393,216 tokens.
La sustitución de variables de entorno de OpenCode obtiene la clave exportada mediante {env:TOKEN_PLAN_API_KEY}. Ejecuta opencode, confirma el proveedor y el modelo con /models y repite la instrucción de lectura del archivo.
Qwen Code: establece explícitamente el presupuesto de salida compartido
Usa el endpoint de Token Plan compatible con OpenAI en ~/.qwen/settings.json.
La guía de Qwen Code de Alibaba documenta un límite de salida predeterminado de 32768 para este modelo. El ejemplo elige 64000 y un nivel de razonamiento medium para una primera prueba de programación. Son ajustes elegidos expresamente, no los valores predeterminados del modelo.
{
"$version": 4,
"modelProviders": {
"openai": [
{
"id": "qwen4-max-preview",
"name": "Qwen4-Max-Preview",
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"envKey": "TOKEN_PLAN_API_KEY",
"generationConfig": {
"samplingParams": {
"max_tokens": 64000,
"reasoning_effort": "medium"
},
"extra_body": {
"preserve_thinking": true
}
}
}
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"model": {
"name": "qwen4-max-preview"
}
}El campo envKey contiene el nombre de una variable de entorno, no la clave secreta. La referencia de proveedores de Qwen Code documenta este mecanismo de credenciales y los ajustes de generación.
Ejecuta qwen desde la terminal que contiene la clave exportada. Confirma el modelo con /model y repite la misma tarea de lectura.
¿Por qué puede max_tokens truncar la respuesta final?
En Qwen4-Max-Preview, Chat Completions cuenta el razonamiento y la respuesta dentro del mismo presupuesto de salida. Según el aviso de compatibilidad de la API, max_tokens equivale a max_completion_tokens para este modelo.
Este ejemplo ilustra el efecto sobre el presupuesto:
Combined output budget: 64,000 tokens
Assumed thinking usage: 48,000 tokens
Remaining answer allowance: at most 16,000 tokensEs un cálculo ilustrativo, no una ejecución medida. Un límite que antes se calculaba solo para la respuesta visible puede dejar ahora muy poco espacio para ella.
El razonamiento está activado de forma predeterminada. Los valores admitidos de reasoning_effort son low, medium y xhigh; el predeterminado es xhigh. No configures reasoning_effort y thinking_budget a la vez.
Empieza con medium para una prueba acotada. Prueba low para cambios sencillos, o xhigh cuando una tarea difícil justifique evaluar más razonamiento. Cambia un solo ajuste cada vez y compara el trabajo completado, no únicamente la longitud de la respuesta.
Los modelos Qwen anteriores conservan el comportamiento previo de max_tokens. No apliques retroactivamente la regla de esta versión preliminar a todas las integraciones con Qwen.
Conserva el historial de razonamiento en Chat Completions
Mantén el razonamiento histórico en el campo previsto para ello durante las conversaciones de varios turnos. Qwen4-Max-Preview activa preserve_thinking de forma predeterminada.
El razonamiento de los mensajes anteriores del asistente debe ir en reasoning_content. No lo añadas al campo content del asistente ni lo conviertas en un mensaje nuevo del usuario.
Esto corresponde al adaptador del cliente. No es una indicación de que debas pegar manualmente razonamiento oculto en el chat. Al evaluar una integración, comprueba un turno posterior y un ciclo completo de llamada a una herramienta, no solo la primera respuesta.
La comparación de Messages, Chat Completions y Responses explica por qué la compatibilidad HTTP no basta para confirmar que un agente funciona correctamente.
Busca la causa de cada fallo
Ante 401 InvalidApiKey: Invalid API-key provided., comprueba primero el plan de facturación de la clave, el estado de la suscripción y si copiaste la clave completa. Confirma que el endpoint corresponde a la clave, reinicia el cliente y repite la prueba de lectura.
Si aparece AccessDenied con HTTP 403 y código access_denied después de asignar los modelos, revisa Model Gallery en Model Studio. Alibaba documenta el estado Upcoming deprecation como una posible causa. Comprueba también los permisos y la disponibilidad en tu plan; no todos los 403 significan que un modelo se haya retirado.
Si la salida se trunca, revisa el presupuesto de salida efectivo y el nivel de razonamiento antes de cambiar la autenticación. Aplica el ajuste de Claude Code o Qwen Code mostrado antes y repite la misma tarea.
Si agotaste la cuota, utiliza las opciones de gestión de cuota de la suscripción. Aumentar max_tokens no repone Credits y puede elevar el consumo en la siguiente llamada correcta.
Migra a una ruta de pago independiente antes del cierre
Usa qwen3.8-max como alternativa de pago por uso para continuar después de la versión preliminar. Las instrucciones de configuración de pago por uso de Alibaba incluyen expresamente este modelo y describen la facturación por consumo. La página del modelo publica por separado los precios de la API.
La recomendación se refiere a la vía de acceso. No afirma que su calidad de programación sea equivalente a la de Qwen4-Max-Preview.
Crea una clave de API independiente de Model Studio en la región de Singapur siguiendo las instrucciones de claves de API. Después sustituye la clave, el endpoint, el modelo principal y las asignaciones de modelos auxiliares.
El siguiente ejemplo de Bash utiliza el endpoint compartido de Singapur documentado por Alibaba. La referencia de URL base también ofrece endpoints específicos de cada espacio de trabajo, recomendados para producción.
read -rs DASHSCOPE_API_KEY && export DASHSCOPE_API_KEY
unset ANTHROPIC_API_KEY
export ANTHROPIC_AUTH_TOKEN="$DASHSCOPE_API_KEY"
export ANTHROPIC_BASE_URL="https://dashscope-intl.aliyuncs.com/apps/anthropic"
export ANTHROPIC_MODEL="qwen3.8-max"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="qwen3.8-max"
export ANTHROPIC_DEFAULT_SONNET_MODEL="qwen3.8-max"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen3.8-max"
export CLAUDE_CODE_SUBAGENT_MODEL="qwen3.8-max"
claude --model qwen3.8-maxAquí se asigna deliberadamente el modelo sustituto a todas las opciones indicadas. Ajusta más adelante los modelos auxiliares, tras comprobar su disponibilidad y sus costes.
Inicia una conversación nueva, repite la tarea de lectura y verifica el consumo en la ruta de pago. Cambiar solo el modelo y conservar las credenciales de Token Plan no traslada la facturación a pago por uso.
Como alternativa de pago compatible con OpenAI, BetterToken incluye qwen3.8-max en su catálogo a fecha de 2026-11-12. Su URL base es https://www.bettertoken.ai/v1; usa tu propia clave de BetterToken y la integración documentada de OpenCode. Es un acceso de pago independiente a la API, no acceso a la versión preliminar de Qwen4. Consulta los precios actuales antes de cambiar.
