Últimamente he estado usando la API de Claude para un proyecto y, al final, todo tipo de errores me tenían con dolor de cabeza. Tras pelearme varios días, reuní los problemas con los que me topé; espero que ayude a otros que estén igual de frustrados.
Error 401 Unauthorized
Este error es el más común; en el 90% de los casos es un problema de la API Key. Revisa si copiaste la Key completa, especialmente si falta el prefijo sk-ant- del inicio. Además, si la Key ha caducado o fue revocada, también aparecerá este error; basta con generar una nueva en el panel de Anthropic.
Error 429 Rate Limit Exceeded
Estás haciendo demasiadas solicitudes y te han aplicado limitación de tasa. Las cuentas gratuitas solo pueden hacer 60 solicitudes por minuto; las cuentas de pago tienen un límite más alto. Soluciones:
- Añade un retraso en el código, por ejemplo, 1 segundo entre cada solicitud
- Usa una estrategia de retroceso exponencial para gestionar los reintentos
- Mejora el plan de la cuenta para aumentar el límite
Error 529 Overloaded
Los servidores de Claude están sobrecargados; en este caso basta con esperar unos minutos y volver a intentarlo. Si ocurre con frecuencia, considera usarlo en horas valle, evitando las horas pico del huso horario de Norteamérica.


