Source: https://aiprimetech.io/es/claude-code/errors/overloaded-529/

[Inicio](/es/) › [Claude Code](/es/claude-code/) › [Errores](/es/claude-code/errors/) › Sobrecarga / 529

[Descripción general](/es/claude-code/)[Instalación](/es/claude-code/install/)[referencia de la CLI](/es/claude-code/cli/)[Precios y límites](/es/claude-code/pricing/)[Agent SDK](/es/claude-code/sdk/)[Habilidades y plugins](/es/claude-code/skills/)[GitHub](/es/claude-code/github/)[Web, escritorio e IDE](/es/claude-code/web-and-desktop/)[Modelos](/es/claude-code/models/)[Errores](/es/claude-code/errors/)[¿Código abierto?](/es/claude-code/open-source/)[Tutorial](/es/claude-code/tutorial/)[Para estudiantes](/es/claude-code/for-students/)[Automatización de QA](/es/claude-code/qa-automation/)[Comparación con Cursor](/es/claude-code/vs-cursor/)[Comparación con Codex y OpenCode](/es/claude-code/vs-codex/)[Subagentes](/es/claude-code/subagents/)[Hooks](/es/claude-code/hooks/)[MCP](/es/claude-code/mcp/)[Ecosistema](/es/claude-code/ecosystem/)[VS Code](/es/claude-code/vscode/)[OpenRouter](/es/claude-code/openrouter/)[Límites de solicitudes](/es/claude-code/rate-limits/)[Guía en chino](/claude-code/zh/)

Última actualización: 11 de octubre de 2026

# Error «Sobrecargado» de Claude (error de la API 529): qué significa y qué hacer

API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}} significa que el modelo está operativo, pero no tiene capacidad para tu solicitud en este momento. No es un límite de tu cuenta: todos los usuarios de ese modelo lo ven al mismo tiempo. Las soluciones consisten en esperar de forma inteligente y evitar una avalancha de solicitudes.

## TLDR
- 529 = el modelo está saturado para todos. No es tu clave ni tu plan.
- Claude Code reintenta por sí solo («Reintentando en N segundos… intento x/10»); déjalo hacerlo.
- Cambiar de nivel con /model suele funcionar de inmediato: la capacidad depende de cada modelo.
- Lanzar muchos subagentes a la vez hace que los errores 529 se produzcan de forma correlacionada; ejecuta menos en paralelo.

## Lo que ves 

```
API Error (529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}) · Retrying in 1 seconds… (attempt 1/10)
API Error (529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}) · Retrying in 2 seconds… (attempt 3/10)
```

Esas líneas proceden de [#3572](https://github.com/anthropics/claude-code/issues/3572), la oleada de julio de 2025 que reunió 274 comentarios, muchos de personas con el plan Max de $200, y esa es la cuestión: 529 se debe a la capacidad, y una suscripción más cara no reserva capacidad alguna. El error sigue notificándose actualmente: [#91817](https://github.com/anthropics/claude-code/issues/91817) («demasiados intentos de reintento»), [#91849](https://github.com/anthropics/claude-code/issues/91849) y [#91825](https://github.com/anthropics/claude-code/issues/91825) se registraron todos el 3 de septiembre de 2026. 

## Por qué ocurre 
- Picos de demanda en un modelo. Los nuevos lanzamientos y las mañanas de los días laborables en EE. UU. son los picos habituales; el modelo insignia más reciente es el más solicitado.
- Tu propia ejecución en paralelo. [#90043](https://github.com/anthropics/claude-code/issues/90043) analizó 60 días de transcripciones y descubrió que la mayoría de los errores 529 llegaban en ráfagas: un orquestador inicia N agentes a la vez, todos acceden a la API al mismo tiempo y la mayor parte del lote falla en el mismo minuto.
- Trabajo perdido. [#89267](https://github.com/anthropics/claude-code/issues/89267) y un informe relacionado señalan que un 529 puede terminar un subagente en segundo plano en lugar de reintentar su ejecución, así que una ráfaga no solo te ralentiza: también provoca la pérdida de tareas. 

## Soluciones 
- 1. Deja que se ejecute el mecanismo de reintento integrado. La mayoría de los errores 529 desaparecen durante los 10 intentos.
- 2. Cambia de nivel: /model a Sonnet (u Opus) para el paso actual; vuelve más tarde.
- 3. Ejecuta menos subagentes a la vez y escalona los inicios de las ejecuciones en paralelo; una ráfaga de primeras solicitudes simultáneas es lo que convierte un 529 en diez.
- 4. Vuelve a ejecutar los subagentes interrumpidos de forma explícita: comprueba que cada unidad de la ejecución en paralelo haya terminado realmente.
- 5. Horas de menor demanda para los trabajos grandes: las ejecuciones autónomas largas tienen muchas menos probabilidades de alcanzar el límite de capacidad fuera del horario laboral de EE. UU. 

## 529 frente a 500 frente a 429 
- 529 Sobrecarga — capacidad, afecta a todos, temporal. Espera o cambia de modelo.
- 500 — fallo del servidor. Consulta [Error de API 500](/es/claude-code/errors/api-error-500/).
- 429 — tu propio límite (solicitudes, tokens, concurrencia). Consulta [límites de solicitudes](/es/claude-code/rate-limits/). 

## En esta pasarela 

La pasarela distribuye el tráfico entre varias cuentas del proveedor y reintenta un 529 en otra antes de desistir, de modo que una sola cuenta saturada no interrumpe tu sesión. Cuando un modelo está saturado en todas las cuentas, seguirás viendo el error: elige otro nivel con /model. La misma configuración de siempre: ANTHROPIC_BASE_URL=https://aiprimetech.io y una clave de la pasarela.

## ¿Te has cansado de lidiar con este error?

Ejecuta Claude Code a través del gateway de AI Prime Tech: los mismos modelos Claude en las cuentas de origen propias del gateway, dos variables de entorno para cambiar, y las cuentas nuevas reciben $5 de crédito gratuito para la API con el código FIXIT — sin tarjeta.

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[Crea una cuenta con el código FIXIT](/register?promo=FIXIT)

## Preguntas frecuentes

¿Qué significa el error de sobrecarga de Claude?

El modelo no tiene capacidad disponible en ese momento (HTTP 529, overloaded_error). Afecta a todos los que utilizan ese modelo y se resuelve por sí solo.¿Cómo soluciono el error 529 de la API de Claude?

Deja que Claude Code reintente, cambia de nivel de modelo con /model y ejecuta menos subagentes en paralelo. Para trabajos grandes, elige horas de menor demanda.¿Una suscripción Max evita los errores de sobrecarga?

No. 529 se debe a la capacidad, no a los límites del plan: los usuarios de Max lo notifican con la misma frecuencia que los demás.

## Ejecuta Claude Code con la pasarela

Los mismos modelos, dos variables de entorno y créditos por 7.69231× su valor nominal, o un plan ilimitado de tarifa plana. Cuentas nuevas: $5 de crédito gratuito para la API con el código FIXIT.[Obtener una clave de API](/register?promo=FIXIT) [Ver planes ilimitados](/es/plans/)

AI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.

## Más guías de Claude Code

[Errores de Claude Code y cómo solucionarlos](/es/claude-code/errors/)[Claude Code «Error de la API: 500»: qué significa y qué lo soluciona realmente](/es/claude-code/errors/api-error-500/)[Error de la API de Claude Code 400: prompt demasiado largo, concurrencia en el uso de herramientas y los demás](/es/claude-code/errors/api-error-400/)[Errores OAuth de Claude Code: se ha superado el tiempo de espera de 15000ms y código de estado 500](/es/claude-code/errors/oauth-error/)[«El proceso de Claude Code terminó con el código 1»: cómo encontrar el error real y solucionarlo](/es/claude-code/errors/process-exited-code-1/)[Claude «El prompt es demasiado largo», «La entrada es demasiado larga para el modelo solicitado» y «Se ha alcanzado el límite de contexto»: qué llena la ventana y cómo recuperar espacio](/es/claude-code/errors/prompt-too-long/)[Se ha alcanzado el límite de uso de Claude: límites de sesión, semanales y de Opus, «límites de uso de la API especificados», «el saldo de créditos es demasiado bajo» y qué hacer](/es/claude-code/errors/usage-limit-reached/)[Claude Code 401 y 403: credenciales de autenticación no válidas, clave API no válida, «No has iniciado sesión», host_not_allowed](/es/claude-code/errors/auth-401-403/)[Errores de conexión de Claude Code: ECONNRESET, conexión perdida durante la respuesta, «Esperando respuesta de la API», «No se puede conectar con la API», errores de certificados SSL](/es/claude-code/errors/connection-lost/)[Claude Code se bloquea, se queda atascado o deja de responder: cómo averiguar dónde se ha atascado y salir del bloqueo](/es/claude-code/errors/claude-code-hangs/)[Claude.ai no funciona: «Algo ha salido mal», restricciones de capacidad, «Se ha alcanzado el límite de 5 horas», «Error al iniciar sesión» y los demás](/es/claude-code/errors/claude-ai-not-working/)