No borres la configuración ni pulses «reintentar» una y otra vez. Empieza por Claude Status. A las 14:28 del 14 de julio de 2026 (hora peninsular española, CEST), todos los componentes figuraban operativos; esa captura envejece y un estado verde no descarta una restricción breve de capacidad.
Después identifica dónde apareció el mensaje y quién procesó realmente la solicitud: Claude.ai, Claude Code mediante Anthropic o un proveedor de nube, la API directa de Anthropic o una pasarela. Antes de reenviar, suma los intentos automáticos del cliente, el SDK y la pasarela.
Si Claude Code conservó una respuesta parcial o pudo ejecutar una herramienta, verifica primero archivos, comandos y acciones externas. Solo repite una vez por la misma ruta cuando el trabajo sea seguro; si falla de nuevo, detente y guarda hora, error completo, modelo, proveedor y request ID.
En el primer minuto, elige dónde apareció el error
La frase «error interno del servidor de Claude» describe un síntoma, no una causa. Un aviso genérico en Claude.ai, API Error: 500 en Claude Code, una respuesta directa 500 api_error y un 500 generado por una pasarela pueden parecer iguales. Sin embargo, cada uno tiene un responsable y unas pruebas distintas.
Empieza por la fila que puedas observar de verdad:
| Dónde apareció | Estado que debes comprobar | Qué mirar antes de repetir | Primera acción segura | Cuándo parar |
|---|---|---|---|---|
| Conversación de Claude.ai | Claude Status y la sesión actual | La web no muestra un contador fiable de reintentos | Esperar un poco; recargar una vez o comparar con un chat nuevo | Si la misma cuenta y tarea vuelven a fallar, guardar hora y captura |
| Inicio de sesión en Claude.ai | Claude Status y después la sesión del navegador | No convertir intentos de acceso repetidos en la prueba | Tras revisar el estado, probar una ventana privada una vez | Antes de borrar a la vez caché, extensiones, red y datos de la cuenta |
| Claude Code | El proveedor configurado: Anthropic, Bedrock, Vertex AI, Foundry o endpoint propio | Puede haber agotado reintentos y conservado salida parcial | Leer el error y la salida, esperar cerca de un minuto y repetir el mensaje existente una vez si es seguro | Si vuelve el 500 o una herramienta pudo ejecutarse |
| API directa de Anthropic | Estado de la API y respuesta HTTP real | Reintentos del SDK, aplicación y pasarela | Guardar request-id y request_id; repetir una sola operación segura | Si el mismo 500 continúa tras el presupuesto limitado |
| Proveedor o pasarela | Estado del proveedor, registro de ruta y upstream | Pueden acumularse reintentos en varias capas | Comparar con una ruta conocida manteniendo las condiciones | Antes de cambiar a la vez proveedor, modelo, petición y timeout |
El error más común aquí es contar solo los clics manuales. Si Claude Code, el SDK, la pasarela y tu aplicación ya enviaron solicitudes, tu siguiente clic puede ser el intento número once. Averigua primero cuántas peticiones salieron realmente.
Un estado verde no demuestra que el fallo sea local
El Centro de ayuda de Claude en español distingue entre una incidencia y una restricción temporal de capacidad. La capacidad puede verse limitada durante unos minutos, afectar solo a ciertos usuarios o funciones y no aparecer como una incidencia pública.
La página verde sigue siendo útil: indica que Anthropic no está publicando una interrupción general en ese momento. Pero no certifica tu conversación antigua, tu cuenta, una región de Bedrock, un proyecto de Vertex AI, Foundry ni una pasarela de terceros. Por eso «el estado está verde, así que mi ordenador está mal» es una conclusión excesiva.
Haz una comparación controlada y cambia una sola variable:
- Una conversación antigua falla y un chat nuevo funciona: conserva la conversación y usa su contexto o estado como pista.
- Claude Code solo falla con Bedrock, Vertex AI, Foundry o una dirección personalizada: comprueba ese proveedor antes de tocar Claude.ai.
- La llamada devuelve código HTTP, cuerpo y request ID: sigue la rama de respuesta API confirmada.
- No hay estado HTTP, cuerpo ni request ID: investiga conexión, proxy, DNS, TLS, cortafuegos o timeout; aún no es un API 500 demostrado.
- Fallan a la vez Claude.ai, Claude Code y una ruta directa: puede haber un problema amplio, pero el estado y cada proveedor siguen determinando a quién corresponde investigar.
Anota la hora UTC, la variable modificada y el resultado. Una comparación rara vez prueba la causa raíz por sí sola; sirve para descartar ramas incorrectas sin destruir la evidencia original.
La interfaz muestra Claude, pero el servicio real puede ser otro
En Claude Code esta distinción es esencial. La referencia oficial de errores indica que debes revisar Anthropic, Amazon Bedrock, Google Vertex AI, Microsoft Foundry o el servicio detrás de ANTHROPIC_BASE_URL, según la configuración activa. Ver Claude en el terminal no significa que la petición vaya directamente a Anthropic.
Separar rutas elimina arreglos irrelevantes. Un fallo de Bedrock no se corrige borrando cookies de Claude.ai. Un error de mapeo en una pasarela no se resuelve cambiando el prompt. Un 500 api_error real no indica que la API key sea incorrecta ni que falte saldo. Y un Claude Status verde no confirma el proyecto o la región de un tercero.
Para una conversación normal de Claude.ai, esperar brevemente y comparar con un chat nuevo suele ser más seguro que reiniciar todo el navegador. VPN, extensiones, caché, cookies o ventana privada pertenecen a la rama de inicio de sesión o sesión web, después de comprobar estado y capacidad y siempre de uno en uno.
Si hay una pasarela, guarda ambos lados del límite. La respuesta, hora y alias de modelo que recibió tu aplicación son la parte descendente. El ID de la pasarela, número de reintentos, upstream elegido y request ID superior son la otra parte. Una comparación directa con Anthropic solo es útil si mantienes modelo, tamaño de entrada, timeout y entorno.
Aplica los tipos oficiales solo a una respuesta HTTP real
Cuando recibes una respuesta HTTP real de Anthropic API, usa la documentación oficial en español. Un 500, una sobrecarga, un límite de velocidad y un timeout no son el mismo fallo.
| HTTP | Tipo oficial | Qué demuestra | Siguiente acción más segura |
|---|---|---|---|
500 | api_error | Se produjo un error interno inesperado en Anthropic | Comprobar estado, guardar request ID y reintentar solo dentro de un presupuesto seguro |
529 | overloaded_error | La API o la ruta está temporalmente sobrecargada | Aumentar la espera, reducir paralelismo y evitar una tormenta de reintentos |
429 | rate_limit_error | La credencial o ruta activa llegó a un límite de velocidad o aceleración | Respetar la espera devuelta y revisar el límite vigente |
504 | timeout_error | El procesamiento terminó en timeout de pasarela | Revisar streaming, duración, forma de la petición e idempotencia antes de repetir |
No asignes api_error a un mensaje genérico de Claude.ai sin cuerpo HTTP. Claude Code puede mostrar API Error: 500, pero su diagnóstico también incluye el proveedor configurado, los reintentos automáticos, la sesión y cualquier salida parcial.
Tampoco conviertas 500 en un problema de autenticación por intuición. 401, 402, 403, 413 y 429 tienen señales propias. Haber cambiado hace poco la key o el prompt no demuestra que ese cambio causara el 500.
Suma los reintentos automáticos antes del manual
Los SDK oficiales de Anthropic reintentan por defecto dos veces los fallos transitorios, con backoff exponencial. Un cliente HTTP básico quizá no reintente, pero tu aplicación, cola o pasarela puede añadir su propia política. Claude Code también reintenta automáticamente muchos fallos temporales; la referencia actual describe hasta 10 intentos antes de mostrar el error final.
Antes de reenviar a mano:
- Revisa registros de Claude Code, SDK, pasarela y aplicación y suma las solicitudes enviadas.
- Decide si repetir es seguro. Una lectura suele ser sencilla; escritura, cobro, aviso, despliegue o herramienta externa necesitan idempotencia y comprobación del resultado.
- Confirma que no sigue activo un reintento automático. Si la operación es segura, envíala una vez por la misma ruta.
- Si vuelve a fallar, detente y conserva las pruebas.
«La misma ruta» significa mantener modelo, endpoint, propietario de la credencial, cuerpo, clase de timeout y entorno principal. Si cambias modelo, pasarela, prompt y configuración a la vez, un éxito no explicará qué variable importaba.
Además, un error del servidor no garantiza que una acción externa no ocurriera. Un comando, archivo, mensaje o despliegue pudo completarse y fallar solo la respuesta final. Comprueba el estado del trabajo, el sistema de destino o la clave de idempotencia antes de repetir.
En Claude Code, revisa primero la salida parcial y las herramientas
Claude Code no solo genera texto: también puede ejecutar herramientas. Ante un API Error: 500 final, la recomendación actual es esperar alrededor de un minuto y repetir una vez el mensaje existente si la tarea es segura. Si el fallo continúa, envía los detalles mediante /feedback.
Desde Claude Code v2.1.199, cuando el error del servidor ocurre después de comenzar el streaming, la salida parcial se conserva en lugar de repetir automáticamente todo el turno. Así se reduce el riesgo de duplicar llamadas a herramientas. Comprueba:
- si se propuso o envió una herramienta;
- si se ejecutó un comando, se editó un archivo, se desplegó o se envió un mensaje;
- si solo falta el final del texto o también falta la acción;
- si puedes usar
continuepara seguir desde el trabajo conservado; - qué proveedor estaba activo cuando apareció el error.
No todos los fallos dejan salida parcial. No des por hecho ni que la acción ocurrió ni que no ocurrió. Solo repite cuando el registro muestra que la herramienta no se ejecutó, los reintentos terminaron y la tarea es segura.
Si has confirmado que la rama es Claude Code, continúa con la guía específica de API Error 500 en Claude Code. Allí se profundiza en proveedor, mensaje existente y entrega del informe sin duplicar todo el recorrido aquí.
En la API directa, conserva los dos request ID
Una respuesta 500 directa de Anthropic API ofrece más trazabilidad que un mensaje web genérico. Guarda el estado HTTP, error.type, message, request_id del cuerpo, request-id de la cabecera, modelo exacto, cliente y versión, e intentos automáticos y manuales.
Un registro mínimo puede ser:
texttime_utc: 2026-07-14T12:28:58Z surface: direct Anthropic API http_status: 500 error_type: api_error request_id_body: req_... request_id_header: req_... model: <ID exacto del modelo> sdk_and_version: <cliente y versión> automatic_retries: <cantidad observada> manual_retries: 0 o 1 repeat_safe: yes / no / unknown
No envíes la API key, el prompt privado completo, datos de clientes ni todo el entorno. Soporte necesita identificadores rastreables, una reproducción mínima y anonimizada, y una frase que explique el impacto.
Cuando confirmes una respuesta directa 500 api_error, sigue con la guía detallada del error 500 de Claude API. Trata backoff de producción, presupuesto, circuit breaker y escalada de la API directa.
Una pasarela necesita pruebas descendentes y ascendentes
Una pasarela puede fallar antes de llamar a Anthropic, durante la llamada o al procesar la respuesta. El 500 visible puede ser suyo, un 500 de Anthropic reenviado, un timeout convertido en 500 o una respuesta de capacidad propia. Por tanto, quien publica el estado y quien controla el reintento pueden ser distintos.
| Límite | Prueba descendente | Prueba ascendente |
|---|---|---|
| Aplicación ↔ pasarela | estado, cuerpo, hora, ruta o alias de modelo | ID de pasarela, reintentos, upstream elegido |
| Pasarela ↔ Anthropic/nube | estado del proveedor, región y registro de ruta | estado upstream, tipo, request ID, proyecto o región |
| SDK ↔ pasarela | excepción del SDK y reintentos | acceso de pasarela y respuesta final |
Después pregunta: ¿quién puede localizar el salto fallido con esos identificadores? Anthropic atiende una solicitud directa rastreable; Bedrock, Vertex AI o Foundry corresponden a su nube; el mapeo, proxy y selección de upstream corresponden al operador de la pasarela.
No envíes la misma captura genérica a tres equipos para que adivinen. Tampoco cambies varias variables en una comparación. La prueba solo vale cuando las condiciones son comparables.
Prepara un paquete que soporte pueda rastrear
Si la misma ruta falla tras el intento seguro, reúne:
- hora UTC y zona horaria local;
- Claude.ai, Claude Code, API directa o pasarela;
- texto completo, estado HTTP y tipo oficial cuando existan de verdad;
- proveedor activo y propietario del endpoint personalizado, sin secretos;
- modelo exacto y versiones de navegador, SDK o Claude Code;
- número de intentos automáticos y manuales;
- salida parcial y posibilidad de ejecución de herramienta;
request-id,request_id, ID de ruta o ambos lados de la traza;- reproducción mínima anonimizada;
- resultado del estado público en el momento del fallo;
- impacto en una frase.
La lista también define la parada. Si hay una incidencia activa, sigue la actualización oficial. Si el mismo recorrido falla tras un único intento seguro, no envíes más. Si Claude Code agotó reintentos o una herramienta pudo actuar, verifica el resultado antes de escalar.
Preguntas frecuentes
¿Claude está caído ahora mismo?
A las 14:28 del 14 de julio de 2026 (CEST), Claude Status mostraba todos los componentes operativos y ninguna incidencia pública ese día. Es una captura con hora, no una respuesta permanente. Vuelve a abrir la página en directo y revisa capacidad y proveedor.
¿Por qué aparece el error si el estado está verde?
Una restricción breve de capacidad puede no publicarse como incidencia. El estado general tampoco garantiza una región de Bedrock, un proyecto de Vertex AI o Foundry, una pasarela, modelo, cuenta o conversación concreta.
¿Un 500 significa que la API key o el prompt son incorrectos?
No por sí solo. Un 500 api_error confirmado es un fallo interno inesperado, no un diagnóstico de autenticación, facturación o validación. Cambia de rama solo cuando aparezca el código específico correspondiente.
¿Debo borrar primero caché y cookies?
No como paso universal. Es una opción para inicio de sesión o sesión web de Claude.ai después de comprobar estado y capacidad. No corrige un 500 de Claude Code, API directa o pasarela.
¿Cuántas veces debo reintentar?
Cuenta antes los intentos automáticos. Cuando hayan terminado y el trabajo sea seguro, permite un reintento manual por la misma ruta. Si falla de nuevo, detente.
¿Qué hago con la salida parcial de Claude Code?
Léela y comprueba herramientas y sistemas externos. Usa continue si puedes seguir con seguridad desde lo conservado; no reenvíes la tarea original sin confirmar los efectos.
¿A quién envío la incidencia?
A quien pueda rastrear el salto fallido: Anthropic para un request ID directo, el proveedor de nube para su ruta o el operador de la pasarela para proxy y upstream. Si hay intermediario, incluye los identificadores de ambos lados.
La regla que conviene recordar
Un error interno del servidor en Claude es primero una decisión de recorrido, no una lista de arreglos. Comprueba el estado en directo sin olvidar la capacidad temporal, identifica la interfaz y el proveedor real, suma reintentos y protege la salida parcial. Haz como máximo un reintento manual seguro y entrega pruebas rastreables al responsable adecuado.