Inicio › Claude Code › Errores › Error de la API 500
Descripción generalInstalaciónreferencia de la CLIPrecios y límitesAgent SDKHabilidades y pluginsGitHubWeb, escritorio e IDEModelosErrores¿Código abierto?TutorialPara estudiantesAutomatización de QAComparación con CursorComparación con Codex y OpenCodeSubagentesHooksMCPEcosistemaVS CodeOpenRouterLímites de solicitudesGuía en chino
Última actualización: 11 de octubre de 2026

Claude Code «Error de la API: 500»: qué significa y qué lo soluciona realmente

API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}} indica que la parte de la API correspondiente al modelo no consigue responder. Es el error más notificado en la historia de Claude Code: una búsqueda de «Error de la API: 500» en el registro de incidencias de anthropics/claude-code devuelve 881 incidencias, y siguen registrándose nuevas cada semana. Casi nunca es culpa tuya; casi siempre se puede solucionar en menos de un minuto.

TLDR

  • 500 = la API ha fallado internamente. Tu clave, tu prompt y tu configuración están bien.
  • Consulta primero status.claude.com: durante las incidencias, cientos de personas sufren el mismo error a la vez.
  • Reanuda con claude -c; si se repite, /model a otro nivel (los errores 500 suelen ser específicos de un modelo).
  • Un 500 justo cuando el contexto alcanza el 0% significa que la compactación ha fallado: /compact o /clear, y después continúa.

Los mensajes exactos

API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}}
API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"},"request_id":null}
[Bug] Anthropic API Error: 500 Internal Server Error

Los tres corresponden al mismo fallo. Los dos primeros son los que muestra la CLI; el tercero es el título de los informes de errores generados automáticamente que Claude Code envía mediante /bug, por eso el registro de incidencias contiene cientos de informes idénticos; los más recientes de este grupo se registraron el 16 de septiembre y 22 de septiembre de 2026, y el último informa de errores 500 y 529 juntos.

Por qué ocurre

  • Incidencia del proveedor. Es, con mucha diferencia, la causa más habitual. Cuando Anthropic sufre una interrupción parcial, todos los usuarios de un modelo ven errores 500 al mismo tiempo; a la oleada de enero de 2026 en #9066 el personal de Anthropic respondió con un único enlace: la página de estado.
  • Un modelo funciona peor; los demás funcionan bien. Los errores 500 suelen afectar a un modelo concreto. En #3127 la solución más votada fue simplemente cambiar de Opus a Sonnet; la misma sesión funcionó después.
  • Contexto agotado, compactación fallida. El informe original #3127 encontró el 500 «cuando el contexto restante es exactamente del 0% y Claude Code no ha podido compactarlo automáticamente». Una solicitud demasiado grande puede manifestarse como un 500 en lugar del más claro Prompt is too long 400.
  • Una estructura de solicitud específica que el backend no puede procesar. Menos frecuente; #91801 se reprodujeron errores 500 asociados a determinados prefijos de los prompts. Si un mensaje provoca siempre un error 500 y los demás no, modifica ese mensaje.

Soluciones, en el orden en que conviene probarlas

  • 1. Consulta status.claude.com. Si hay una incidencia, nada de lo que hagas de tu lado servirá: espera a que se resuelva.
  • 2. Reanuda, no reinicies: claude -c continúa la última sesión; se reintenta el turno que quedó a medias.
  • 3. Cambia de nivel de modelo para la tarea actual: /model → Sonnet si estabas usando Opus/Fable, o a la inversa. La capacidad y los fallos son específicos de cada modelo.
  • 4. Si el indicador de contexto estaba cerca del 0%: /compact (o /clear y vuelve a dar las instrucciones), luego continúa. Cambiar a una (1M) variante del modelo también funciona.
  • 5. Actualiza: claude update. Con el tiempo se han corregido en el cliente varios errores relacionados con 500.
  • 6. ¿Sigue fallando con un mensaje específico? Reformúlalo o divídelo: un 500 causado por la estructura de la solicitud es determinista.
claude -c              # resume the session
/model claude-sonnet-5 # inside the session: another tier
/compact               # if the context was exhausted
claude update          # latest CLI

500 frente a 529 frente a 429

  • 500 — el servidor falló. Reintenta, cambia de modelo y consulta el estado.
  • 529 — el servidor está operativo, pero ha alcanzado su capacidad máxima (overloaded_error). Consulta la guía sobre sobrecarga.
  • 429 — *tú* has superado un límite. Consulta límites de solicitudes.
  • 400 — se rechazó la solicitud en sí. Consulta Error de API 400.

Por qué las pasarelas reciben menos errores de este tipo

Un 500 de una cuenta del proveedor solo constituye un punto único de fallo si tienes una sola cuenta de ese proveedor. Esta pasarela agrupa varias y redirige la solicitud a otra cuando una devuelve 500 o 529, por lo que la mayoría de los errores 500 transitorios nunca llegan a tu terminal. Una incidencia real que afecte a todo el proveedor sí llega: nadie puede evitar que el modelo esté caído mediante el enrutamiento. Configura Claude Code para que use la pasarela con ANTHROPIC_BASE_URL=https://aiprimetech.io y una clave de la pasarela.

¿Te has cansado de lidiar con este error?

Ejecuta Claude Code a través del gateway de AI Prime Tech: los mismos modelos Claude en las cuentas de origen propias del gateway, dos variables de entorno para cambiar, y las cuentas nuevas reciben $5 de crédito gratuito para la API con el código FIXIT — sin tarjeta.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Crea una cuenta con el código FIXIT

Preguntas frecuentes

¿Qué significa el error de API 500 de Claude Code?

La API de Claude sufrió un fallo interno al responder ({"type":"api_error","message":"Internal server error"}). Es un error del servidor, no un problema con tu clave o configuración.

¿Cómo soluciono el error de API: 500 en Claude Code?

Consulta status.claude.com, reanuda con claude -c, cambia de nivel de modelo con /model y usa /compact si el contexto estaba casi lleno. Actualiza con claude update si el problema persiste.

¿Por qué sigo recibiendo errores 500 de Claude?

Normalmente se debe a una incidencia en curso del proveedor o a un modelo con el servicio degradado. Si solo un mensaje lo provoca siempre, el problema es la propia solicitud: reformúlala o divídela.

¿Claude está caído cuando recibo el error 500?

A menudo, sí: al menos uno de los modelos lo está. Tanto la página de estado como el registro de incidencias de GitHub muestran actividad en cuestión de minutos durante una incidencia.

Ejecuta Claude Code con la pasarela

Los mismos modelos, dos variables de entorno y créditos por 7.69231× su valor nominal, o un plan ilimitado de tarifa plana. Cuentas nuevas: $5 de crédito gratuito para la API con el código FIXIT.

Obtener una clave de API Ver planes ilimitados

AI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.

Más guías de Claude Code

Errores de Claude Code y cómo solucionarlosError «Sobrecargado» de Claude (error de la API 529): qué significa y qué hacerError de la API de Claude Code 400: prompt demasiado largo, concurrencia en el uso de herramientas y los demásErrores OAuth de Claude Code: se ha superado el tiempo de espera de 15000ms y código de estado 500«El proceso de Claude Code terminó con el código 1»: cómo encontrar el error real y solucionarloClaude «El prompt es demasiado largo», «La entrada es demasiado larga para el modelo solicitado» y «Se ha alcanzado el límite de contexto»: qué llena la ventana y cómo recuperar espacioSe ha alcanzado el límite de uso de Claude: límites de sesión, semanales y de Opus, «límites de uso de la API especificados», «el saldo de créditos es demasiado bajo» y qué hacerClaude Code 401 y 403: credenciales de autenticación no válidas, clave API no válida, «No has iniciado sesión», host_not_allowedErrores de conexión de Claude Code: ECONNRESET, conexión perdida durante la respuesta, «Esperando respuesta de la API», «No se puede conectar con la API», errores de certificados SSLClaude Code se bloquea, se queda atascado o deja de responder: cómo averiguar dónde se ha atascado y salir del bloqueoClaude.ai no funciona: «Algo ha salido mal», restricciones de capacidad, «Se ha alcanzado el límite de 5 horas», «Error al iniciar sesión» y los demás