Claude Code error 529 (Overloaded): qué significa y 5 soluciones fáciles
"Repeated 529 Overloaded errors" en Claude Code significa que Anthropic no tiene capacidad para ese modelo y no cuenta contra tu cuota. Diferencias con el 429 y el 500, qué reintenta Claude Code solo y 5 soluciones en orden.
bufferSobre el autor9 min de lectura
Si Claude Code se detiene con «API Error: Repeated 529 Overloaded errors», los servidores de Anthropic se han quedado sin capacidad para el modelo que estás usando. No has llegado a tu límite de uso, y la propia documentación de Anthropic dice que el Claude Code error 529 no cuenta contra tu cuota. Casi siempre basta con esperar unos minutos, mirar status.claude.com o cambiar de modelo con /model. Aquí te explico qué significa, en qué se diferencia del 429 y del 500, qué hace Claude Code por su cuenta y qué merece la pena probar. Todo sale de la documentación oficial, la página de estado y reportes reales en GitHub, con los enlaces en el texto.
Qué significa el Claude Code error 529
El 529 es un código de estado HTTP que devuelve la API de Claude con el tipo de error overloaded_error. La página de errores de la API de Claude lo resume en una línea: «The API is temporarily overloaded», es decir, la API está sobrecargada temporalmente. Justo debajo añade que un 529 puede aparecer cuando hay mucho tráfico entre todos los usuarios.
Claude Code no te enseña el primer 529. Reintenta en silencio y solo cuando se acaban los reintentos ves el mensaje completo que recoge la referencia de errores de Claude Code:
API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.En esa misma página lo dicen sin rodeos: «A 529 is not your usage limit and doesn’t count against your quota.» O sea, no has gastado tu cupo de Pro o Max y tu cuenta no tiene ningún problema. Hay demasiada gente pidiendo el mismo modelo a la vez y Anthropic está rechazando parte de las peticiones.
Error 529 frente a 429 y 500 en Claude Code
Estos tres códigos se confunden mucho y la solución cambia según cuál te salga.
| Código | Tipo de error | Qué dice Anthropic | ¿Sirve esperar? |
|---|---|---|---|
| 529 | overloaded_error | La API está sobrecargada temporalmente por el tráfico de todos los usuarios | Sí, normalmente en minutos |
| 429 | rate_limit_error | Tu organización ha llegado a un límite de tasa, al tope de gasto mensual de su nivel o a un límite de gasto del espacio de trabajo de Claude Code | Solo si es una limitación breve; con el tope de gasto sigue fallando hasta que se recupera el acceso |
| 500 | api_error | Un error inesperado dentro de los sistemas de Anthropic | Sí, reintenta con espera exponencial |
| 504 | timeout_error | La petición superó el tiempo de procesamiento | Reintenta o usa streaming en peticiones largas |
El 429 tiene que ver contigo o con tu organización. En Claude Code aparece como «Request rejected (429)» cuando una clave de API, un proyecto de Bedrock o uno de Google Cloud llega a su límite, o como «You’ve hit your session limit» y «You’ve hit your weekly limit» si usas un plan Pro o Max. Esos límites del plan son compartidos entre todos los modelos, así que cambiar de modelo no sirve ahí. Tengo todos los mensajes exactos en mi guía de errores de Claude Code, y los límites del plan los explico en cómo funciona la cuota de Claude Pro y Max. Si lo que te sale es un 429 y no un 529, en mi guía del error 429 Claude Code repaso cada mensaje, las cabeceras que conviene leer y lo equivalente en Codex.
El 500 es un fallo del lado de Anthropic. Tampoco es culpa tuya, y el mensaje de Claude Code para ese error también te manda a la página de estado.
Lo que Claude Code ya hizo antes de mostrarte el error
Cuando lees el mensaje, Claude Code ya lo ha intentado varias veces. La referencia de errores dice que reintenta los fallos transitorios hasta 10 veces con espera exponencial antes de mostrarte nada, y las respuestas de sobrecarga están en esa lista. Mientras reintenta, el indicador muestra una cuenta atrás del tipo Retrying in Ns · attempt x/y, y desde la v2.1.198 un 529 también menciona status.claude.com debajo.
Hay un detalle que conviene saber. La referencia de variables de entorno indica que los reintentos pueden pararse antes con los 529 y pone un ejemplo: con una clave de API y un modelo Opus, se detiene en el tercer 529. Si usas Opus y el error te sale enseguida, es el comportamiento previsto, no una instalación rota.
Estos son los ajustes oficiales que cambian cómo Claude Code maneja un 529:
| Ajuste | Valor por defecto | Qué hace |
|---|---|---|
CLAUDE_CODE_MAX_RETRIES | 10 | Número de reintentos, con un máximo de 15 desde la v2.1.186 |
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS | 500 | Espera inicial entre reintentos de un 529, hasta 32000 (v2.1.292 o posterior) |
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS | 32000 | Espera máxima entre reintentos de un 529, hasta 64000 (v2.1.296 o posterior) |
CLAUDE_CODE_RETRY_WATCHDOG | sin definir | Con valor 1, en sesiones desatendidas como CI, reintenta los 429 y 529 de capacidad sin límite |
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS | sin definir | Limita cuánto espera cada petición con el watchdog activado (v2.1.295 o posterior) |
Yo no activaría el watchdog en una sesión interactiva. Está pensado para trabajos que nadie vigila, y cuando estás delante de la terminal es mejor ver el error y decidir tú.
5 soluciones fáciles, en este orden
1. Espera unos minutos y escribe «try again»
La recomendación oficial es volver a intentarlo en unos minutos. Tu mensaje sigue en la conversación, así que no hace falta pegar otra vez un prompt largo. Basta con escribir «try again» o «continúa».
2. Mira status.claude.com
Abre status.claude.com. Si hay una incidencia activa para tu modelo, lo único que funciona es esperar y puedes dejar de revisar tu configuración. Hoy, 27 de octubre de 2026, hubo una: «Elevated errors for Claude Sonnet 5.5», publicada a las 09:14 UTC (10:14 en España peninsular) y marcada como resuelta a las 09:56 UTC. La página de estado habla de «errores elevados» y no de «529», así que tómalo como una pista fuerte, no como una prueba.
3. Cambia de modelo con /model
Esto funciona más a menudo de lo que parece, porque la documentación dice que la capacidad se mide por modelo («capacity is tracked per model»). Escribe /model y elige otro. Cuando un modelo está muy cargado, Claude Code incluso te lo sugiere con un mensaje como Opus is experiencing high load, please use /model to switch to Sonnet. En la app de escritorio de Claude dice «Opus is experiencing high load. Switch to Sonnet.» y se cambia con el selector de modelos.
4. Configura un modelo de respaldo para que cambie solo
Si te pasa a menudo, configura una cadena de respaldo. Según la documentación de configuración de modelos, cuando el modelo principal está sobrecargado o no disponible, Claude Code puede pasar a un modelo de respaldo en vez de fallar. Para una sola sesión puedes arrancarlo así:
claude --fallback-model sonnet,haikuPara que se quede, pon fallbackModel como una lista en tus ajustes. El cambio solo dura el turno actual, la cadena admite como mucho tres modelos y los errores de límite de tasa nunca provocan el cambio. Esto último importa, porque significa que el respaldo no va a esconder un 429. Desde la v2.1.247 la cadena también cubre a los subagentes. Antes, un fallo así terminaba el subagente, y eso cuadra con un reporte de julio de 2026 en GitHub en el que cuatro agentes en segundo plano murieron por un 529 durante una misma sesión larga.
5. Actualiza Claude Code y, si sigue, repórtalo
Varias de las mejoras de reintentos que he mencionado solo existen en versiones recientes, así que ejecuta claude update si vas atrasado. Cuando lo comprobé, la última versión en npm era la 2.1.311. Si el error sigue saliendo sin ninguna incidencia en la página de estado, usa /feedback para que Anthropic reciba los datos de tu petición.
¿Hay horas mejores para usar Claude Code?
Busqué una respuesta oficial y no encontré ninguna específica para el 529. Anthropic no publica un calendario de errores de capacidad.
Lo más parecido es un cambio que Anthropic anunció el 26 de marzo de 2026. Thariq, de Anthropic, publicó en X que entre semana, de 5 a 11 de la mañana hora del Pacífico (de 13:00 a 19:00 GMT), la cuota de sesión de 5 horas se gasta más rápido que antes, y que los límites semanales no cambian. Eso trata de lo rápido que se consume tu cuota, no del 529, pero sí te dice cuándo hay más demanda. En hora peninsular española eso equivale a las 14:00-20:00 durante casi todo el año. No encontré ninguna página oficial más reciente que confirme que esa regla de horas punta sigue vigente.
También ordené las incidencias de modelos de este mes en la página de estado. De las nueve incidencias de octubre que afectaron a Claude Code y nombraban un modelo, solo dos empezaron dentro de esa franja de demanda alta. El resto empezó a otras horas. Así que usar Claude Code fuera de la hora punta no te libra del Claude Code error 529; sobre todo hace que tu cuota de sesión dure más.
Lo que están viendo otros usuarios
No eres el único. Cuando lo comprobé, una búsqueda en anthropics/claude-code de issues con «529 Overloaded» en el título devolvía 114 resultados. El más activo, el issue #3572 de julio de 2025, tiene 274 comentarios. Los reportes recientes son parecidos: el issue #78535 de julio de 2026 muestra 529 Overloaded · Retrying in 0s · attempt 10/10, y en el issue #75953 un usuario contó 322 eventos de 529 registrados en más de 13 días, entre el 8 de junio y el 9 de julio de 2026.
Si también usas Codex, tiene su propia versión de este error con otro texto. Lo expliqué en Selected model is at capacity en Codex: solución, y comparo las dos herramientas en Claude Code o Codex: cuál pagar.
Preguntas frecuentes sobre el Claude Code error 529
¿Un 529 gasta mi cuota de Pro o Max?
No. La documentación de Claude Code dice que un 529 «is not your usage limit and doesn’t count against your quota».
¿Pasar de Pro a Max evita los errores 529?
No encontré nada oficial que diga que un plan superior se libra del 529. Anthropic lo describe como tráfico alto entre todos los usuarios. Max te da más uso por sesión, lo que ayuda con los límites de sesión del 429, no con la capacidad. Si de todos modos estás dudando entre planes, los comparo en Claude Pro vs Max.
¿Por qué falla enseguida con Opus y mi clave de API?
Está documentado. Con una clave de API y un modelo Opus, Claude Code deja de reintentar en el tercer 529 y muestra el error. Si configuras un modelo de respaldo, cambia de modelo en lugar de fallar.
¿Es lo mismo un 529 que «Server is temporarily limiting requests»?
No. Ese mensaje es una limitación breve de tipo 429 que Claude Code distingue porque no trae las cabeceras de cuota, y la documentación la marca como «not your usage limit». Desde la v2.1.199 Claude Code la reintenta automáticamente.
¿Puedo hacer que Claude Code siga reintentando en CI?
Sí. Con CLAUDE_CODE_RETRY_WATCHDOG=1 reintenta los 429 y 529 de capacidad sin límite, y puedes poner un tope a la espera con CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS.