Guía completa para solucionar errores en Claude: desde fallos de inicio de sesión hasta tiempos de espera en la API

Al usar Claude, tanto al iniciar sesión en la web como al llamar a la API, es posible encontrarse con varios errores. Este artículo, basado en escenarios reales, recopila los tipos de errores más comunes y sus métodos de reparación manual, para ayudarte a recuperar rápidamente la conversación o el servicio de la interfaz.

Error de inicio de sesión: «Invalid credentials» o «Account locked»

Si introduces el correo y la contraseña correctos pero sigue apareciendo «Invalid credentials», normalmente se debe a un bloqueo temporal por haber introducido la contraseña incorrecta varias veces seguidas. En ese caso, espera de 15 a 30 minutos e inténtalo de nuevo, o restablece la contraseña con «Forgot password».

Si ves «Account locked» y acabas de registrarte, es posible que la verificación del correo no se haya completado. Revisa la bandeja de entrada (incluida la de spam) del correo de verificación de Claude y haz clic en el enlace para activar la cuenta. Algunos correos empresariales bloquean los mensajes de verificación; te recomendamos usar Gmail o Outlook.

La solicitud a la API devuelve «401 Unauthorized»

Este error casi siempre se debe a que la clave de API ha caducado o no se ha enviado correctamente. Primero, asegúrate de haber añadido Authorization: Bearer TU_CLAVE_API en el encabezado de la solicitud. Si la clave se acaba de generar, puede tardar unos minutos en sincronizarse.

Además, las claves de API de Claude pueden ser a nivel de proyecto o de usuario; mezclarlas provoca el error 401. Comprueba el ámbito de permisos de tu clave y usa el endpoint correcto al llamar a la API. Por ejemplo, el endpoint chat/completions requiere permisos específicos.

Frecuente error «429 Too Many Requests»

Es el error de limitación de tasa más común. Las cuentas gratuitas suelen permitir solo 30 solicitudes por minuto; al superarlo aparece el 429. La solución es consultar primero la tabla de límites de velocidad en la documentación oficial y luego ajustar el intervalo entre solicitudes según tu plan.

Si usas un plan de pago Pro o Team, puedes implementar reintentos automáticos usando el tiempo de espera indicado en el encabezado «Retry-After». Se recomienda aplicar una estrategia de retroceso exponencial en el código: esperar 1 segundo inicialmente y duplicar la espera en cada fallo.

Interrupción de sesión: «Session expired» o «Connection reset»

En la web, la sesión se cierra automáticamente tras un periodo de inactividad por seguridad. Solo tienes que volver a iniciar sesión. Si aparece «Connection reset» con frecuencia, puede deberse a una conexión inestable o a un problema con la configuración del proxy. Prueba a desactivar la VPN o cambiar de nodo.

Otra causa habitual es un conflicto de caché del navegador. Limpia las cookies y la caché (especialmente las relacionadas con claude.ai) y reinicia el navegador. Si sigue sin funcionar, prueba con el modo incógnito o con Edge/Firefox.

Si te encuentras con alguno de estos problemas, sigue los pasos indicados; la mayoría se pueden solucionar por ti mismo. Si el error persiste, puedes hacer una captura de pantalla y enviarla al soporte oficial de Claude, incluyendo la marca de tiempo y el ID de la solicitud. Normalmente responden en un plazo de 1 día laborable.