Error interno del servidor en Claude: qué hacer y cuándo reintentar

Si Claude muestra «error interno del servidor», guarda el mensaje que estabas escribiendo y cualquier resultado útil antes de recargar o volver a enviarlo. Comprueba Claude Status si usas Claude.ai o la API de Anthropic; en Claude Code, comprueba también el proveedor que aparece al final del error. Una pasarela o un servicio de nube pueden tener su propio fallo.

Después decide si necesitas repetir una solicitud que no produjo nada o continuar un trabajo ya empezado. En Claude Code, un error puede llegar después de editar archivos o completar llamadas a herramientas. Lee lo que quedó y verifica esas acciones antes de enviar la tarea entera otra vez.

Para la comprobación manual, cuando los reintentos automáticos hayan terminado y repetir sea seguro, espera y prueba una vez manteniendo las mismas condiciones. Si vuelve a fallar, guarda el error y pide ayuda. Este límite de un intento manual es una pauta práctica para el diagnóstico; las políticas automáticas del SDK y de Claude Code son diferentes.

Identifica dónde apareció el error

La frase «Internal server error» por sí sola no identifica quién falló. Selecciona el caso que corresponda a lo que realmente puedes ver:

No necesitas encontrar un código HTTP para pedir ayuda con la web. Si solo tienes un aviso y una hora, esos son los datos disponibles. En cambio, una aplicación que dice «500» debe conservar la respuesta original: su propio servidor podría haber generado ese código sin recibir un 500 de Anthropic.

Si falla Claude.ai, protege el chat antes de recargar

Comprueba si la página de estado publica una incidencia en el componente afectado. Si la hay, sigue sus actualizaciones y conserva el chat. Cambiar a la vez navegador, cuenta y conexión dificulta saber qué ocurrió.

Un estado verde tampoco garantiza que todas las peticiones funcionen. El Centro de ayuda de Claude distingue las incidencias del aviso de restricciones inesperadas de capacidad. Ese aviso puede aparecer por alta demanda y no se publica como una incidencia en la página de estado. La recomendación para ese caso es volver a intentarlo después de unos minutos.

Lee las otras señales antes de aplicar un arreglo:

• Si el aviso indica un límite de uso y una hora de restablecimiento, sigue esa ventana. Recargar no reinicia el límite.
• Si dice que el mensaje supera la longitud permitida para el chat, reduce el contenido o empieza otra conversación con el contexto necesario. Es una condición distinta del error interno.
• Si aparece un error genérico durante una conversación, guarda primero el texto. Tras esperar, una prueba con un chat nuevo y un mensaje breve puede ayudar a comprobar si el fallo también ocurre fuera de la conversación anterior. Que funcione no demuestra por sí solo que el chat antiguo esté dañado.

Considera recuperada la operación cuando Claude responde y completa la tarea que necesitabas, no solo cuando desaparece el aviso. Conserva la conversación anterior si contiene información que debes recuperar.

¿Cuándo tiene sentido revisar VPN, extensiones y cookies?

Cuando el problema aparece al iniciar sesión. La ayuda oficial propone revisar el uso de VPN, desactivar extensiones y limpiar caché y cookies para errores genéricos de acceso. Haz esas comprobaciones de una en una y guarda antes lo que no hayas enviado: borrar cookies puede obligarte a entrar de nuevo.

Ese procedimiento no arregla un 500 recibido por tu SDK ni una respuesta incompleta de Claude Code. Si el acceso funciona y el fallo solo aparece al generar una respuesta, vuelve a la comprobación de estado, capacidad y conversación.

En Claude Code, comprueba qué proveedor respondió

Claude Code puede usar Anthropic, Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry o un servicio configurado con ANTHROPIC_BASE_URL. La referencia oficial de errores de Claude Code explica que la última frase del aviso 500 cambia según el proveedor e indica dónde comprobar su estado.

Si el mensaje nombra un host personalizado, consulta al operador de esa pasarela. Puede haber fallado allí o haberse reenviado un error del proveedor. Si usas una nube, comprueba el servicio y la región que corresponden a tu configuración. El estado general de Anthropic no certifica esas rutas.

También puede responder un proxy con una página HTML. Desde Claude Code v2.1.281, el aviso muestra el código y el título de esa página; en versiones anteriores podía perderse el código o verse el marcado sin procesar. Guarda el mensaje completo y la versión instalada.

Un 5xx procedente de la API indica un fallo inesperado dentro de esa API, según la documentación. No es una razón para reemplazar claves, reinstalar Claude Code o reescribir el prompt. Si la respuesta trae otro código o un aviso específico de acceso, diagnostica ese caso concreto.

¿Reintentar o continuar? Mira cuánto llegó a completarse

Claude Code no trata igual todos los cortes durante una respuesta. La diferencia importante es si solo había terminado el razonamiento —thinking— o si ya había texto o una llamada a herramienta. Estas reglas proceden de la documentación de reintentos y respuestas incompletas:

El límite de 10 corresponde a reintentos, no a diez intentos totales garantizados para cualquier fallo. Hay reglas distintas para conexiones interrumpidas y respuestas bloqueadas. Cuando Claude Code muestra el error final, ya ha realizado los reintentos que correspondían a ese caso.

Si ves The response above may be incomplete, lee los bloques que siguen en pantalla. Claude Code descarta el último bloque interrumpido cuando termina el turno, de modo que pueden faltar las últimas frases o una llamada a herramienta sin completar. Revisa los archivos, resultados de comandos y sistemas externos pertinentes. Conservar texto no equivale a revertir todos los cambios.

En una sesión interactiva, una vez estable la conexión, responde continue para retomar desde el último bloque completo. Para recuperar la sesión y comprobar efectos con más detalle, consulta cómo reanudar Claude Code tras un 500 o 529 sin duplicar trabajo.

En una sesión no interactiva, si la respuesta principal contiene texto pero no llamadas a herramientas, Claude Code puede pedir que continúe automáticamente hasta tres veces. Este comportamiento está documentado desde v2.1.246; no presupongas que cada interrupción exige un envío manual.

Si no hay trabajo parcial ni efectos pendientes de comprobar y el error final es 500, la referencia oficial aconseja esperar aproximadamente un minuto y enviar de nuevo el mensaje. El original sigue en la conversación: puedes escribir try again sin pegarlo entero. Si persiste sin una incidencia publicada, usa /feedback o la opción de informar del error disponible en tu entorno.

Si tu aplicación devuelve HTTP 500, guarda el tipo de error

En la API directa de Anthropic, 500 api_error significa que hubo un error interno inesperado. Para una respuesta HTTP real, la referencia oficial de errores en español permite distinguir estas situaciones:

Un 429 por el tope mensual de gasto del nivel de uso no incluye retry-after y sigue fallando hasta que se restablece el acceso. Por tanto, no todos los 429 se resuelven esperando unos segundos. Tampoco debes aplicar esta tabla como diagnóstico de una pasarela que transforma los códigos.

Los SDK oficiales reintentan fallos transitorios dos veces por defecto, con retroceso exponencial, y respetan retry-after cuando existe. Puedes configurar ese comportamiento con max_retries. Si tu aplicación o pasarela también reintenta, registra sus intentos: añadir un bucle externo puede multiplicar solicitudes sin que el usuario lo vea.

Para una integración que necesita colas, deduplicación y límites de tiempo, sigue la guía de manejo del error 500 en Claude API. Si el código confirmado es 529, la guía de sobrecarga de Claude API desarrolla la reducción de presión y los reintentos limitados.

HTTP 200 no garantiza que el streaming termine

En una respuesta SSE, el error puede llegar después de recibir HTTP 200. Comprueba los eventos y si existe una respuesta final completa; no marques una tarea como exitosa solo por la cabecera inicial. Del mismo modo, un fallo de conexión sin respuesta HTTP no demuestra un 500 api_error.

Antes de repetir una operación que escribe, envía mensajes o ejecuta herramientas, verifica sus efectos en el sistema de destino. El error puede afectar a la entrega del resultado aunque parte del trabajo ya se haya realizado. Usa la deduplicación o las claves de idempotencia de tu aplicación cuando sean necesarias.

Cuándo parar y qué enviar a soporte

Detén la prueba manual si vuelve a fallar tras el intento seguro, hay una incidencia activa o no puedes confirmar si una acción externa ya ocurrió. Conserva las condiciones originales: modelo, endpoint, petición y entorno. Cambiar varias cosas a la vez puede recuperar el servicio, pero dificulta averiguar cuál influyó.

Prepara un informe ajustado a los datos que tienes:

• Dónde apareció: Claude.ai, Claude Code o tu aplicación.
• Hora del fallo y zona horaria; añade UTC si puedes.
• Texto completo del error, código HTTP y error.type cuando estén disponibles.
• Proveedor, modelo y versión del cliente utilizados.
• Reintentos automáticos observados y reenvíos manuales.
• Qué respuesta o acciones llegaron a completarse.
• ID de solicitud o identificador de la pasarela.
• Una reproducción mínima sin información privada y una frase sobre el impacto.

En la API directa, la cabecera request-id y el campo request_id del cuerpo de error contienen el mismo identificador, no dos solicitudes diferentes. Los SDK de Python y TypeScript exponen _request_id en los objetos de respuesta. Esos nombres y su relación están explicados en la documentación de ID de solicitud.

Si hay una pasarela, pide también el estado y el identificador que recibió del proveedor: el ID de tu aplicación por sí solo puede no permitir a Anthropic localizar la llamada. Envía el informe al operador que pueda consultar esos registros. Para Claude.ai, usa el soporte de Claude; para Claude Code, el mecanismo de informe indicado en el error; para una integración de nube, el soporte de esa configuración.

No incluyas claves API, cookies, prompts privados completos ni volcados de todo el entorno. En la web, una captura del aviso y la hora pueden ser suficientes para iniciar el caso; no inventes un ID que la interfaz no te mostró.

Preguntas frecuentes

¿Claude está caído ahora mismo?

Compruébalo en Claude Status en el momento del fallo y revisa el componente afectado. Un estado guardado de otro día no responde a esta pregunta. Si Claude Code usa una nube o pasarela, consulta también el estado del proveedor que nombra el mensaje.

¿Por qué aparece el error si todo está en verde?

El estado general no confirma cada solicitud. Además, el aviso específico de capacidad de Claude.ai puede aparecer sin una incidencia publicada, según el Centro de ayuda. En una pasarela, el fallo también puede estar fuera del servicio mostrado por Claude Status.

¿Tengo que cambiar la API key o pagar otro plan?

Un 500 api_error confirmado en la API directa no demuestra un problema de clave ni de facturación. La referencia de la API distingue los errores de autenticación, pago, permisos y límites. Actúa sobre esas condiciones cuando el mensaje las identifique; pagar más no es la solución documentada para un 500.

¿Debo pulsar «reintentar» si ya veo parte de la respuesta?

En Claude Code, comprueba primero qué bloques y herramientas terminaron. Si hubo texto o herramientas, continúa desde el trabajo conservado cuando sea seguro. Si solo terminó el razonamiento y no empezó texto ni herramienta, puede haber reintentos automáticos específicos: desde v2.1.284, hasta dos para un error de servidor o sobrecarga en ese punto, según la referencia de Code.

¿Cuánto tardará en solucionarse?

No hay un plazo universal. La documentación propone una espera breve para 500 y unos minutos para capacidad, pero eso no garantiza recuperación. Si la prueba segura vuelve a fallar, conserva los detalles y sigue el estado o el informe de soporte en lugar de encadenar reenvíos.