Claude error 429 (too many requests): es la limitación de Anthropic, no el límite de tu plan, y las seis soluciones en orden

¿Cómo se soluciona el error too many requests de Claude?

Sigue estos seis pasos en orden. Ninguno toca tus chats ni tu plan.

1. Espera un minuto y reintenta una sola vez. La referencia de errores de Claude Code de Anthropic dice "Wait briefly and try again". Pulsar reintentar sin parar solo envía más solicitudes.
2. Actualiza Claude Code con claude update. Desde la versión 2.1.199, estas limitaciones se reintentan con espera progresiva antes de que las veas. La versión actual es la 2.1.316, del 31 de octubre de 2026.
3. Ejecuta /status y revisa la credencial activa. Anthropic avisa de que "A stray ANTHROPIC_API_KEY in your environment can route requests through a low-tier key instead of your subscription."
4. Cierra sesiones y subagentes de más. Para los 429 con una clave de API, la documentación dice "avoid running many parallel subagents". En el registro de un suscriptor de Max, 114 de 122 minutos con un 429 tenían seis o más sesiones de escritorio abiertas.
5. Cambia de modelo con /model. En la API, cada modelo tiene su propia fila de solicitudes y tokens por minuto, así que un modelo más pequeño puede mantener en marcha un proceso automatizado.
6. Consulta status.claude.com y después repórtalo. Si no hay nada publicado y el error dura horas, envía el mensaje exacto y el ID de la solicitud.

Este es el texto que muestra Claude Code: "API Error: Server is temporarily limiting requests (not your usage limit)". La explicación de Anthropic cabe en una línea: "The API applied a short-lived throttle that is unrelated to your plan quota." Claude Code la distingue de un límite real "by the absence of the unified quota headers a real limit response carries". En la pestaña Code de la app de escritorio de Claude, un reporte de error del 30 de mayo de 2026 muestra la misma limitación como "Server is temporarily limiting requests" sobre una línea que dice "Too many requests right now". Eso es lo que la gente busca como "claude too many requests right now".

Buscamos en el rastreador público de incidencias de Claude Code de Anthropic el 2 de noviembre de 2026 todas las incidencias de 2026 cuyo título o cuerpo contuviera "temporarily limiting requests". Salieron 410. Una sola cuenta presentó 275 de ellas, y sus reportes de finales de julio nombraban todos Claude Code 2.1.114, una versión de abril. Dejamos fuera esa cuenta. Las otras 135 vinieron de 125 personas distintas, y 129 se abrieron antes de julio. La entrada del changelog para la 2.1.199 dice: "Transient server rate-limit errors (429s unrelated to your usage limit) are now retried automatically with backoff for subscribers instead of failing the turn". La limitación no desapareció. Un reporte de septiembre contó 195 errores 429 reintentados en un solo día. Interpreta la caída como menos turnos fallidos, no menos 429.

¿Qué mensaje de too many requests de Claude estás viendo?

El texto te dice de quién es el límite que has alcanzado. Esta tabla cubre Claude Code, la app de escritorio de Claude y la API de Claude, según lo leído el 2 de noviembre de 2026.

La guía de mensajes de error de Anthropic para las apps de Claude no incluye ningún mensaje "too many requests". Sus mensajes de límite alcanzado nombran todos una hora de reinicio; solo sus avisos de "approaching" no lo hacen. Así que si tu mensaje indica una hora, has llegado al límite de tu plan, y Claude usage limit reached tiene las soluciones. Si dice overloaded o 529, es un problema de capacidad, que se explica en Claude overloaded.

¿Por qué Claude dice too many requests si tu uso es bajo?

Claude dice too many requests con poco uso porque la limitación cuenta la rapidez con que llegan las solicitudes, no cuánto de tu plan has gastado. La página de límites de tasa de Anthropic dice que los límites pueden aplicarse en lapsos cortos: "a rate of 60 requests per minute (RPM) might be enforced as 1 request per second." Así, una ráfaga de llamadas puede fallar aunque tu promedio del minuto parezca normal.

Los reportes de errores lo muestran con claridad. Un suscriptor de Max el 30 de mayo de 2026 recibió la limitación el mismo día en que se reiniciaban sus límites. Un reporte del 18 de agosto vio 429 persistentes con un 1% de uso. Un reporte del 24 de septiembre, con un 26 a 27% de uso del plan, recibió un 429 en el 14% de los minutos de sesión con seis o más sesiones de escritorio abiertas. Con cinco o menos, fue menos del 1%.

Un crecimiento repentino también la activa. La página de errores de la API de Anthropic dice "if your organization has a sharp increase in usage, you might see 429 errors because of acceleration limits on the API." Su consejo es "increase your traffic gradually and maintain consistent usage patterns." Un flujo de Claude Code que se reparte entre muchos subagentes a la vez envía justo ese tipo de pico. Anthropic no publica las cifras detrás de la limitación para quienes usan un plan de claude.ai.

¿Cuánto dura el error too many requests de Claude?

La limitación de Claude suele desaparecer en segundos o minutos. Claude Code reintenta los 429 transitorios hasta 10 veces con espera exponencial, y muestra Retrying in Ns · attempt x/y mientras espera. Solo ves el error cuando se agotan esos reintentos.

Algunos reportes duraron mucho más. Quien reportó el 30 de mayo dijo que duró "two days", y que una sesión nueva le dejó trabajar "3 hours at least" antes de que volviera. Un reporte del 15 de junio dijo que la limitación se mantenía "for the last 24 hours" en Opus 4.8. En el hilo de mayo, una sesión nueva y otro modelo hicieron que la gente volviera a trabajar. Si sigue ahí después de una hora con una sola sesión abierta, no depende de ti arreglarlo.

Para los trabajos que se ejecutan mientras no estás, Claude Code tiene un interruptor. Define CLAUDE_CODE_RETRY_WATCHDOG=1 y reintenta los errores 429 y 529 indefinidamente. Limita la espera con CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS, por ejemplo 3600000 para una hora. Define CLAUDE_CODE_MAX_RETRIES=2 si prefieres que un script falle rápido.

¿Pagar Claude Max evita el too many requests?

No. La limitación es "unrelated to your plan quota", y los reportes anteriores venían de suscriptores de Pro y Max. En noviembre de 2026 Claude cuesta $20 al mes en Pro, $100 en Max y $200 en Ultra, según la página de precios de Anthropic. Max indica "Priority access at high traffic times". Anthropic no aclara si eso cubre la limitación o no.

Whizi, que publica esta página, usa el mismo tipo de protección y muestra las cifras: 10 mensajes de chat por minuto y 60 por hora por usuario, igual en todos los planes. Su error por minuto dice "Too many requests. Please wait and try again." y una solicitud rechazada no gasta nada de tu asignación (límites de tasa de Whizi). Donde Whizi pierde: 60 por hora es un techo firme, y Claude Max no muestra ninguna cifra por hora.

¿Cómo se soluciona un 429 rate_limit_error de la API de Claude?

Lee el cuerpo del error antes de reintentar, porque la API de Claude envía 429 rate_limit_error por más de un problema. La página de errores de Anthropic dice que tu organización "has hit a rate limit, reached its usage tier's monthly spend cap, or reached a spend limit on the Claude Code workspace." Solo algunos se resuelven con el tiempo.

Dos detalles confunden a la gente. Primero, un límite de gasto que fijas tú mismo no es un 429. Es un 400 invalid_request_error que empieza con "You have reached your specified API usage limits". Segundo, los topes de gasto son $500 al mes en Start, $1,000 en Build y $200,000 en Scale. Al llegar al tope, "API usage pauses until 00:00 UTC on the first day of the next month", e incluso los reintentos automáticos del SDK fallan hasta entonces.

Los límites pertenecen a tu organización en conjunto, no a una sola clave. En el nivel Start, Claude Opus 5.5, Sonnet 5.5 y Haiku 5.5 tienen cada uno 4,000 solicitudes por minuto y 2,000,000 de tokens de entrada por minuto, en noviembre de 2026. Las organizaciones nuevas pueden empezar con menos, en un nivel Evaluation. En la mayoría de los modelos, los tokens que lees de la caché no cuentan para los tokens de entrada por minuto, así que el almacenamiento en caché de prompts eleva el techo real que tienes. El SDK oficial reintenta los 429 dos veces por defecto y respeta retry-after. Vigila la cabecera anthropic-ratelimit-requests-remaining en cada respuesta y reduce el ritmo antes de que llegue a cero.