Al usar Claude, ya sea desde la web o mediante la API, pueden aparecer diversos mensajes de error. Esta guía enumera los códigos de error más habituales y ofrece pasos concretos para resolverlos, ayudándote a recuperar el servicio rápidamente.
Errores de conexión de red y solicitud
Mensaje de error: “Connection error” o “Error de red”.
Causa: Red local inestable, problemas de resolución DNS o fluctuaciones temporales del servidor de Claude.
Solución: Verifica primero la conexión de red, prueba cambiando de Wi‑Fi o usando datos móviles. Si aún no accedes, borra la caché del navegador o cambia de navegador. Para usuarios de API, confirma que el endpoint de la solicitud sea correcto (ej. https://api.anthropic.com) y que el firewall no bloquee el puerto 443.
Código de error 400 Bad Request: Normalmente se debe a un formato incorrecto en los parámetros de la solicitud. Revisa cuidadosamente la estructura JSON de la llamada a la API, asegurándote de que los campos obligatorios (como model y max_tokens) sean correctos y que los valores estén dentro del rango permitido.
Límites de velocidad y exceso de tokens
Código de error 429 Too Many Requests: Indica que has enviado demasiadas solicitudes en un corto período, activando el límite de velocidad.
Solución: Reduce la frecuencia de las solicitudes; se recomienda agregar al menos 1 segundo de retardo entre llamadas a la API. Usar Claude Pro o una cuenta de equipo puede otorgar cuotas de solicitud más altas. Si es en la web, espera unos minutos antes de continuar la conversación.
Mensaje de error: “Context length exceeded” o límite de tokens excedido.
Causa: El historial de la conversación o el texto de entrada es demasiado largo, superando la ventana de contexto del modelo (por ejemplo, Claude 3.5 Sonnet soporta 200K tokens).
Solución: Acorta el contenido de entrada y elimina historial innecesario. Al llamar al endpoint /messages, puedes controlar la longitud de salida mediante el parámetro max_tokens, o usar la función de “resumir historial” de Claude para comprimir el contexto.
Problemas de verificación de cuenta y permisos
Código de error 403 Forbidden: Generalmente por una clave API inválida, expirada o con permisos insuficientes. Ve a la consola de Anthropic para regenerar la clave API y asegúrate de agregarla correctamente en el campo x-api-key del encabezado de la solicitud. En la web, prueba cerrando sesión y volviendo a iniciarla.
Mensaje de error: “Your account has been locked” o “Se requiere verificación”.
Causa: Múltiples intentos fallidos de contraseña en poco tiempo, inicio de sesión desde una ubicación diferente o activación de políticas de seguridad.
Solución: Revisa el correo electrónico registrado para encontrar el mensaje de desbloqueo y sigue las instrucciones para restablecer la contraseña. Si no recibes el correo, contacta al soporte de Anthropic. Se recomienda activar la verificación en dos pasos (2FA) para mejorar la seguridad de la cuenta.
Código de error 500 Internal Server Error: Es un fallo temporal del servidor; normalmente no requiere acción del usuario. Espera unos minutos y vuelve a intentarlo. Si persiste, consulta la página de estado de Anthropic para confirmar si hay mantenimiento.
