Lógica de Reintentos
Claude Code implementa backoff exponencial con hasta 10 reintentos. Los distintos códigos de error tienen estrategias de reintento diferentes, y el modo desatendido tiene un manejo especial para tareas de larga duración.
10 max reintentos (por defecto) 500ms retraso base de backoff 5min retraso máximo de backoff 6h cap modo desatendido
Flujo de reintentos
1
La llamada a la API falla
Se recibe un error de la API de Anthropic. 2
Comprobar código de error
Los distintos códigos tienen presupuestos de reintento y retrasos diferentes. 3
Calcular backoff 500ms a 5min
Backoff exponencial: base de 500ms, se duplica en cada intento, con tope en 5 minutos. 4
Esperar y reintentar
Esperar el retraso calculado y luego reintentar la petición. 5
¿Se alcanzó el máximo de reintentos?
Tras 10 intentos (por defecto), se muestra el error al usuario. Comportamiento por código de error
| Error | Nombre | Max reintentos | Notas |
|---|---|---|---|
| 529 | Sobrecargado | 3 | Solo para consultas en primer plano. Las consultas en segundo plano no se reintentan con 529. |
| 429 | Límite de tasa | 10 | Usa cabeceras retry-after de la respuesta si están presentes, de lo contrario usa backoff exponencial. |
| Otros 5xx | Errores del servidor | 10 | Se aplica backoff exponencial estándar. |
Modo desatendido (interno)
Se usa internamente para tareas automatizadas de larga duración. El modo desatendido tiene un comportamiento de reintento diferente:
- · Reintentos indefinidos (sin límite máximo)
- · Heartbeat de 30 segundos mantiene el proceso vivo
- · Tope de 6 horas para evitar procesos descontrolados
- · No disponible en sesiones estándar de usuario
i El backoff es por sesión, no global
El contador de reintentos se reinicia entre llamadas a la API separadas. Si Claude hace
10 llamadas a herramientas en una sesión, cada una tiene su propio presupuesto independiente
de 10 reintentos. Una respuesta lenta de la API no consume reintentos de otras operaciones.