Error 529 overloaded de la API de Claude Code: causas y soluciones

El texto del error

API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}

Qué significa

La API aceptó tu clave y tu solicitud, pero el modelo estaba sobrecargado y no pudo tomarla. Los picos son breves y están ligados a un modelo específico, por eso cambiar de modelo o esperar un minuto suele funcionar.

Solución paso a paso

1. 1. Reintentar

   Envía el mensaje de nuevo después de una breve pausa. Claude Code mantiene la conversación, así que no se pierde nada.

2. 2. Cambiar de modelo

   Ejecuta /model y elige otro modelo de Claude (por ejemplo, Sonnet en lugar de Opus) para terminar la tarea, luego vuelve a cambiarlo después.

3. 3. Cambiar de canal

   En aicodewith, cada página de modelo muestra el estado del canal. Si un canal está ocupado, elige otro para tu clave.

4. 4. Verifica tu endpoint

   Ejecuta /status y confirma que el endpoint sea api.aicodewith.ai. Un endpoint incorrecto muestra otros errores, pero vale la pena descartarlo.

   ~/.claude/settings.json

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
       "ANTHROPIC_API_KEY": "",
       "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
     }
   }

Cómo evitarlo

• •Usa Sonnet o Haiku para trabajo rutinario y reserva Opus para problemas difíciles; los picos de ocupación afectan primero a los modelos más grandes.
• •Ejecuta menos subagentes en paralelo durante las horas pico.
• •Para trabajos de CI, reintenta con retroceso exponencial en lugar de fallar el trabajo en el primer 529.

¿Se cobran las solicitudes fallidas?

Las solicitudes fallidas (4xx/5xx, timeouts, conexiones interrumpidas) no se cobran — solo se te factura por las solicitudes que se completan con éxito. Si un fallo del proveedor se reintenta automáticamente y tiene éxito, se te cobra una vez.

¿Aún falla?

• •Consulta la página del modelo en aicodewith: muestra el estado reciente de cada canal.
• •Busca la solicitud en los registros de uso de tu panel para ver su modelo, estado y costo.
• •Envía un correo a support@aicodewith.com con la hora del error, el modelo y el texto del error (nunca tu clave de API completa).

Estado y precios de modelosContactar a soporteDocumentación

FAQ