¿Se agotó el uso de Qwen Code? Identifica la cuota y sigue trabajando
Qwen Code no tiene una cuota universal. Esta guía explica cómo identificar la autenticación activa, comprobar el límite correspondiente y elegir una forma compatible de continuar sin confundir Coding Plan, Token Plan, API estándar y proveedores externos.
Índice

Cuando Qwen Code indica que el uso se agotó, no esperes un supuesto reinicio universal ni busques el precio de la API de Qwen3.8 Max. Qwen Code es el cliente; la cuota y la facturación pertenecen al método de autenticación y al proveedor que atiende la solicitud.
Ejecuta /doctor dentro de Qwen Code, identifica el proveedor y revisa el nombre de la variable de credenciales, el baseUrl, el modelo y la región sin mostrar la clave. Después podrás saber si usas el antiguo Qwen OAuth, Alibaba Cloud Coding Plan, Token Plan, una API Key estándar o un proveedor externo/personalizado. qwen auth status ya no es el flujo actual: la documentación remite a /doctor para revisar la autenticación y a /auth para cambiarla.
Qué cuota se ha agotado realmente
| Fuente | Señal habitual | Qué significa el límite | Cómo continuar |
|---|---|---|---|
| Qwen OAuth | Credenciales antiguas de inicio en navegador | El nivel gratuito se retiró; no hay un reinicio pendiente | Usa /auth y elige una opción vigente |
| Coding Plan | Clave específica y endpoint coding...dashscope.aliyuncs.com | Uno de los topes del plan o una limitación técnica adicional | Espera el restablecimiento correcto o cambia de autenticación con facturación separada |
| Token Plan | Clave propia y endpoint token-plan...maas.aliyuncs.com | Credits de la edición, asiento o paquete activo | Espera el ciclo, añade cuota permitida o cambia de autenticación |
| API Key estándar | Endpoint regional normal de Model Studio | Saldo, cuota gratuita del modelo, facturación por tokens o rate limit | Activa/financia la cuenta, espera el límite o cambia de proveedor |
| Proveedor externo/custom | baseUrl, protocolo y modelo del proveedor | Su saldo, suscripción o límites | Revisa su panel o cámbialo con /auth |
El nombre del modelo no identifica la cuota. El mismo modelo puede estar disponible por rutas comerciales distintas.
Diagnóstico seguro en cinco minutos
1. Conserva el error exacto
Anota el texto, la hora, el modelo y si falló al comenzar o durante una tarea larga. No incluyas la API Key en capturas. Un mensaje explícito de cuota es más fiable que un 401, 403, 429, timeout o model not found genérico.
2. Ejecuta /doctor
La guía oficial indica /doctor para revisar la autenticación actual. Registra el tipo, proveedor y clase de endpoint. Si todavía aparece Qwen OAuth, no existe una cuota gratuita que vaya a restablecerse.
Usa /auth para cambiar la fuente. /model elige un modelo ya configurado, pero no garantiza un cambio de cuenta, plan o facturación.
3. Revisa los dos niveles de configuración
Comprueba ~/.qwen/settings.json y .qwen/settings.json dentro del proyecto. La configuración del proyecto puede prevalecer sobre la del usuario; las variables de entorno y los argumentos de inicio tienen todavía más prioridad. Una variable antigua puede mantener el proveedor anterior aunque hayas editado el JSON.
Revisa únicamente datos no secretos: protocolo, nombre de la variable, baseUrl, ID del modelo y región del plan. No imprimas la clave. Si está escrita en settings.json, muévela a una fuente protegida cuando sea posible.
4. Relaciona el endpoint con el plan
El Coding Plan internacional usa un endpoint que contiene coding-intl.dashscope.aliyuncs.com. El Token Plan internacional usa token-plan.ap-southeast-1.maas.aliyuncs.com. El servicio estándar pay-as-you-go utiliza endpoints regionales distintos.
La clave del Coding Plan y una clave general de Model Studio no son intercambiables. Una pareja equivocada puede causar un error de autenticación; una clave general con su endpoint pay-as-you-go puede generar cargos separados en lugar de consumir la cuota del plan.
5. Abre el panel correcto
Entra en la cuenta, región y plan identificados. Comprueba uso restante, límite alcanzado, hora de reinicio, suscripción, facturación y avisos de servicio o throttling.
Si utilizas Coding Plan
A 1 de octubre de 2026, la página internacional oficial muestra el plan Pro por USD 50 al mes y tres topes simultáneos:
- 6.000 solicitudes por cinco horas;
- 45.000 por semana;
- 90.000 por mes.
Se detienen las llamadas cuando se alcanza el primero. Una instrucción del usuario puede generar varias llamadas al modelo, por lo que una tarea agente compleja consume más que una pregunta corta.
Los reinicios son distintos: la cuota de cinco horas es móvil; la semanal vuelve cada lunes a las 00:00 (UTC+08:00); la mensual vuelve en la fecha de renovación a las 00:00 (UTC+08:00). Esperar cinco horas no soluciona un tope semanal o mensual. Confirma cuál aparece en el panel. Otras regiones pueden mostrar precio, moneda o disponibilidad diferentes.
Para seguir antes del reinicio, cambia con /auth a una API Key estándar, Token Plan u otro proveedor. Será una ruta de cuota y facturación separada. Mantén siempre junta la clave con su endpoint correcto.
Coding Plan está destinado al uso interactivo en herramientas compatibles; la página oficial prohíbe usar su clave en scripts automatizados o backends.
Si utilizas Token Plan
Token Plan no comparte el contador de Coding Plan. La documentación internacional actual lo describe mediante Credits, con ediciones y asignaciones que pueden variar. El consumo depende del modelo, tokens, modo de razonamiento y llamadas a herramientas.
En Team Edition, primero se consumen los Credits del asiento y luego un paquete compartido disponible. Cuando se agotan todos, el servicio se suspende hasta el siguiente ciclo o hasta añadir un paquete permitido. El panel muestra uso, reinicio, asientos y paquetes.
Confirma edición, región, Credits y endpoint dedicado. No apliques los reinicios de Coding Plan. Si deseas otra fuente de facturación, cámbiala explícitamente con /auth.
Si utilizas una API Key estándar
La API estándar de Model Studio es pay-as-you-go. El límite práctico depende del saldo y estado de facturación, cuotas gratuitas específicas del modelo y región, rate limits y controles de capacidad. No existe un reinicio semanal universal de Qwen Code.
Revisa uso y facturación en la cuenta y región correctas. Si terminó la cuota gratuita o falta saldo, activa o financia la facturación según las reglas actuales. Si solo es un rate limit, espera la ventana indicada.
Un 401 o 403 suele exigir primero revisar clave, permisos, región y endpoint. Un 429 puede ser cuota, rate limit o throttling temporal. Lee el cuerpo de la respuesta y el panel antes de clasificarlo.
Si utilizas un proveedor externo
La cuota comercial la define ese proveedor. Comprueba saldo, suscripción, acceso al modelo, límites por minuto o concurrencia, fecha de renovación y los valores exactos de endpoint y modelo. Cambiar de modelo dentro del mismo proveedor puede seguir gastando el mismo saldo; cambiar con /auth sí modifica la ruta de facturación.
¿Cuota o error de configuración?
- Mensaje explícito de Qwen OAuth retirado: cambia de autenticación.
- Tope del plan confirmado por el panel: sigue su regla de recuperación.
401/403: revisa clave, permisos, endpoint y región.model not found: revisa modelos compatibles; no demuestra falta de cuota.429, cola o interrupción breve: revisa rate limit,Retry-After, estado y panel.- Timeout o red: comprueba conectividad y estado del proveedor.
Cómo comprobar que ya funciona
- Reinicia Qwen Code para recargar variables.
- Ejecuta
/doctory confirma la autenticación prevista. - Usa
/modely selecciona un modelo compatible. - Envía una petición pequeña y de solo lectura, por ejemplo resumir un archivo sin modificarlo.
- Verifica el éxito y, si existe, el registro de uso en el panel correcto.
- Después reanuda la tarea larga.
Una prueba pequeña confirma autenticación, endpoint y modelo, pero no garantiza que el saldo restante alcance para una tarea grande.
Errores comunes
- Esperar cinco horas tras alcanzar el límite semanal o mensual.
- Creer que reiniciar repone la cuota.
- Cambiar solo la clave o solo el endpoint.
- Ignorar la configuración del proyecto o variables que prevalecen.
- Usar
/modelcomo si cambiara la facturación. - Confundir el precio por token de Qwen3.8 Max con el límite de Qwen Code.
- Crear otra clave en la misma cuenta sin saldo.
- Usar una clave Coding Plan en automatización.
Preguntas frecuentes
¿Sigue existiendo una cuota gratuita universal?
No. El nivel gratuito de Qwen OAuth terminó el 15 de abril de 2026. Un proveedor puede ofrecer créditos propios, ligados a una cuenta, modelo y región concretos.
¿Reiniciar recupera el uso?
No. Solo recarga la configuración; la cuota la repone el proveedor.
¿Cambiar de modelo evita el límite?
Solo si el nuevo modelo utiliza una asignación realmente independiente. Muchos modelos del mismo plan comparten cuota o Credits.
¿Necesito una clave nueva?
Solo si la actual es inválida, revocada o expuesta. Otra clave de la misma cuenta agotada normalmente no crea cuota.