--- title: "Soluciona el error 529 overloaded y el error 429 de rate limit en Claude" description: "Un 529 overloaded_error significa que la API de Claude está saturada para todos. Un 429 rate_limit_error significa que tu organización alcanzó un límite. Reintenta ambos con backoff." canonical: "https://logbrew.co/es/guides/claude-overloaded-rate-limit-error" last_updated: "2026-11-10" --- # Soluciona el error 529 overloaded y el error 429 de rate limit en Claude Un 529 `overloaded_error` significa que la API de Claude está saturada para todos. Un 429 `rate_limit_error` significa que tu organización alcanzó un límite. Reintenta ambos con backoff. Probado el 10 de noviembre de 2026 con Claude Code 2.1.319 y @anthropic-ai/sdk 1.7.0 Por [Furkan Erday](https://github.com/furkanerday). Furkan Erday es el fundador de LogBrew. Desarrolla LogBrew con Claude Code y Codex todos los días. Canonical: https://logbrew.co/es/guides/claude-overloaded-rate-limit-error ## Cuánto esperó cada cliente antes de reintentar | | Segundos antes de cada reintento | Reintentos | Tiempo total | | --- | --- | --- | --- | | Claude Code, todas las respuestas 529 | 0,6 · 1,1 | 2 | 2,4 s | | Claude Code, todas las respuestas 429 | 0,5 · 1,2 · 2,5 · 4,1 · 8,8 · 18,8 · 34,2 · 35,4 · 36 · 39,9 | 10 | 182 s | | SDK de TypeScript con `maxRetries: 5`, todas las respuestas 529 | 0,4 · 1 · 1,9 · 3,5 · 7,4 | 5 | 14,3 s | ## Soluciónalo en Claude Code ### Revisa la página de estado de Claude Si status.claude.com muestra un aviso de capacidad, el problema está del lado de Anthropic y solo se arregla con tiempo. ### Espera y vuelve a intentarlo `API Error: Repeated 529 Overloaded errors` significa que Claude Code ya reintentó. Un 529 no cuenta para tu límite de uso. ### Cambia a otro modelo Anthropic controla la capacidad por modelo. Elige otro modelo, por ejemplo Sonnet cuando Opus está saturado. ```bash /model ``` ### Define un modelo de respaldo para scripts En modo print, `--fallback-model` pasa a un segundo modelo tras varios errores 529 seguidos. En nuestra prueba cambió después de 3 solicitudes. ```bash claude -p "Run the tests" --fallback-model sonnet ``` ### Mantén en marcha las ejecuciones desatendidas En CI y otras ejecuciones que nadie vigila, esta opción reintenta los errores 529 y 429 hasta que vuelve la capacidad. ```bash export CLAUDE_CODE_RETRY_WATCHDOG=1 ``` ## Soluciónalo en tu propia app ### Reintenta con backoff Los SDK oficiales de Claude reintentan los errores 429, 529 y otros 5xx 2 veces por defecto, con backoff exponencial, y respetan la cabecera `retry-after`. Sube `maxRetries` si tu app puede esperar más. ```bash import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ maxRetries: 5 }); ``` ### Registra el error y su ID de solicitud Cuando se agotan los reintentos, el SDK lanza `OverloadedError` o `RateLimitError`. Guarda `error.requestID` para que el soporte de Anthropic pueda encontrar la solicitud. ```bash try { await client.messages.create(request); } catch (error) { if ( error instanceof Anthropic.OverloadedError || error instanceof Anthropic.RateLimitError ) { console.warn("Claude API busy", error.status, error.requestID); } throw error; } ``` ### Aumenta el tráfico poco a poco Un salto brusco en tu propio tráfico puede activar los límites de aceleración 429. Aumenta el tráfico paso a paso y mantenlo estable. ## Lo que vimos al probarlo Nadie puede forzar un 529 real, así que apuntamos Claude Code y el SDK de TypeScript a un servidor de prueba local que respondía a cada solicitud con 529 o 429. Claude Code trata un servidor así como un gateway, por lo que una sesión con la API real puede ser distinta. Claude Code envió 3 solicitudes que recibieron 529 y se detuvo a los 2,4 segundos con `Repeated 529 Overloaded errors`. Con `--fallback-model sonnet`, pasó a Sonnet tras esas 3 solicitudes y reintentó 10 veces más durante unos 3 minutos. Un 429 tuvo 10 reintentos en 182 segundos, con esperas que crecieron de 0,5 a 40 segundos, antes de `Request rejected (429)`. Con `CLAUDE_CODE_RETRY_WATCHDOG=1`, Claude Code seguía reintentando un 529 cuando paramos la ejecución a los 150 segundos. Con la configuración por defecto, el SDK envió 3 solicitudes, la primera más 2 reintentos, y lanzó `OverloadedError` tras 1,3 segundos. Con `maxRetries: 5` envió 6 solicitudes en 14,3 segundos. Cuando el 429 traía `retry-after: 3`, el SDK esperó 3 segundos antes de cada reintento, y Claude Code esperó 3 segundos antes de cada uno de sus 3 primeros reintentos. ## 529 y 429 son errores distintos Un 529 `overloaded_error` significa que la API está saturada para todos los usuarios. No es tu límite y no cuenta para tu cuota. Un 429 `rate_limit_error` es de tu organización. Alcanzaste un rate limit, el tope de gasto mensual de tu nivel de uso o un límite de gasto en el espacio de trabajo de Claude Code. Un 429 por tope de gasto no trae la cabecera `retry-after` y sigue fallando hasta que vuelve el acceso, así que ahí reintentar no sirve. ## Los límites del plan de Claude Code no son errores de la API `You've hit your session limit` y `You've hit your weekly limit` vienen de tu plan de Claude. El límite de sesión es la ventana móvil que la gente llama el límite de 5 horas. Ejecuta `/usage` para ver ambos límites y cuándo se reinician. `Server is temporarily limiting requests (not your usage limit)` es una limitación breve en el servidor, y Claude Code la reintenta por ti. `Request rejected (429)` significa que una clave de API, un proyecto de Amazon Bedrock o un proyecto de Google Cloud alcanzó su propio rate limit. Una `ANTHROPIC_API_KEY` en tu terminal tiene prioridad sobre tu plan, así que Claude Code puede chocar con el límite más bajo de la clave. Ejecuta `/status` para ver qué inicio de sesión está activo. #16157, con 1499 comentarios, recoge casos de usuarios de Max que alcanzan el límite casi al instante. En enero de 2026, un ingeniero de Anthropic escribió que el equipo aún no tenía una buena explicación. #29579 reporta `Rate limit reached` con un 16 % de uso, y #6457 reporta el límite de 5 horas en menos de 90 minutos. Los 3 reportes siguen abiertos. ## Preguntas frecuentes ### ¿Un error 529 cuenta para mi límite de uso de Claude? No. La documentación de Claude Code dice que un 529 no es tu límite de uso y no cuenta para tu cuota. ### ¿Cuánto dura el error overloaded de Claude? Anthropic dice que suele ser temporal. Revisa status.claude.com para ver si hay un incidente abierto y sus actualizaciones. ### ¿Por qué Claude Code dice rate limit reached? Se agotó el límite de tu plan, el servidor limitó las solicitudes durante un rato o una clave de API alcanzó su rate limit. `/usage` y `/status` te dicen cuál de los tres es. ### ¿Cuándo se reinicia el límite de Claude Code? El mensaje indica la hora, por ejemplo `resets 3:45pm`. `/usage` también la muestra. ### ¿Mi app debería reintentar un error 529? Sí, con backoff exponencial. Los SDK oficiales reintentan 2 veces por defecto, y en nuestra prueba el SDK de TypeScript esperó exactamente lo que pedía `retry-after`. ## Ve cada error de la API de Claude en tu app Si tu app llama a la API de Claude, LogBrew agrupa los errores 529 y 429 repetidos en 1 incidencia y muestra con qué frecuencia ocurre cada uno. Empieza con el generoso plan gratuito, sin tarjeta. [Empezar gratis](https://logbrew.co/es) ## Fuentes - [Claude API docs, Errors](https://platform.claude.com/docs/en/api/errors) - [Claude API docs, Rate limits](https://platform.claude.com/docs/en/api/rate-limits) - [Claude Code docs, Error reference](https://code.claude.com/docs/en/errors) - [anthropics/claude-code#16157](https://github.com/anthropics/claude-code/issues/16157) - [anthropics/claude-code#29579](https://github.com/anthropics/claude-code/issues/29579) - [anthropics/claude-code#6457](https://github.com/anthropics/claude-code/issues/6457) ## Más guías para agentes de programación con IA - [Añade un servidor MCP a Claude Code y Codex](https://logbrew.co/es/guides/mcp-server-claude-code-codex) - [Usa AGENTS.md en Claude Code y Codex](https://logbrew.co/es/guides/agents-md) - [Cómo solucionar errores en Claude Code, Codex y JavaScript del navegador](https://logbrew.co/es/guides)