Cuando Claude Code muestra «límite alcanzado», empiece por identificar el límite: suscripción, velocidad de la API, tope de gasto o problema de la cuenta. La solución adecuada puede ser esperar un restablecimiento, activar créditos oficiales, reducir las llamadas simultáneas o corregir una clave. Comprar otro plan antes de este diagnóstico puede dejar intacto el problema.
¿Qué mensaje ve?
| Síntoma | Comprobación | Acción adecuada |
|---|---|---|
| Cuota del plan alcanzada, con hora de reanudación visible | Cuenta de Claude y página de uso | Esperar, comparar otro plan o los créditos de uso |
| API 429 con indicación de velocidad | Mensaje, solicitudes simultáneas y encabezado de reanudación | Reducir la velocidad y respetar el plazo indicado |
| Tope de gasto o pago rechazado | Saldo, límites de la cuenta y facturación | Corregir el límite o el pago correspondiente |
| API 401 o 403 | Clave, dominio de destino y permisos | Corregir la identificación o la autorización |
| Conversación demasiado larga | Tamaño del contexto y mensaje exacto | Resumir el trabajo y reducir el contexto útil |
Los códigos siguientes describen la API de Anthropic. Si Claude Code pasa por otro proveedor, consulte también su documentación: un intermediario puede mostrar sus propios mensajes y límites.
1. Si utiliza una suscripción de Claude
Abra la configuración de uso de la cuenta conectada. Anote la cuota correspondiente y la hora indicada, en lugar de deducir una duración universal a partir de un mensaje encontrado en otro lugar. Compruebe también que Claude Code utiliza la cuenta esperada.
Anthropic distingue entre los límites de uso y de longitud. El uso de Claude y Claude Code puede compartir la misma asignación de la cuenta. Por tanto, abrir una ventana nueva o una conversación nueva no crea una cuota adicional. En cambio, aligerar un contexto que se ha vuelto voluminoso puede reducir el trabajo solicitado al modelo en las llamadas siguientes.
Para continuar después de agotar la asignación incluida, los planes personales elegibles disponen de créditos de uso oficiales. Se facturan por separado, a las tarifas estándar de la API. En la configuración de uso, compruebe que estén activados, los fondos disponibles y el tope de gasto. Es una opción que debe comparar con esperar, cambiar de plan o utilizar una cuenta de API independiente.
2. Si la API devuelve 429
Consulte el texto del error y los límites de la API. Para un límite de velocidad, reduzca las tareas simultáneas y respete el plazo retry-after cuando esté presente. Reintentar de inmediato con varios agentes puede mantener el mismo bloqueo.
Un 429 también puede corresponder al límite mensual del nivel de API o a determinados límites de gasto del espacio de Claude Code. Un límite mensual puede no proporcionar un plazo de reanudación. En ese caso, compruebe la facturación y el tope asociado a la cuenta; un bucle de intentos no los aumenta. La ausencia de un encabezado, por sí sola, no basta para concluir: lea también el mensaje.
3. Si el problema afecta al saldo o a la autenticación
La referencia de errores de Anthropic distingue, entre otros, 401 para la autenticación, 403 para los permisos y 402 para la facturación. Algunos límites de gasto también pueden aparecer con el código 400. Por tanto, el código HTTP por sí solo no sustituye los detalles del error.
Compruebe el dominio al que se envía la solicitud y la cuenta que creó la clave. Una suscripción de Claude, un saldo de Console y un saldo de un proveedor externo no son intercambiables. Una recarga en un proveedor no financia automáticamente a los demás. Después de corregirlo, utilice una solicitud pequeña para confirmar qué cuenta se cobra antes de reanudar una tarea importante.
4. Continuar con una facturación de API independiente
La documentación de las pasarelas especifica que un identificador de pasarela activo sustituye la identidad de la suscripción durante la sesión. Definir únicamente la dirección base no realiza este cambio: la conexión registrada puede seguir activa. Configure conjuntamente la dirección, el identificador y el modelo esperados.
La guía de precios y configuración de Claude Code explica cómo usar Kunavo en francés. El catálogo muestra actualmente Claude Sonnet 4.6 a $2.10 de entrada y $10.50 de salida por millón de tokens. La guía de precios de la API de Claude detalla las unidades que se deben comparar. Una tarea puede contener varias llamadas; su coste también depende del contexto, la caché y los reintentos.
Si esta separación le conviene, cree su cuenta de Kunavo, configure una clave y después controle la primera llamada en su historial de uso. Esta cuenta tiene sus propias restricciones; no convierte Claude Code en un servicio ilimitado.
Prepare una solicitud de ayuda útil
Si el bloqueo persiste, conserve la siguiente información. Permite distinguir un problema de configuración de un límite aplicado a la cuenta correcta sin publicar su clave secreta:
Interface et version de Claude Code :
Compte utilisé : abonnement / Console / fournisseur tiers
Modèle et nom de domaine de l'API :
Message exact et code HTTP éventuel :
Heure de réinitialisation affichée :
En-tête retry-after, s'il existe :
Identifiant de requête, s'il existe :Conserve también su trabajo local y el estado de la tarea. Después de restablecer el acceso, pida al agente que compruebe los archivos ya modificados antes de empezar de nuevo, para evitar repetir pasos completados o perder el contexto de la corrección.
Preguntas frecuentes
¿Qué hacer cuando Claude Code muestra «límite alcanzado»?
Identifique primero la cuenta que proporciona las respuestas. En el caso de una suscripción, consulte la hora de restablecimiento y las opciones de créditos de uso. En el caso de una API, lea el mensaje completo: el límite de velocidad, el tope de gasto, la facturación y la autenticación requieren correcciones distintas.
¿Un código 429 significa siempre que hay que esperar?
No. La API de Claude también utiliza 429 para ciertos topes de gasto. Un exceso del límite de velocidad puede requerir esperar y reducir las solicitudes simultáneas; un tope financiero exige comprobar los límites y la facturación de la cuenta. El mensaje y los encabezados permiten elegir la rama correcta.
¿Una conversación nueva restablece mi cuota a cero?
No. Una conversación nueva puede reducir el contexto transmitido, pero no restablece la asignación de la cuenta. El límite de longitud de una conversación y el límite de uso de su suscripción son dos restricciones distintas.
¿Una clave de Kunavo elimina todos los límites?
No. Una configuración de API con una clave de Kunavo utiliza una cuenta y una facturación separadas de la suscripción de Claude. Sigue sujeta al saldo, los límites y los modelos disponibles en Kunavo. Cambiar únicamente la dirección base sin configurar el identificador correcto no basta para cambiar la facturación.
Fuentes oficiales comprobadas el 17 de septiembre de 2026.