Error 529 (overloaded)
El error 529 (overloaded_error) significa que la API de Claude está sobrecargada en ese momento por el tráfico de todos los usuarios. No es un fallo de tu código ni de tu cuenta: se resuelve reintentando al cabo de unos segundos.
El error 529 es la respuesta que da la API de Claude cuando está temporalmente sobrecargada. Llega con el tipo overloaded_error y el mensaje "Overloaded", y suele aparecer en momentos de mucho tráfico que afectan a todos los usuarios a la vez. No significa que hayas hecho algo mal ni que tu cuenta tenga un problema.
En qué se diferencia de otros errores
- 529 overloaded_error: la API está saturada para todos. Se arregla solo; hay que reintentar.
- 429 rate_limit_error: has superado un límite de tu organización (peticiones o tokens por minuto, el tope de gasto de tu nivel o una subida de uso demasiado brusca). Depende de ti: espera lo que indique la cabecera
retry-after, reparte las peticiones o sube de nivel. - 500 api_error: un error interno inesperado. También se reintenta y, si se repite, se contacta con soporte con el identificador de la petición.
Qué hacer si te sale en la API
Reintentar con espera exponencial: esperar un poco, reintentar, y si vuelve a fallar esperar el doble. Los SDK oficiales de Anthropic ya lo hacen solos con los errores transitorios (conexión, límites de uso y errores 5xx): reintentan 2 veces por defecto y respetan retry-after. Si tu aplicación recibe muchos 529, sube el número de reintentos con max_retries en Python o maxRetries en TypeScript.
import anthropic
client = anthropic.Anthropic(max_retries=5)Más sobre los límites de tu cuenta, que son la causa del 429, en qué es un rate limit. Para construir aplicaciones que aguanten estos errores, el curso de la API de Claude para builders trata reintentos, colas y costes.
Y en claude.ai o en Claude Code
En la app el aviso es otro: "Due to unexpected capacity constraints, Claude is unable to respond to your message" (Claude no puede responder por falta de capacidad). Lo que recomienda Anthropic es esperar unos minutos y volver a intentarlo. En Claude Code, que usa la API por debajo, el mensaje puede llegar como "API Error: 529 Overloaded" y se resuelve igual.
Ojo con la página de estado: status.claude.com no muestra estas restricciones de capacidad, porque Anthropic las considera gestión normal de la carga. Solo publica incidentes confirmados que afectan a todos o casi todos los usuarios, así que puede estar en verde mientras a ti te sale el error.
Qué NO es
- No es el límite de tu plan: cuando agotas tu uso de Claude Pro o Max el aviso dice cuándo se reinicia, no "overloaded".
- No se arregla cambiando la clave de API: es un problema de capacidad general, no de tus credenciales.
Preguntas frecuentes
¿Qué significa API Error 529 Overloaded?
Que la API de Claude está sobrecargada en ese momento por el tráfico de todos los usuarios. No es un fallo tuyo: reintenta al cabo de unos segundos.
¿Cuánto dura el error 529?
Suele ser cuestión de segundos o minutos. Anthropic no publica una duración; recomienda reintentar con espera exponencial en la API y esperar unos minutos en la app.
¿En qué se diferencia del error 429?
El 529 es una sobrecarga general de la API. El 429 es que tu organización ha superado uno de sus límites de uso o de gasto, y se resuelve repartiendo las peticiones o subiendo de nivel.
¿Por qué status.claude.com sale en verde si me da error?
Porque las restricciones de capacidad no se publican en la página de estado: Anthropic solo pone ahí los incidentes confirmados que afectan a todos o casi todos los usuarios.