Qwen4-Max en Claude Code: configuración, precios y migración
Conecta qwen4-max a Claude Code mediante el endpoint de pago por uso de QwenCloud o el de Token Plan. Compara los cargos por tokens, la creación de caché y los resultados publicados de programación con Qwen3.8-Max y Opus 5.5. Sustituye el identificador preliminar antes de su retirada, distingue los límites de la API de los del cliente y comprueba una tarea real en tu repositorio.
Índice

Para probar Qwen4-Max en Claude Code sin una suscripción a Token Plan, usa la API de pago por uso de QwenCloud y selecciona qwen4-max explícitamente. Así, los desarrolladores que lo comparan con Qwen3.8-Max u Opus 5.5 pueden empezar con acceso directo y facturación por tokens. Si ya usas qwen4-max-preview, sustituye su identificador antes de que termine el periodo preliminar, el 25 de noviembre de 2026 a las 24:00 UTC+8.
La disponibilidad, los límites y los precios indicados corresponden al 17 de noviembre de 2026.
¿Qué cambia respecto a la versión preliminar?
El lanzamiento de producción del 16 de noviembre añade acceso de pago por uso, además de Token Plan. La versión preliminar solo estaba disponible mediante Token Plan. Para el modelo de producción, usa qwen4-max, no qwen4-max-preview.
Distingue los límites de la API de la configuración de Claude Code. Las especificaciones de producción indican un contexto de 1,000,000 tokens y un máximo de entrada de 983,616 tokens en modo de razonamiento. La salida admite 131,072 tokens sin razonamiento, o 262,144 tokens entre el razonamiento y la respuesta final.
Las especificaciones preliminares permitían 393,216 tokens compartidos entre el razonamiento y la respuesta. Por tanto, la API de producción tiene un límite combinado de salida menor, aunque QwenCloud recomienda aumentar el ajuste de salida de Claude Code.
El periodo preliminar termina al finalizar el 25 de noviembre, equivalente al 26 de noviembre a las 00:00 UTC+8. Su retirada está prevista para después. Sustituye las referencias explícitas al modelo preliminar en la configuración del shell y del cliente, reinícialo y comprueba el identificador de producción. No supongas que una actualización automática en otra aplicación migrará también la configuración de Claude Code.
¿Qué vía de acceso conviene elegir?
Elige pago por uso para medir el coste de una prueba con la API o integrarla en una aplicación. Elige Token Plan para programar de forma interactiva dentro de la cuota de la suscripción.
| Vía | Requisitos y facturación | Cuándo elegirla |
|---|---|---|
| QwenCloud pay-as-you-go | Cuenta de QwenCloud, clave de API y endpoint de la misma región, y facturación activada. Los tokens de entrada y salida se cobran por separado. | Medir el coste de Qwen4-Max directamente, usarlo en el backend de una aplicación o automatizar tareas. |
| QwenCloud Token Plan | Suscripción de QwenCloud mediante el servicio de Singapur, con clave y endpoint exclusivos de Token Plan. El uso consume Credits. | Trabajo interactivo en herramientas de programación compatibles, con una cuota mensual. |
| OpenRouter | Cuenta de OpenRouter con saldo y un cliente compatible; usa qwen/qwen4-max. La compra de créditos lleva una comisión. | Ya comparas proveedores mediante OpenRouter. |
| BetterToken, para modelos alternativos | Cuenta y clave de API propias, facturación por uso del modelo y configuración documentada de Claude Code. | Comparar otros modelos y vías disponibles; consulta los modelos y precios actuales. |
Token Plan Lite tiene un precio de lista estándar de $6/month y 20,000 Credits, no 20,000 tokens. Su política de uso excluye los scripts de automatización, los backends de aplicaciones y las llamadas por lotes no interactivas. Agotar el plan y los Credit Packs no cambia automáticamente las solicitudes a pago por uso.
Incluye las comisiones de recarga de OpenRouter al comparar el gasto total, no solo las tarifas por tokens. El acceso a la API de BetterToken es independiente de las suscripciones de los proveedores. Comprueba la activación de la cuenta y los métodos de pago disponibles antes de sustituir una vía que ya funciona.
El pago por uso en Singapur ofrece 1 millón de tokens gratuitos, separados de los Credits de Token Plan. Revisa las condiciones de elegibilidad y caducidad de la cuota gratuita; no des por hecho que sigue disponible en tu cuenta.
Configura Qwen4-Max en Claude Code
Necesitas Claude Code CLI instalado y una clave de pago por uso de QwenCloud creada en la región de Singapur. Selecciona la región en la consola, abre API Keys y crea una clave.
Comprueba primero si quedan ajustes antiguos del proveedor en ~/.claude/settings.json y en .claude/settings.json del proyecto. Después ejecuta lo siguiente en Bash. Cuando el primer comando espere la entrada, pega la clave y pulsa Enter. No se mostrará en pantalla ni se guardará en el historial del shell.
read -rs ANTHROPIC_AUTH_TOKEN && export ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_BASE_URL="https://ap-southeast-1.maas.qwencloudapi.com/apps/anthropic"
export ANTHROPIC_MODEL="qwen4-max"
export ANTHROPIC_DEFAULT_OPUS_MODEL="qwen4-max"
export CLAUDE_CODE_SUBAGENT_MODEL="qwen4-max"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="983616"
claude -p "Hello"
Esta configuración usa el endpoint compatible con Anthropic y las instrucciones específicas del modelo que documenta QwenCloud. Su ejemplo genérico de pago por uso todavía indica qwen3.7-max; los valores anteriores seleccionan expresamente Qwen4-Max de producción.
ANTHROPIC_MODEL selecciona el modelo principal. ANTHROPIC_DEFAULT_OPUS_MODEL asigna un modelo al alias Opus de Claude Code; configurar solo ese alias no equivale a seleccionar el modelo activo. Estas variables exportadas se aplican al terminal actual.
Una respuesta confirma la autenticación básica y el envío de solicitudes por esa vía. Después, ejecuta lo siguiente dentro de un repositorio que contenga README.md:
claude -p "Read README.md and report the project name and any documented test command. Do not edit files."
Compara la respuesta con el archivo. Un acceso correcto debe devolver datos concretos del repositorio sin modificar archivos. A continuación, prueba un cambio pequeño con una prueba existente. No consideres que responder a un saludo demuestra compatibilidad con las herramientas de programación.
Usar una suscripción existente a Token Plan
Conserva los ajustes de qwen4-max anteriores, pero sustituye tanto la credencial como el endpoint por los de Token Plan:
read -rs ANTHROPIC_AUTH_TOKEN && export ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_BASE_URL="https://token-plan.maas.qwencloudapi.com/apps/anthropic"
claude
Pega la clave exclusiva de Token Plan, no la de pago por uso. Haz la comprobación del repositorio de forma interactiva en Claude Code. Para automatizaciones sin intervención, usa pago por uso.
Respuestas largas truncadas y solicitudes fallidas
Si se cortan las respuestas largas, QwenCloud recomienda cambiar el ajuste 64000 de la versión preliminar por:
export CLAUDE_CODE_MAX_OUTPUT_TOKENS="131072"
Inicia una nueva sesión de Claude Code desde ese terminal. Este es el ajuste que recomienda QwenCloud, no una promesa de que el CLI devolverá 131,072 tokens. La documentación actual de Claude Code establece un máximo de 128000 tokens de salida para identificadores de modelo no reconocidos. Los ajustes superiores se reducen a ese máximo. Ninguno de esos valores habilita el límite combinado de 262,144 tokens de razonamiento y respuesta de la API. Divide un resultado grande en varias solicitudes cuando el límite del cliente sea el obstáculo restante.
Ante fallos de autenticación, comprueba el tipo de credencial y la región antes de renovar claves repetidamente. Las reglas regionales de QwenCloud exigen que la clave de API y el endpoint pertenezcan a la misma región.
Para errores de Token Plan, distingue 429 insufficient_quota de 429 Requests rate limit exceeded con la guía oficial de errores. Si agotaste la cuota, espera a que se restablezca o compra un Credit Pack. Si alcanzaste el límite de frecuencia, reduce la frecuencia de solicitudes o la concurrencia. Tras corregir la causa, vuelve a intentar una solicitud interactiva pequeña.
Si se repiten los errores de contexto, conserva el ajuste explícito 983616. Revisa cómo gestiona Claude Code la ventana de contexto con gateways antes de aumentar los límites.
Calcula los cargos por tokens antes de comparar el coste de las tareas
Usa las tarifas de Singapur para esta configuración. No combines el precio de otra región con el endpoint de Singapur.
La siguiente estimación asigna a cada modelo los mismos 100,000 tokens de entrada sin caché y 10,000 tokens de salida facturados, incluido el razonamiento. Solo calcula los cargos por tokens del modelo. No incluye caché, herramientas alojadas de pago, comisiones de recarga ni impuestos.
| Modelo y acceso directo | Entrada por 1M tokens | Salida por 1M tokens | Cargo estimado por tokens del modelo |
|---|---|---|---|
| Qwen4-Max, Singapur | $1.50 | $4.50 | $0.195 |
| Qwen3.8-Max, Singapur | $2.00 | $6.00 | $0.260 |
| Claude Opus 5.5, API estándar | $4.00 | $20.00 | $0.600 |
Para Qwen4-Max, el cálculo es 0.1 × $1.50 + 0.01 × $4.50 = $0.195. Son cargos hipotéticos, no costes observados al completar una misma tarea de programación. Cada modelo puede consumir cantidades distintas de tokens en razonamiento, contexto y reintentos. QwenCloud documenta los valores predeterminados reasoning_effort=high y thinking_budget=131072; ese presupuesto es un máximo, no el uso facturado.
Incluye la creación de caché, no solo las lecturas
Leer la caché de Qwen4-Max en Singapur cuesta $0.075 por 1M tokens, tanto para aciertos de caché implícita como explícita. Crear caché explícita cuesta $1.875 por 1M tokens con una duración de 5 minutos, o $3.00 con una duración de 1 hora.
Con las cantidades de tokens expresadas en millones, calcula:
cost_USD = 1.50U + 0.075R + 1.875W5 + 3.00W60 + 4.50O
U representa la entrada sin caché y R, la entrada leída de caché. W5 y W60 son las escrituras de caché para cada duración. Cuenta cada token de entrada en una sola categoría. O incluye el razonamiento y la respuesta final.
Para un ejemplo completo, supón dos solicitudes con un prefijo estable de 100,000 tokens, 5,000 tokens de entrada nuevos y 2,000 de salida cada una. La primera escribe el prefijo en caché; la segunda obtiene un acierto en esa caché de 5 minutos.
El cargo total estimado es 0.010 × $1.50 + 0.100 × $0.075 + 0.100 × $1.875 + 0.004 × $4.50 = $0.228. Sin caché, los mismos volúmenes cuestan 0.210 × $1.50 + 0.004 × $4.50 = $0.333.
El ejemplo presupone un acierto de caché. Comprueba las lecturas y escrituras reales mediante los campos de uso de caché del proveedor. En sesiones de programación repetidas, revisa también el consumo adicional de tokens de los agentes en segundo plano de Claude Code. No atribuyas todos los cargos a la respuesta principal.
¿Es mejor opción que Opus 5.5 para programar?
Empieza con Qwen4-Max para una tarea acotada en el repositorio donde importe el coste. Conserva Opus 5.5 como referencia en tareas difíciles de terminal hasta que tus pruebas de aceptación justifiquen cambiar.
A fecha de 17 de noviembre, la clasificación de Vals AI Terminal-Bench 4.0 muestra:
| Modelo publicado en la tabla | Puntuación con Mini-SWE-agent | Coste por prueba |
|---|---|---|
| Qwen 4 Max | 48.48% | $3.90 |
| Qwen 3.8 Max 0902 | 38.89% | $12.15 |
| Claude Opus 5.5 | 65.15% | $12.04 |
Esto respalda una conclusión más limitada que «sustituto de Opus». Qwen4-Max supera la versión de Qwen3.8-Max identificada por fecha en la tabla, pero queda por detrás de Opus en estas tareas de terminal. El coste por prueba no equivale al coste de un parche aceptado correctamente.
Son ejecuciones de agentes publicadas, no pruebas de Claude Code con el mismo esfuerzo de razonamiento. Vals evaluó Qwen4-Max en xhigh; su página de Opus indica max. El informe de lanzamiento de Opus también declaró el uso de modelos de respaldo. Por eso, no debes tratar la tabla actual como una comparación controlada y sin recurrir a otros modelos. Revisa cómo afectan el esfuerzo y los modelos de respaldo a las comparaciones de agentes de programación antes de extrapolar la diferencia.
Limita la primera prueba a 30 minutos. Elige una tarea pequeña con una prueba de aceptación conocida, conserva el mismo estado del repositorio y las mismas instrucciones, y registra todos los cargos, incluidos los reintentos. Adopta Qwen4-Max para ese tipo de tareas cuando cumpla los mismos criterios de aceptación a un coste total aceptable. Mantén Opus donde los reintentos o las correcciones adicionales eliminen la ventaja de precio por token.