Claude Code · Solución de problemas
Error de API 429 rate limited de Claude Code: cómo solucionarlo
Un 429 significa que las solicitudes llegaron más rápido, o más a la vez, de lo que permiten los límites de tasa y concurrencia. Tiene que ver con cómo envías las solicitudes, no con tu saldo ni con tu clave.
Última comprobación
El texto del error
API Error: 429 {"type":"error","error":{"type":"rate_limit_error","message":"..."}}Qué significa
El uso de la API de pago por uso no tiene asignación de 5 horas ni semanal, pero sí tiene límites de tasa y concurrencia. Cuando una ráfaga de solicitudes los supera, las solicitudes extra reciben 429 y se pueden reintentar poco después.
| Mensaje | Qué es |
|---|---|
| API Error: 429 rate_limit_error | Límite de tasa o concurrencia en la API |
| You've hit your session limit · resets ... | Asignación del plan de Claude; Claude Code sigue en el inicio de sesión de tu plan |
| API Error: 529 overloaded_error | Capacidad del modelo, no la tasa de tus solicitudes |
Solución paso a paso
1. Reducir el paralelismo
Cierra sesiones adicionales de Claude Code y pide menos subagentes en paralelo. Los scripts y trabajos de CI que comparten la misma clave también cuentan.
2. Esperar y reintentar
Haz una pausa breve y envía el mensaje de nuevo.
3. Separar claves
Da a cada compañero o pipeline su propia clave para que un trabajo con mucha carga sea fácil de identificar en los registros de uso.
4. Revisar saldo y límites
Si el error menciona saldo o un límite de gasto, recarga o aumenta el límite de la clave.
Cómo evitarlo
- Mantén un número moderado de agentes concurrentes.
- Añade reintentos con retroceso exponencial a los scripts y a CI.
- Usa /compact y /clear para que cada turno envíe menos contexto.
¿Se cobran las solicitudes fallidas?
Las solicitudes fallidas (4xx/5xx, timeouts, conexiones interrumpidas) no se cobran; solo se factura por las solicitudes que se completan correctamente. Si un fallo en el proveedor se reintenta automáticamente y tiene éxito, se factura una vez.
¿Sigue fallando?
- 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 coste.
- Escribe 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 con soporteDocumentación
FAQ
¿Qué significa el error 429 de Claude Code?
Tus solicitudes superaron un límite de tasa o concurrencia. Ejecuta menos agentes en paralelo, espera un momento y reintenta.
¿Hay un número fijo de solicitudes por minuto?
Los límites de tasa y concurrencia se aplican a todas las cuentas y pueden cambiar. Si planeas cargas de trabajo paralelas intensas, consulta la documentación o contacta con soporte.
¿Es lo mismo un 429 que alcanzar el límite de mi plan de Claude?
No. Los límites del plan muestran mensajes como "You've hit your session limit". Un 429 rate_limit_error proviene de los límites de tasa de la API.
¿Los scripts que usan la misma clave cuentan para el límite?
Sí. Cada solicitud de la cuenta cuenta, así que un trabajo de CI con mucha carga puede causar 429 en tu sesión interactiva. Separar las claves hace que sea fácil de detectar.
¿Un saldo mayor eliminará los errores 429?
No por sí solo. El 429 tiene que ver con la tasa de solicitudes y la concurrencia, no con el saldo.
¿Me cobran por las solicitudes fallidas?
Las solicitudes fallidas (4xx/5xx, timeouts, conexiones interrumpidas) no se cobran; solo se factura por las solicitudes que se completan correctamente. Si un fallo en el proveedor se reintenta automáticamente y tiene éxito, se factura una vez.
¿Listo para probarlo?
El cobro es por token desde un saldo prepago. Se aplican límites de velocidad y concurrencia, y puedes establecer topes de gasto diarios, mensuales o totales en cada clave de API.
Relacionado
Fuentes
- Documentación de Claude Code: errores
- Documentación de Claude Code: configuración
- Documentación de la API de Anthropic: errores
Claude y Claude Code son marcas registradas de Anthropic PBC. aicodewith es una plataforma independiente y no está afiliada ni respaldada por Anthropic. Los formatos de error se citan de Claude Code y pueden cambiar. Verificado el 2026-10-10.