Claude Code overloaded (529): arregla el error de capacidad rápido
Qué es realmente el error 529 Overloaded — capacidad del lado de Anthropic, no tu cuenta — más la comprobación de estado, el cambio con /model, la variable de entorno para afinar el backoff de Claude Code 2.1.296 y la diferencia entre 529, 429 y 500 — todo con capturas reales.
El 529 de un vistazo
- 529 Overloaded significa que la API de Anthropic está temporalmente a plena capacidad para todos los usuarios — la documentación oficial dice literalmente que "no es tu límite de uso y no cuenta contra tu cuota". Nunca es un baneo.
- El primer paso nunca cambia: consulta status.claude.com (o hazle un curl -I) para ver si Claude mismo está degradado — nuestra guía de estado en directo te enseña a leerla.
- Soluciones inmediatas, en orden: deja que el reintento automático de Claude Code termine, ejecuta /model y pasa a un modelo más ligero (la capacidad se lleva por modelo), baja la concurrencia de herramientas.
- Desde Claude Code 2.1.296 puedes fijar CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS para estirar el techo de backoff de los reintentos 529 en sesiones largas.
- 529 ≠ 429: un 429 es tu clave chocando con su propio rate limit (tu lado), un 529 es la capacidad llena para todo el mundo (lado de Anthropic) y un 500 es un fallo interno inesperado de la API (espera un minuto y reenvía).
How to Fix Claude API "Overloaded" Error (529 Status Code)
CanalNexustech4:32
Claude errors reference — 529, 429, 500 & retry tuning
Docscode.claude.com/docs
Los fotogramas vienen de una única grabación limpia — el banner de capacidad "currently unavailable", la comprobación curl del estado en VS Code, el selector de modelos con el modelo saturado en gris, el layout de failover 529 y el chat de soporte integrado (Nexustech, JGlrcRDtdls). Otros tres vídeos — la demo de CLI de Extreme Guides (_oEU-6xbcWs, comandos que no existen en Claude Code), el artículo leído en pantalla por Izoate (fHlvs5evSi0, botones quemados y logo del canal) y el arreglo del 400 de Last Error Fixer (vHEi32hIh1I, subtítulos quemados) — aportaron datos pero quedaron descartados como fuente de fotogramas. La redacción de los errores sigue la documentación oficial de errores y el changelog de Claude Code 2.1.296 (2026-10-09). Cada paso enlaza al segundo exacto del vídeo original.
Los fotogramas del vídeo siguen siendo propiedad de sus creadores y se incrustan aquí como documentación paso a paso, con atribución y enlaces profundos.
Arregla el Claude Code overloaded (529) paso a paso
Paso 1 — Confirma que es Anthropic y no tú
- 1
Reconoce cómo se ve el estado de sobrecarga
Un 529 es presión de capacidad en todo Claude, así que las señales aparecen a la vez en todas las superficies: la app de Claude muestra un banner "currently unavailable" sobre el cuadro de texto, las llamadas directas a la API devuelven HTTP 529 con un cuerpo overloaded_error, y el spinner de Claude Code pasa a "Retrying… attempt x/y". Si solo falla tu terminal mientras la app funciona, sospecha de tu entorno local — nuestra guía de sesiones atascadas se encarga de ese camino.
La portada de la app de Claude con el banner "Claude Fable 5 is currently unavailable" — la misma presión de capacidad que un 529 reporta a tu terminal.Ver en 0:02 - 2
Consulta primero la página de estado oficial
Abre status.claude.com antes de tocar ninguna configuración — es la única fuente autorizada sobre degradaciones y caídas. Desde una terminal, curl -I https://status.anthropic.com/ lleva directo a la página de estado. Un tablero todo verde con 529 significa que la sobrecarga es de un solo modelo y las soluciones de abajo siguen valiendo; un tablero rojo significa seguir el incidente en vez de tu runbook. Nuestra guía de estado en directo explica cómo leer la página y qué secciones anticipan errores de terminal.
curl -I contra status.anthropic.com en la terminal de VS Code — la redirección 307 aterriza con su location en status.claude.com: se ve al instante si el 529 es oficial.Ver en 1:00 - 3
Descarta a los sospechosos locales
Ejecuta /status dentro de Claude Code: muestra el modelo activo, tu cuenta y la conectividad. Un 529 no te cuesta nada — la documentación es explícita en que "no cuenta contra tu cuota" — así que aquí no hay línea de uso que vigilar. Si /status muestra la cuenta correcta y una conexión sana, el error es de verdad del lado del servidor; todo lo demás (401, 403, errores de facturación) pertenece a otras guías.
Paso 2 — Soluciones inmediatas para salir del atasco
- 4
Deja que el reintento integrado termine su trabajo
Claude Code ya reintenta los fallos transitorios hasta 10 veces con backoff exponencial antes de mostrar un error, y el spinner hace la cuenta atrás ("Retrying in 8s · attempt 2/7"). En plena ráfaga de 529, lo más sensato suele ser esperar a que terminen esos intentos en lugar de machacar Enter — cada petición extra se pone en la misma cola de capacidad. Si se agotan los intentos y el error sigue, pasa al paso siguiente.
- 5
Cambia a un modelo más ligero con /model
La capacidad se lleva por modelo, y por eso la primera sugerencia de la documentación ante una sobrecarga es: "Run /model and switch to a different model to keep working." Escribe /model en el prompt de Claude Code y elige una gama más baja — los modelos de clase Sonnet y Haiku siguen respondiendo mientras el tope de gama está ahogado. El mismo selector en la app de Claude marca el modelo sobrecargado como "Currently unavailable": ves qué carriles están cerrados antes de elegir.
El selector de modelos con Fable 5 marcada como "Currently unavailable", la marca de verificación en Sonnet 4.6 y Haiku 4.5 todavía seleccionable.Ver en 1:36 - 6
Baja la concurrencia de tu lado
Las llamadas a herramientas en paralelo y los trabajos en segundo plano multiplican tu parte del apagón de capacidad. Baja CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY a 2-3, pausa otras sesiones o equipos de agentes en marcha y evita lanzar una segunda instancia de Claude Code sobre el mismo repo en pleno incidente. Menos peticiones concurrentes también significa que la cola de reintentos se vacía antes cuando vuelve la capacidad.
- 7
Si dura más que el incidente, contacta con soporte
Si los 529 siguen llegando después de que la página de estado se haya limpiado, pásaselo a Anthropic: en la app de Claude, abre el menú de perfil en la esquina inferior izquierda y elige Get help. El asistente integrado acepta un reporte de error directamente — pega el código de estado y la hora, sin buscar un correo de soporte.
El menú de perfil con Get help justo debajo de Settings y Language — la entrada para reportar un 529 terco.Ver en 2:20 - 8
Describe el 529 al asistente de soporte
En el chat de soporte, indica el código de estado, el modelo y la franja horaria: "I've received a 529 status code on claude-opus-4-8 since 14:00". El asistente asigna un ID de conversación para tus registros — consérvalo por si necesitas dar seguimiento. Soporte puede decirte si tu cuenta dio con un clúster persistente raro o si toda la gama del modelo estaba hundida para todos.
El chat de soporte con "I've received a 529 status code can you help…" escrito y un ID de conversación ya asignado.Ver en 3:06
Paso 3 — Ajusta el backoff del 529 (Claude Code 2.1.296+)
- 9
Estira el techo de backoff (2.1.296+)
Claude Code 2.1.296 añadió CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS — las palabras exactas del changelog: "Added CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS environment variable to set a longer maximum delay for the backoff when retrying an overloaded (529) request." Expórtala antes de arrancar, por ejemplo CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS=30000 para hasta 30 s entre intentos. Anthropic no ha publicado el valor por defecto interno: cualquier cifra concreta citada en otro sitio tómala como no verificada — lo que la variable garantiza es que las series largas de reintentos esperan más tiempo en vez de rendirse pronto.
- 10
Combínala con los otros mandos de reintento
Dos variables vecinas completan el ajuste: CLAUDE_CODE_MAX_RETRIES (10 por defecto) sube los intentos por fallo transitorio, y CLAUDE_CODE_RETRY_WATCHDOG=1 reintenta los 429/529 indefinidamente — la documentación lo recomienda para sesiones desatendidas, donde abortar pronto desperdicia toda la ejecución. Watchdog más un retardo máximo generoso convierte una ráfaga de 529 en una pausa en vez de un crash.
Paso 4 — Previene el siguiente atasco por capacidad
- 11
Previene el siguiente atasco: horas valle, tareas partidas, failover
Tres hábitos reducen la exposición al 529: lanza los trabajos pesados fuera de las horas punta de EE. UU. (aprox. 11:00-20:00 PT entre semana), parte los prompts monolíticos en tareas pequeñas — un worktree de git por tarea mantiene las sesiones independientes — y si llamas a la API de Messages directamente, programa un failover: captura el 529, cambia en caliente a un modelo más ligero y reintenta con backoff exponencial. Para los techos del plan, mira nuestra guía de límites de uso; el 529 en sí nunca toca tu cuota.
Un layout de failover de peticiones en crudo: el objetivo principal es claude-sonnet-4-5, y una respuesta 529 cambia en caliente a la ruta de reserva claude-haiku-4-5.Ver en 2:08
529 vs 429 vs 500: qué error es cuál
Los errores de Claude viajan con números, y el número decide de quién es el problema. La referencia oficial los separa con claridad — repasa esta lista antes de ponerte a borrar archivos de configuración.
- 1429 rate limit — tu clave, proyecto o plan chocó con un límite configurado en tu lado. Confirma la credencial activa con /status, revisa la consola de tu proveedor y baja CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY. Los estrangulamientos breves se reintentan solos; un 429 de tope de gasto del gateway no.
- 2529 Overloaded — la API está temporalmente a plena capacidad para todos los usuarios. Server-side por definición: nada de tu código, clave o configuración puede causarlo, y nunca cuenta contra tu cuota. Espera, cambia de modelo o estira el backoff.
- 3500 Internal server error — un fallo inesperado dentro de la API, normalmente temporal. Espera un minuto y reenvía el mismo mensaje; en un prompt largo, escribir "try again" retoma desde donde se quedó.
- 4"Server is temporarily limiting requests" — un estrangulamiento breve sin relación con la cuota de tu plan. Espera un poco y reintenta; ningún cambio de configuración lo levantará antes.
- 5El triaje de 60 segundos: página de estado verde + 529 significa esperar; verde + 429 significa revisar tus propios límites con /status; tablero rojo significa que puede aparecer cualquier cosa — sigue el incidente en vez de reintentar a ciegas.
- 6Cuándo preocuparse de verdad: 529 concentrados durante horas en un solo modelo con la página de estado en verde merecen un reporte a soporte con marcas de tiempo (paso 8). Todo lo demás es transitorio por diseño — la documentación oficial trata los tres códigos como "merece la pena reintentar", no como problemas de cuenta.
La misma repartición del trabajo en este sitio: nuestra guía de sesiones atascadas se ocupa de congelamientos y cuelgues, esta página de los errores de capacidad 529/500, y la guía de límites de uso de los techos tipo 429. Si tu sesión se congeló en vez de dar un error, cambia de guía — las soluciones no se solapan.