Claude Rate Exceeded: qué límite has alcanzado y cómo resolverlo

Para resolver un error «Rate Exceeded» de Claude, primero identifica dónde aparece y qué dice el mensaje completo. En la aplicación, empieza por el aviso de uso y su hora de restablecimiento. En Claude Code, comprueba la cuenta utilizada. Si trabajas con la API, conserva el cuerpo de la respuesta: un HTTP 429 también puede indicar que has alcanzado un tope mensual de gasto, según la documentación oficial de límites de la API.

Esta primera comprobación te permite elegir una acción útil:

Si utilizas la aplicación de Claude, lee el aviso antes de abrir otro chat

Claude distingue entre límite de uso, conversación demasiado larga y restricciones de capacidad. Un bloqueo por uso indica cuándo podrás volver a utilizarlo; un aviso de longitud exige reducir la conversación o la entrada; uno de capacidad puede deberse a la carga del servicio. La ayuda oficial sobre mensajes de error explica estas diferencias.

Si el aviso dice que has agotado el uso, sigue estos pasos:

1. Anota la hora de restablecimiento que muestra Claude.
2. Abre Configuración → Uso. En los planes de pago compatibles puedes consultar el progreso de la sesión de cinco horas, el uso semanal y sus restablecimientos. Las modalidades Enterprise por consumo tienen particularidades; la guía oficial de uso detalla qué muestra esta sección.
3. Comprueba si el aviso corresponde a la sesión o a otro límite del plan. Recuperar una de las cuotas no implica que todas vuelvan a estar disponibles.
4. Espera al restablecimiento indicado o revisa las opciones de uso adicional que tu cuenta ofrezca, teniendo en cuenta su coste.

Abrir otro chat no restablece el uso consumido. Claude en la web, Claude Desktop y Claude Code comparten el uso cuando accedes mediante la misma suscripción. Los créditos de uso, cuando están disponibles, son una opción de pago; no equivalen a un reinicio gratuito. Consulta la explicación de los límites de uso y duración.

Un chat nuevo sí tiene sentido cuando el problema es la longitud de la conversación. Prepara un resumen con las decisiones y los datos necesarios, inicia una conversación nueva y añade solo los archivos relevantes. Esto reduce la entrada que Claude debe procesar; si además has agotado la cuota de uso, tendrás que resolver también ese bloqueo.

Si el mensaje habla de capacidad, consulta Claude Status y vuelve a intentarlo más tarde. Un estado sin incidencias no descarta una restricción puntual: la ayuda sobre estos errores advierte de que estos avisos no siempre aparecen en la página de estado. No existe una espera fija que sirva para todos los mensajes de capacidad.

En Claude Code, comprueba con qué cuenta estás trabajando

Antes de cambiar de plan o comprar créditos, ejecuta estos comandos dentro de Claude Code:

text
/status
/usage

/status muestra información de la cuenta, el modelo y la configuración. /usage permite consultar uso, costes y límites según la sesión. Su disponibilidad y contenido se describen en la referencia oficial de comandos.

La decisión depende de cómo hayas iniciado sesión:

• Con una suscripción de Claude: revisa el aviso de restablecimiento y el uso del plan. La actividad en la aplicación también puede haber consumido esa cuota compartida.
• Con una clave API: revisa los límites de la organización y del espacio de trabajo al que pertenece la clave. La cuota que ves en tu suscripción de Claude no explica por sí sola el rechazo de esa llamada.
• Mediante otro proveedor: consulta sus registros y límites. Las reglas de la API directa de Claude no bastan para diagnosticar todos los servicios que ofrecen acceso al modelo.

Por ejemplo, si Claude funciona en el navegador pero Code muestra un error, no concluyas que el aviso es incorrecto: comprueba primero si Code utiliza una clave API y el navegador una suscripción. Son dos formas distintas de acceso. Puedes ampliar esta comprobación en la guía sobre claves API y facturación por suscripción en Claude Code.

Si ya has identificado la cuenta y necesitas continuar con el diagnóstico del terminal, sigue la guía de recuperación ante límites de Claude Code.

En la API, un 429 no siempre se resuelve esperando unos segundos

Para una llamada directa a la API de Claude, guarda el código HTTP, el cuerpo del error y las cabeceras de respuesta. La documentación distingue restricciones de ritmo, topes mensuales obligatorios y presupuestos configurados por el usuario. Estos últimos suelen devolver HTTP 400, pero el espacio de trabajo dedicado a Claude Code puede devolver 429 con retry-after. Por eso, ni el estado HTTP ni esa cabecera bastan para clasificar el problema. Las reglas y excepciones están en la documentación de límites de la API.

Demasiadas solicitudes o tokens en poco tiempo

La API limita las solicitudes por minuto, los tokens de entrada por minuto y los tokens de salida por minuto. Los límites de la organización y del espacio de trabajo se aplican a la vez. También puede haber rechazos cuando el tráfico aumenta bruscamente, aunque la carga anterior funcionase. La referencia de límites y cabeceras recoge cómo se contabilizan estos recursos.

Si el error corresponde a estas restricciones temporales:

1. Respeta retry-after, cuando aparezca: expresa en segundos cuánto debes esperar antes de reintentar.
2. Reduce el ritmo de envío. Si varios procesos reintentan a la vez, distribuye sus reintentos para evitar otra ráfaga.
3. Revisa las cabeceras de límite, capacidad restante y restablecimiento de solicitudes, tokens de entrada y tokens de salida. Sus nombres empiezan por anthropic-ratelimit-; los tiempos de restablecimiento usan el formato RFC 3339.
4. Vuelve a probar con una solicitud adecuada a la capacidad disponible y aumenta la carga gradualmente.

La capacidad se repone de forma continua: esperar hasta el siguiente minuto del reloj no garantiza que la petición quepa. Además, reducir el número de procesos simultáneos no controla por sí solo las solicitudes por minuto; pocos procesos también pueden enviar muchas llamadas rápidas.

El ajuste debe corresponder al recurso agotado. Un contexto extenso aumenta la entrada; una respuesta extensa aumenta la salida. Bajar max_tokens solo alivia el consumo de salida si termina produciendo menos tokens: ese parámetro no reserva por sí mismo capacidad de salida por minuto. Para configurar colas y reintentos con más detalle, consulta la guía de límites de solicitudes de la API de Claude.

Tope mensual obligatorio de gasto

Hay un caso en el que reducir el ritmo no permite continuar: alcanzar el tope mensual obligatorio correspondiente al nivel de uso de la organización. La señal específica es esta combinación, recogida en la documentación del límite mensual de gasto:

• HTTP 429.
• error.type igual a rate_limit_error.
• error.details.error_code igual a enforced_spend_limit_reached.
• Ausencia de retry-after en esta respuesta.

Este fragmento JSON es ilustrativo: muestra únicamente los campos que debes reconocer, no una respuesta obtenida en una prueba ni el cuerpo completo del error.

json
{
  "error": {
    "type": "rate_limit_error",
    "details": {
      "error_code": "enforced_spend_limit_reached"
    }
  }
}

El bloqueo se mantiene hasta las 00:00 UTC del primer día del mes siguiente, o hasta que se apruebe un aumento del límite. Revisa los límites de tu organización y la facturación de la API. Tener saldo o recargarlo no garantiza que se eleve ese tope.

La ausencia de retry-after, por sí sola, no demuestra que hayas agotado el gasto mensual. Busca el código específico del error y contrástalo con la organización afectada antes de detener o modificar tu aplicación.

Presupuesto que has configurado tú o tu equipo

Un presupuesto propio de organización o espacio de trabajo es una restricción diferente del tope mensual obligatorio del nivel. Normalmente devuelve HTTP 400, con invalid_request_error, y un mensaje que empieza por una de estas cadenas:

text
You have reached your specified API usage limits
You have reached your specified workspace API usage limits

La excepción documentada para el espacio de trabajo dedicado a Claude Code es que puede responder con 429 y retry-after. Esa cabecera no convierte el problema en un simple exceso momentáneo de solicitudes.

Comprueba el texto del error, el presupuesto configurado y el espacio de trabajo afectado. La cabecera anthropic-workspace-id, cuando esté presente, ayuda a identificar el espacio de trabajo resuelto por la API. Si necesitas cambiar el presupuesto, corresponde a la persona responsable del gasto decidirlo; un bucle de reintentos no modifica ese ajuste.

Qué guardar si el bloqueo no encaja con los límites visibles

Si el aviso persiste después del restablecimiento indicado, o no coincide con los datos de uso, reúne la información necesaria para que soporte pueda localizarlo:

• En la aplicación: mensaje completo, fecha y hora con zona horaria, plan y hora de restablecimiento que muestra la cuenta.
• En Claude Code: información pertinente de /status, datos de /usage y forma de acceso utilizada.
• En la API: código HTTP, cuerpo del error, identificador de solicitud, modelo, cabeceras de límites y espacio de trabajo afectado.

No compartas claves API, cabeceras Authorization o x-api-key, ni contenido privado de las conversaciones. Si el fallo llega a través de otra aplicación o proveedor, conserva también su identificador de solicitud: puede ser necesario para localizar la llamada original.

Hasta identificar la causa, evita cambiar simultáneamente de cuenta, modelo y proveedor. Con el mensaje completo y el consumo correspondiente podrás distinguir si necesitas esperar, reducir la carga o revisar un presupuesto, y comprobar después si esa acción ha resuelto el bloqueo.