Claude 529 overloaded_error: qué significa y cómo solucionarlo en 2026

Un error 529 overloaded_error significa que Anthropic no tiene capacidad libre en ese momento para el modelo que estás usando. Afecta a todos los usuarios a la vez, no lo provoca tu prompt ni tu clave y, en Claude Code, no es tu límite de uso: la referencia de errores de Claude Code dice que un 529 «no es tu límite de uso y no cuenta contra tu cuota». Lo veas como Overloaded, como «modelo sobrecargado» o como «servidor sobrecargado», es el mismo problema de capacidad.

Qué hacer, por orden:

1. Si el mensaje salió en Claude Code, los reintentos ya se hicieron. Con la configuración por defecto, Claude Code reintenta hasta 10 veces durante unos 160 segundos antes de mostrarte el error. Reenviar al instante rara vez cambia nada.
2. Cambia de modelo con /model. La capacidad se controla por modelo, así que pasar de Opus a Sonnet (o al revés) suele bastar para seguir trabajando.
3. Consulta status.claude.com, o la página de estado del proveedor que nombre el propio mensaje (Amazon Bedrock, Google Cloud, Microsoft Foundry o tu pasarela).
4. Si el mensaje termina en check your inference gateway, el error ha pasado por tu proxy o pasarela LLM: empieza por sus registros y por el proveedor al que reenvía.
5. Si persiste y no hay incidente publicado, ejecuta /feedback en Claude Code o guarda el request-id de la respuesta de la API para el soporte.

Qué significa Claude 529 Overloaded Error o «modelo sobrecargado»

La lista oficial de errores de la API define el código así: 529 - overloaded_error: The API is temporarily overloaded (la API está temporalmente sobrecargada), y añade que puede aparecer cuando la API recibe mucho tráfico de todos los usuarios. Es decir: el servidor que sirve ese modelo está sobrecargado en ese momento, no tu cuenta. El cuerpo de la respuesta tiene esta forma:

{
  "type": "error",
  "error": { "type": "overloaded_error", "message": "Overloaded" },
  "request_id": "req_..."
}

De esa definición salen tres consecuencias prácticas:

• No es un fallo de tu código ni de tu cuenta. Rotar claves, reinstalar o reescribir el prompt no arregla un 529.
• La capacidad va por modelo. Cuando un modelo se satura, otro suele seguir respondiendo. Por eso cambiar de modelo es la salida más rápida.
• Es temporal. Esperar unos minutos funciona casi siempre; lo que no funciona es reintentar en bucle sin pausa.

Desde el 11 de agosto de 2025, según las notas de versión de la API, un aumento brusco del tráfico de tu propia organización devuelve un 429 rate_limit_error (los llamados límites de aceleración), cuando antes ese caso podía acabar en 529. Hoy, por tanto, un 529 apunta a carga general en el modelo y no a tus ráfagas.

Qué mensaje tienes y de qué capa viene

El número 529 aparece en sitios muy distintos. Esta tabla relaciona el texto exacto (que se queda en inglés, tal como lo verás) con la capa que lo genera y el primer paso:

Mensajes como anthropic stream error (overloaded_error): Overloaded vienen de herramientas de terceros que envuelven el evento de error del streaming; se tratan igual que la fila del event: error.

«API Error: 529 Overloaded» en Claude Code: qué hacer

Claude Code ya reintentó unos 160 segundos antes de avisarte

Según la referencia de errores, Claude Code reintenta los fallos transitorios hasta 10 veces con espera exponencial antes de mostrar nada. Para un 529, la espera parte de 500 ms (CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS), se duplica en cada intento y tiene un techo de 32 s (CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS). Con esos valores por defecto:

0,5 + 1 + 2 + 4 + 8 + 16 + 32 + 32 + 32 + 32 = 159,5 s, es decir, unos 2 minutos y 40 segundos, algo más si se suma la variación aleatoria entre intentos.

Si la saturación dura más que eso, cada mensaje que envíes agotará sus reintentos y fallará, y dará la sensación de que el error «no se va nunca». Dos detalles más:

• Desde la v2.1.198, el contador muestra API error en los dos primeros intentos y pasa a 529 Overloaded a partir del tercero; justo debajo indica dónde consultar el estado.
• En un análisis comunitario del binario 2.1.220, las sesiones con clave de API en modelos de la clase Opus, Fable o Mythos se rendían tras solo tres 529 con Repeated 529 Overloaded errors, aunque el contador mostrara attempt N/10. Es una lectura de esa versión concreta, no documentación oficial.

Cambia de modelo con /model: la capacidad va por modelo

La propia documentación lo recomienda: ejecuta /model y elige otro modelo, «ya que la capacidad se controla por modelo». Con la API de Anthropic, los alias apuntan a opus → Opus 5.5, sonnet → Sonnet 5.5, haiku → Haiku 5.5 y fable → Fable 5.1. En Bedrock y Google Cloud, sonnet sigue apuntando a Sonnet 4.5 y haiku a Haiku 4.5, según la configuración de modelos de Claude Code.

El historial de status.claude.com confirma el patrón: el 6 de octubre de 2026 solo Opus 5.5 tuvo errores elevados, y el 5 de octubre solo Mythos 5.1 y Fable 5.1. Quien cambió de modelo esos días pudo seguir trabajando. Si dependes de Opus, en Claude Opus 5.5: precio, disponibilidad y qué falla al migrar tienes lo que cambia al pasar a la versión actual.

Modelo de respaldo automático: --fallback-model y fallbackModel

Si no quieres cambiar a mano, configura una cadena de respaldo. Para una sesión:

claude --fallback-model sonnet,haiku

Para todas las sesiones, en el archivo de ajustes (settings.json):

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

Cómo se comporta, según la documentación de cadenas de respaldo:

• Se activa cuando el modelo principal está sobrecargado, no disponible o devuelve otro error de servidor que no se puede reintentar. Los errores de límite de velocidad (429), autenticación o facturación nunca provocan el cambio.
• El cambio dura solo el turno actual; tu siguiente mensaje vuelve a probar el modelo principal.
• Admite un máximo de tres modelos. /status no muestra la cadena: lo primero que verás es el aviso cuando se produzca el cambio.
• Cubre también a los subagentes desde la v2.1.247 y la compactación desde la v2.1.178 (nunca hacia un modelo con menos contexto que el principal).

Ojo con una creencia antigua: Opus no pasa solo a Sonnet cuando se satura. Ocurre únicamente si tienes una cadena configurada o si aceptas el aviso Opus is experiencing high load.

Sesiones desatendidas y CI: alarga la espera

Para tareas largas sin nadie delante, que un 529 corte el trabajo a los tres minutos sale caro. Estas variables de entorno amplían la espera:

Ejemplo de cálculo con la misma progresión: con CLAUDE_CODE_MAX_RETRIES=15 y el techo en 64.000 ms, la ventana pasa a 0,5 + 1 + 2 + 4 + 8 + 16 + 32 + 8 × 64 = 575,5 s, casi 10 minutos. Para CI, CLAUDE_CODE_RETRY_WATCHDOG=1 es más directo: espera a que pase la saturación y, desde la v2.1.239, falla en el acto si el 429 se debe a un límite de gasto o a créditos agotados. Estas variables cambian casi cada mes; comprueba tu versión con claude --version (a 14 de octubre de 2026, la última es la 2.1.299).

Cuándo reportar el 529

Si el error se repite durante mucho rato, otros modelos también fallan y status.claude.com no muestra ningún incidente, ejecuta /feedback dentro de Claude Code para que Anthropic reciba los datos de tu petición. Antes, revisa una causa local: en un caso reportado en GitHub (#45674), un «529 persistente sin salida» resultó ser una ANTHROPIC_API_KEY que faltaba en la aplicación del propio usuario.

529 vs 429, 500 y límites de uso: cómo distinguirlos

Confundir el 529 con un límite te lleva a esperar a un reinicio que no hace falta, o a cambiar de modelo cuando el problema es tu cuota.

Un API Error: Request rejected (429) en Claude Code a veces se debe a una ANTHROPIC_API_KEY olvidada en el entorno que desvía las peticiones a una clave de nivel bajo en lugar de tu suscripción; /status lo deja ver. Para los límites del plan en Claude Code, consulta Claude Code desde el 14 de septiembre: +25% de límite semanal, un 17% menos que ahora.

overloaded_error en la API y en los SDK de Python y TypeScript

Los SDK oficiales reintentan automáticamente los errores de conexión, 408, 409, 429 y cualquier código 500 o superior: 2 reintentos por defecto, con espera exponencial y respetando retry-after. Un 529 entra en ese grupo, así que cuando te llega ya hubo tres intentos. No existe una clase OverloadedError: en Python y TypeScript el 529 aparece como InternalServerError, con status_code 529.

Dos errores habituales:

• Envolver los reintentos del SDK en un bucle propio. Cinco intentos tuyos × tres del SDK son 15 peticiones contra un modelo que ya está saturado. Sube max_retries (maxRetries en TypeScript) o desactiva uno de los dos niveles.
• Insistir en el mismo modelo. Si el 529 sobrevive a los reintentos, otro modelo tiene más probabilidades de responder.

Un patrón mínimo en Python que registra el identificador de la petición y prueba otro modelo:

import anthropic

client = anthropic.Anthropic(max_retries=4)  # por defecto son 2
MODELOS = ["claude-opus-5-5", "claude-sonnet-5-5"]

def preguntar(mensajes):
    for modelo in MODELOS:
        try:
            return client.messages.create(
                model=modelo,
                max_tokens=1024,
                messages=mensajes,
            )
        except anthropic.InternalServerError as e:
            if e.status_code != 529:
                raise
            print(modelo, "sobrecargado; request-id:", e.response.headers.get("request-id"))
    raise RuntimeError("Todos los modelos de la lista están sobrecargados")

respuesta = preguntar([{"role": "user", "content": "Hola, Claude"}])
print(respuesta.content[0].text)

Necesita la variable ANTHROPIC_API_KEY. Los identificadores corresponden a los modelos actuales de la lista de modelos; claude-sonnet-4-6, que aparecía en muchos ejemplos de principios de 2026, ya es un modelo heredado.

Con streaming, la sobrecarga puede llegar después de un HTTP 200. La documentación de streaming muestra este evento, que «normalmente correspondería a un HTTP 529» fuera del streaming:

event: error
data: {"type": "error", "error": {"type": "overloaded_error", "message": "Overloaded"}}

Ese error no pasa por el mecanismo HTTP normal, así que tu código tiene que tratarlo en el propio flujo de eventos. Si la respuesta incluía llamadas a herramientas, comprueba qué se ejecutó antes de repetirla.

Cada respuesta lleva la cabecera request-id, con el mismo valor que el campo request_id del cuerpo de error. Guárdala siempre: es lo que pide el soporte.

Error 529 en Amazon Bedrock, Google Cloud y pasarelas propias

Cuando usas Claude a través de un proveedor de nube, la capacidad es la de ese proveedor y status.claude.com puede estar en verde mientras tú recibes errores.

• Amazon Bedrock. Según la tabla de errores de Bedrock, overloaded_error con código 529 significa que el modelo no puede procesar la petición por alta demanda o capacidad insuficiente, y AWS insiste en que es distinto de un 429 ThrottlingException (cuota de tu cuenta). ServiceUnavailable (503) también indica demanda alta. Qué hacer: reintentos con espera exponencial y variación aleatoria, respetar Retry-After, evitar reintentos sincronizados, usar inferencia entre regiones y, si persiste, abrir un caso en AWS Support con request ID, modelo, región y hora.
• Google Cloud (Vertex). Allí la saturación no llega como 529, sino como 429 con Resource exhausted, please try again later. (pago por uso) o Too many requests. Exceeded the Provisioned Throughput.. Prueba el endpoint global (CLOUD_ML_REGION=global en Claude Code), comprueba que el modelo está disponible en tu región y suaviza el tráfico.
• Pasarela propia. Si configuraste ANTHROPIC_BASE_URL, Claude Code termina el mensaje con el host de tu pasarela, por ejemplo check your inference gateway (127.0.0.1:8787). Mira primero los registros de esa pasarela: puede estar reenviando un 529 del proveedor o generando sus propios errores. Las versiones anteriores a la 2.1.143 podían señalar status.claude.com aunque el error viniera de tu pasarela; actualizar Claude Code evita esa pista falsa.

Claude sobrecargado en claude.ai: el aviso de capacidad no sale en status

En claude.ai y en las apps de Claude, la saturación se presenta con otro texto, según el centro de ayuda de Claude:

Due to unexpected capacity constraints, Claude is unable to respond to your message. Please try again soon.

Anthropic aclara que estas restricciones de capacidad no son caídas: el sistema funciona y está gestionando una demanda alta. Por eso no aparecen en status.claude.com, y es normal ver la página en verde mientras el chat te pide que lo intentes más tarde. Suelen pasar en minutos, a medida que cambia la demanda a lo largo del día.

No lo confundas con los avisos de límite (5-hour limit reached - resets [time] o You've reached your weekly limit. It resets [day] at [time]), que sí son tu cuota y solo se resuelven esperando al reinicio o con créditos de uso. La frase «no cuenta contra tu cuota» procede de la documentación de Claude Code; para el chat, el centro de ayuda no dice si un mensaje rechazado por capacidad consume límite.

¿Claude está fallando hoy? Cómo leer status.claude.com

status.claude.com separa el estado por componentes: claude.ai, Claude Console (platform.claude.com), Claude API (api.anthropic.com), Claude Code, Claude Cowork y Claude for Government. Puedes suscribirte por correo, SMS, Slack, Microsoft Teams, webhook o RSS/Atom, y consultar los datos en JSON:

• https://status.claude.com/api/v2/summary.json (estado actual)
• https://status.claude.com/api/v2/incidents.json (incidentes recientes)

Los incidentes se publican como «elevated errors» y casi nunca mencionan el 529, pero en la práctica es lo que ven los usuarios. Algunos incidentes recientes (horas en UTC):

La mayoría afectó a uno o pocos modelos, lo que respalda el consejo de cambiar de modelo. La excepción es el 29 de septiembre, cuando fallaron todos los servicios y no había alternativa más que esperar. El 24 de agosto coincidió con informes en GitHub de 529 Overloaded · Retrying in 24s · attempt 10/10 (#89156).

Preguntas frecuentes sobre el error 529 de Claude

¿El error 529 de Claude es culpa mía?

No. El 529 indica falta de capacidad en los servidores de Anthropic (o de tu proveedor de nube) para ese modelo. Tu cliente solo empeora la situación si reintenta sin pausa o con varios bucles anidados. Una excepción: si el mensaje nombra tu pasarela (check your inference gateway), revisa esa capa antes de culpar a Anthropic.

¿Cuánto dura un error 529 en Claude?

No hay una duración oficial. Los incidentes publicados en status.claude.com entre agosto y octubre de 2026 duraron desde unos 20 minutos (Opus 5.5, 6 de octubre: 12:24–12:43 UTC) hasta casi tres horas (24 de agosto: 04:50–07:36 UTC). Los avisos de capacidad del chat no aparecen allí y suelen pasar en minutos. Como Claude Code solo espera unos 160 segundos por mensaje, durante un incidente largo te conviene más cambiar de modelo que volver a enviar.

¿Un 529 cuenta para mi límite de uso de Claude?

En Claude Code, no: la documentación oficial dice que un 529 no es tu límite de uso y no cuenta contra tu cuota. Para el chat de claude.ai no hay una declaración equivalente. Si lo que ves es 5-hour limit reached o You've reached your weekly limit, eso sí es tu límite y no un 529.

¿Se cobra una petición de la API que devuelve 529?

La documentación de errores y de precios no lo dice. Una petición rechazada con 529 antes de empezar no genera salida; un error a mitad de streaming puede llegar después de que se hayan producido tokens, y ese caso tampoco está documentado. Si necesitas comprobarlo, revisa el uso en Claude Console y cruza el request-id de la petición fallida.

¿Pagar Max o Priority Tier evita el error 529?

No. Anthropic describe el 529 como un problema que afecta a todos los usuarios y no documenta prioridad por plan, así que pagar Pro o Max no te protege. Priority Tier, que se ofrecía para reducir los errores de sobrecarga, ya no se vende: los contratos existentes siguen hasta su fin y no admite los modelos actuales (Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.1 ni Mythos 5.1). Para capacidad garantizada, la página remite al equipo de ventas.