# Claude Rate Exceeded: qué límite has alcanzado y cómo resolverlo > Claude API Error: Rate limit reached puede ser el uso del plan, el ritmo de la API, un tope de gasto o la cuota de Bedrock, Google Cloud o un gateway. - URL: https://blog.laozhang.ai/es/posts/claude-rate-exceeded-error - Published: 2026-05-09 - Updated: 2026-10-05 - Author: LaoZhang AI Team (https://blog.laozhang.ai/es/about) - Topic: Claude y Anthropic - Tags: Claude, Límites de uso, Claude Code, API de Claude --- **Ante `Claude API Error: Rate limit reached` o un error «Rate Exceeded» de Claude, no reintentes a ciegas: primero identifica qué límite ha saltado y quién lo controla.** Puede ser el uso de tu plan, el ritmo de solicitudes de la API, un tope de gasto o la cuota de Amazon Bedrock, Google Cloud o un gateway. En la aplicación, empieza por el aviso de uso y su hora de restablecimiento. 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](https://platform.claude.com/docs/es/api/rate-limits). Ese «Rate limit reached» genérico procede de versiones anteriores de Claude Code. La [referencia de errores actual de Claude Code](https://code.claude.com/docs/es/errors) ya no lo recoge: cada causa tiene ahora su propio mensaje. Además, aquel aviso no siempre significaba una cuota agotada. Según el [registro de cambios de Claude Code](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md), también aparecía ante un problema de derechos del plan, por ejemplo al elegir un modelo con contexto de 1M que tu suscripción no incluía; las versiones 2.1.78 y 2.1.89 corrigieron esos casos. Actualiza Claude Code, repite la acción y clasifica el mensaje completo que obtengas: - **`You've hit your session limit`** (o `weekly`, `Opus` o `Sonnet` limit), con hora de restablecimiento: límite de tu suscripción. Consulta `/usage`. Los límites de sesión y semanal son comunes a todos los modelos; cambiar de modelo con `/model` solo sirve si el aviso es de Opus o de Sonnet. - **`Usage credits required for 1M context`:** no es una cuota agotada, sino un modelo de 1M que tu plan no cubre. Elige con `/model` la variante sin `[1m]`, o activa los créditos de uso si el mensaje te remite a `/usage-credits`. - **`Server is temporarily limiting requests (not your usage limit)`:** limitación breve del servicio, ajena a tu plan. Espera un poco; desde la versión 2.1.199, Claude Code la reintenta automáticamente antes de mostrarla. - **`Request rejected (429)`:** límite de tu clave API, de tu proyecto de Amazon Bedrock o de tu proyecto de Google Cloud. La frase final del mensaje indica qué proveedor o gateway lo ha rechazado. - **`You've hit your monthly spend limit`:** tus créditos de uso han llegado a su tope. Súbelo en la configuración de uso, pídeselo a tu administrador o espera al restablecimiento que indique el mensaje. - **`spend limit reached`**, en minúsculas: tope de gasto que ha fijado el operador del gateway de tu organización. Claude Code no lo reintenta, porque no se levanta hasta el siguiente periodo o hasta que el operador lo amplíe. Si el mensaje no encaja con ninguno de estos, o el bloqueo aparece fuera de Claude Code, parte del lugar donde lo ves: | Dónde aparece el bloqueo | Qué debes comprobar | Primera acción | | --- | --- | --- | | Claude en la web, el ordenador o el móvil | Texto del aviso y hora de restablecimiento | Consulta el uso de tu plan | | Claude Code | Mensaje completo, cuenta y forma de acceso | Ejecuta `/status` y `/usage` | | Una llamada a la API directa | Código HTTP, cuerpo del error y cabeceras | Distingue el límite de solicitudes del límite de gasto | | Claude a través de Bedrock, Google Cloud o un gateway | Mensaje original, región y registros del proveedor | Revisa la cuota de ese proveedor, no la de Anthropic | ## 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](https://support.claude.com/es/articles/12466728-solucionar-mensajes-de-error-de-claude) 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](https://support.claude.com/es/articles/9797557-mejores-practicas-de-limites-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](https://support.claude.com/es/articles/11647753-como-funcionan-los-limites-de-uso-y-duracion). 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](https://status.claude.com/) y vuelve a intentarlo más tarde. Un estado sin incidencias no descarta una restricción puntual: la [ayuda sobre estos errores](https://support.claude.com/es/articles/12466728-solucionar-mensajes-de-error-de-claude) 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. ![Diferencias entre uso agotado, conversación demasiado larga y capacidad del servicio en Claude](https://blog.laozhang.ai/posts/es/claude-rate-exceeded-error/img/avisos-aplicacion.webp) ## 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](https://code.claude.com/docs/es/commands). 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 Amazon Bedrock, Google Cloud o un gateway:** consulta los registros y la cuota de ese proveedor. Las reglas de la API directa de Claude no bastan para diagnosticarlo; las señales de cada caso están en la sección sobre Bedrock, Vertex AI y gateways, más abajo. 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](https://blog.laozhang.ai/es/posts/claude-code-api-key-vs-subscription-billing). 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](https://blog.laozhang.ai/es/posts/claude-code-rate-limit-reached). ## 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](https://platform.claude.com/docs/es/api/rate-limits). ### 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](https://platform.claude.com/docs/es/api/rate-limits) 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. En Amazon Bedrock ocurre lo contrario, como verás más abajo. Y si lo que recibes es un 529 de sobrecarga y no un 429, la estrategia cambia: consulta cómo [configurar reintentos ante el error 529 de Claude API](https://blog.laozhang.ai/es/posts/claude-api-error-529-overloaded). ### 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](https://platform.claude.com/docs/es/api/rate-limits): - 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](https://platform.claude.com/settings/limits) y la [facturación de la API](https://platform.claude.com/settings/billing). 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](https://platform.claude.com/docs/es/api/rate-limits) 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. ![Cómo distinguir el ritmo de solicitudes, el tope mensual de gasto y un presupuesto configurado en la API](https://blog.laozhang.ai/posts/es/claude-rate-exceeded-error/img/limites-api-gasto.webp) ## Claude en Bedrock, Vertex AI o un gateway: el límite es del proveedor Si usas Claude a través de Amazon Bedrock, Google Cloud o un gateway (una pasarela o proxy intermedio entre tu herramienta y el proveedor), el 429 lo emite ese servicio: responde a la cuota de tu cuenta, proyecto o región, o a los límites que ha fijado el operador del gateway. El aumento se pide a AWS, al soporte de Google Cloud o a ese operador, no a Anthropic. Por eso conviene confirmar la ruta antes de tocar nada. En Claude Code, dos señales te dicen quién ha rechazado la solicitud: 1. **`/status`** muestra la credencial activa y, si las solicitudes pasan por un gateway, una línea `Anthropic base URL`. Si esperabas un gateway y esa línea no aparece, la variable no ha llegado a la sesión. Una `ANTHROPIC_API_KEY` olvidada en el entorno también puede enviar tus solicitudes por una clave de nivel bajo en lugar de tu suscripción. 2. **La frase final de `Request rejected (429)`** cambia según el proveedor, como detalla la [referencia de errores](https://code.claude.com/docs/es/errors). Con Bedrock, Google Cloud o Microsoft Foundry remite a la página de estado de ese proveedor en lugar de status.claude.com; con un `ANTHROPIC_BASE_URL` personalizado, nombra el host del gateway. Mientras consigues más cuota, reduce la concurrencia: baja `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`, lanza menos subagentes en paralelo o elige con `/model` un modelo más pequeño para las ejecuciones automatizadas. Para revisar qué base URL y qué credencial usa cada sesión, consulta la [configuración de Claude Code API: claves, settings.json, modelos y gateways](https://blog.laozhang.ai/es/posts/claude-code-api-configuration). ### Amazon Bedrock: `max_tokens` se descuenta de la cuota al empezar Bedrock aplica una cuota de tokens por minuto (TPM) a cada modelo, con entrada y salida sumadas, y otra de tokens por día (TPD) a la cuenta. La diferencia importante con la API directa está en el momento del cálculo, descrito en la [documentación de AWS sobre el recuento de tokens](https://docs.aws.amazon.com/es_es/bedrock/latest/userguide/quotas-token-burndown.html): - **Al empezar la solicitud**, Bedrock descuenta la entrada más el valor completo de `max_tokens`. Si eso supera la cuota, la solicitud se limita en ese momento. - **Al terminar**, ajusta el consumo a la entrada, más los tokens escritos en caché, más la salida real multiplicada por un factor del modelo, y devuelve lo que sobra. Los tokens leídos de caché no cuentan. En el ejemplo de la propia AWS, con un modelo de factor 5, una solicitud tiene 3.000 tokens de entrada, 1.000 escritos en caché, 4.000 leídos de caché y 1.000 de salida. Con `max_tokens` en 32.000, el descuento inicial es de 36.000 (3.000 + 1.000 + 32.000), aunque el consumo final sea de 9.000 (3.000 + 1.000 + 1.000 × 5). Con `max_tokens` en 1.250, el descuento inicial baja a 5.250 y caben más solicitudes simultáneas en el mismo TPM. Por eso, si alcanzas el TPM antes de lo esperado, AWS recomienda acercar `max_tokens` al tamaño real de tus respuestas. En la API directa ese ajuste no reserva capacidad; en Bedrock sí. El factor de salida depende del modelo. A 5 de octubre de 2026, la tabla de AWS indica 5 para los modelos de Anthropic de la versión 4.7 o anteriores, 10 para Claude Opus 5.5, Sonnet 5, Opus 5 y Fable 5.1, y 15 para los modelos Claude de la versión 4.8. Ese factor solo afecta a la cuota: la factura se calcula con los tokens reales. Bedrock devuelve `ThrottlingException` con HTTP 429 cuando te limita, y `ServiceQuotaExceededException` con HTTP 400 cuando la solicitud supera la cuota de servicio de tu cuenta; este último admite reenviar la solicitud más tarde. Los aumentos se solicitan en Service Quotas de AWS o al soporte de AWS. Para los demás 400 de Bedrock, consulta [qué significa cada error 400 de Claude en AWS Bedrock](https://blog.laozhang.ai/es/posts/aws-claude-400-error). ### Google Cloud (Agent Platform o Vertex AI): la cuota va por región La documentación de Claude Code llama ahora a este servicio Google Cloud's Agent Platform, aunque las direcciones de la consola de Google siguen usando `vertex-ai`. Necesitas cuota asignada en la región de Google Cloud que elijas, y según la [guía de Claude Code para Google Cloud](https://code.claude.com/docs/es/google-vertex-ai), un 429 se diagnostica así: 1. Si usas un endpoint regional, comprueba que tanto el modelo principal como el modelo pequeño y rápido que también utiliza Claude Code estén disponibles en esa región. 2. Prueba el endpoint global, que ofrece mejor disponibilidad. No todos los modelos lo admiten: compruébalo en Model Garden y, para los que no, fija una región por modelo con las variables `VERTEX_REGION_CLAUDE_*`. 3. Revisa la cuota actual en Cloud Console y solicita allí el aumento. Para subir los límites de ritmo, la guía remite al soporte de Google Cloud. ```bash export CLOUD_ML_REGION=global ``` Si `CLOUD_ML_REGION` no está definida o su valor no tiene forma de región, Claude Code usa `us-east5`. Cada variable `VERTEX_REGION_CLAUDE_*` sin valor válido recurre a `CLOUD_ML_REGION`. ### Gateway: presupuestos y límites que fija el operador Un gateway centraliza credenciales, seguimiento de uso, presupuestos y límites de ritmo para toda la organización, según la [documentación de Claude Code sobre gateways](https://code.claude.com/docs/es/llm-gateway). Por tanto, puede rechazar una solicitud por sus propias reglas aunque el proveedor de destino tenga capacidad libre. Estas señales lo delatan: - **Una página HTML 429 del proxy:** el texto que sigue a `·` en `Request rejected (429)` es el título de esa página, por ejemplo `Too Many Requests`. Antes de la versión 2.1.281 de Claude Code se imprimía todo el HTML. - **`spend limit reached`**, con el periodo y la hora de restablecimiento, como `spend limit reached (daily; resets … UTC)`: es el tope de gasto de un Claude apps gateway. El gateway marca esas respuestas con `x-should-retry: false`, así que Claude Code no reintenta; el bloqueo dura hasta el siguiente periodo o hasta que el operador amplíe el tope. En ambos casos, quien puede resolverlo es el operador del gateway. Envíale el mensaje completo, la hora con zona horaria y el host que aparece en `/status`. Un ticket a Anthropic no cambia un límite que ha configurado tu organización. ## 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. - **En Bedrock, Google Cloud o un gateway:** proveedor, región, modelo, identificador de solicitud del proveedor, la línea `Anthropic base URL` de `/status` si existe y el host o la página de estado que nombra el mensaje. En Bedrock, anota además si el error es `ThrottlingException` o `ServiceQuotaExceededException`. Ese último paquete va al soporte de AWS, al de Google Cloud o al operador del gateway, que son quienes gestionan esas cuotas. No compartas claves API, cabeceras `Authorization` o `x-api-key`, ni contenido privado de las conversaciones. 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. ## Fuentes Páginas externas que cita esta guía, en el orden en que aparecen. Última actualización: 2026-10-05. - [documentación oficial de límites de la API](https://platform.claude.com/docs/es/api/rate-limits) (platform.claude.com) - [referencia de errores actual de Claude Code](https://code.claude.com/docs/es/errors) (code.claude.com) - [registro de cambios de Claude Code](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) (github.com) - [ayuda oficial sobre mensajes de error](https://support.claude.com/es/articles/12466728-solucionar-mensajes-de-error-de-claude) (support.claude.com) - [guía oficial de uso](https://support.claude.com/es/articles/9797557-mejores-practicas-de-limites-de-uso) (support.claude.com) - [explicación de los límites de uso y duración](https://support.claude.com/es/articles/11647753-como-funcionan-los-limites-de-uso-y-duracion) (support.claude.com) - [Claude Status](https://status.claude.com/) (status.claude.com) - [referencia oficial de comandos](https://code.claude.com/docs/es/commands) (code.claude.com) - [límites de tu organización](https://platform.claude.com/settings/limits) (platform.claude.com) - [facturación de la API](https://platform.claude.com/settings/billing) (platform.claude.com) - [documentación de AWS sobre el recuento de tokens](https://docs.aws.amazon.com/es_es/bedrock/latest/userguide/quotas-token-burndown.html) (docs.aws.amazon.com) - [guía de Claude Code para Google Cloud](https://code.claude.com/docs/es/google-vertex-ai) (code.claude.com) - [documentación de Claude Code sobre gateways](https://code.claude.com/docs/es/llm-gateway) (code.claude.com)