Guías detalladas para cada error
- Error de API: 500 (error interno del servidor) — interrupciones del servicio, fallos por modelo, compactación al 0%.
- Sobrecarga / Error de API 529 — capacidad, reintentos, ráfagas de subagentes.
- Error de API 400 — prompt demasiado largo, concurrencia en el uso de herramientas y otras solicitudes rechazadas.
- Errores de OAuth — tiempo de espera de 15000ms superado, código de estado 500 al iniciar sesión.
- El proceso terminó con el código 1 — cierres inesperados de la extensión de VS Code y la aplicación de escritorio.
- Límite de solicitudes alcanzado / 429 — los tres límites y cómo aumentarlos.
- Prompt demasiado largo / límite de contexto alcanzado — qué llena la ventana, falsas alarmas, fallos de compactación, límites de longitud de claude.ai.
- Límite de uso alcanzado — periodos de sesión, semanales y de Opus, «límites de uso de API especificados», «el saldo de créditos es demasiado bajo».
- Autenticación 401 / 403 — credenciales no válidas, clave de API no válida, «sesión no iniciada», host_not_allowed.
- Errores de conexión — ECONNRESET, «esperando la respuesta de la API», certificados, proxies, variables de reintento.
- Se queda bloqueado, atascado o sin responder — dónde se atasca, teclas de escape, errores conocidos que provocan bloqueos, memoria.
- claude.ai no funciona — «algo salió mal», restricciones de capacidad, límite de 5 horas, errores de inicio de sesión.
Error de API 500 (y 529 por sobrecarga)
Un 500 es un fallo del servicio de origen; 529 es el código explícito de Anthropic para «modelo al máximo de su capacidad». Ninguno se debe a tu prompt. Claude Code reintenta varias veces por su cuenta; si deja de intentarlo, espera un minuto y reanuda con claude -c. Cambiar de nivel con /model suele funcionar de inmediato porque la capacidad depende de cada modelo. En este gateway, si una cuenta de origen está saturada, se cambia automáticamente a otra; por eso los errores 529 son menos frecuentes aquí que al usar una sola cuenta.
Error de API 400 — solicitud incorrecta / contexto demasiado largo
En Claude Code, un 400 casi siempre significa que la conversación junto con los archivos que ha leído ya no caben en la ventana del modelo. /compact resume el historial; /clear empieza de cero; o cambia a una variante (1M) del modelo. Otros errores 400: un parámetro no compatible después de una actualización (ejecuta claude update), o una imagen o un archivo que el modelo no puede aceptar.
Error de API 429 — límite de solicitudes / tasa excedida
Se aplican tres límites: solicitudes por minuto, tokens por minuto y solicitudes simultáneas. Las sesiones de agentes alcanzan primero el límite de concurrencia: cada subagente es una solicitud paralela en streaming que ocupa una plaza hasta que termina. Reduce el paralelismo, deja transcurrir el tiempo indicado por retry-after y, para trabajar de forma continuada, solicita una mayor concurrencia para tu cuenta del gateway.
Error de OAuth: tiempo de espera de 15000ms superado
El flujo de /login no pudo conectarse al servicio de autenticación de Anthropic en 15 segundos. Es un problema de red, no de la cuenta: un proxy corporativo, una VPN que descarta la llamada de retorno o una región donde el endpoint de autenticación es lento. Reintenta una vez; si persiste, configura HTTPS_PROXY para tu red, o prescinde por completo de OAuth usando una clave de API: con ANTHROPIC_API_KEY (y ANTHROPIC_BASE_URL para un gateway), Claude Code no abre el flujo de inicio de sesión.
Error de OAuth: la solicitud falló con el código de estado 500
El servicio de autenticación respondió con un error del servidor durante el inicio de sesión o la renovación del token. No lo provoca nada de tu lado; espera unos minutos y vuelve a ejecutar /login. Si necesitas trabajar ahora, la vía con clave de API indicada arriba evita OAuth, y claude setup-token en un equipo donde el inicio de sesión funciona genera un token de larga duración que puedes trasladar al equipo donde no funciona.
Error: el proceso de Claude Code terminó con el código 1
La extensión del IDE o la aplicación de escritorio está indicando que la CLI que lanzó falló al iniciarse; el error real está un nivel más abajo. Abre una terminal y ejecuta claude directamente: verás el mensaje real, que casi siempre se debe a una versión de Node.js inferior a 18, un PATH dañado después de una instalación con npm, una instalación nativa corrupta o un settings.json con JSON no válido (una coma sobrante en un bloque de hooks es un caso clásico). claude doctor comprueba los tres primeros; un linter de JSON detecta el cuarto. Reinstalar con el instalador nativo soluciona la mayoría de los demás casos.
401 / errores de autenticación
invalid x-api-key o authentication_error significa que la clave no corresponde al endpoint. Si ANTHROPIC_BASE_URL apunta al gateway, la clave debe ser una clave del gateway; se rechazará una clave de la consola de Anthropic, y lo contrario también es cierto. /status muestra qué endpoint y qué clave están activos. Si usas /login y una clave de API al mismo tiempo, prevalece la clave. Los bucles de renovación de tokens, Not logged in tras un inicio de sesión correcto y los errores 403 de los proxies se tratan en la página de 401 / 403.
«Ningún servidor de origen disponible»
No es un error de API: es el balanceador de carga situado delante de un servicio indicando que no hay ningún backend disponible. En el endpoint oficial significa una interrupción del servicio; en un gateway significa que todo el conjunto de servidores de origen está caído o sujeto a restricciones de tráfico. Espera y reintenta; no cambies tu configuración.
Claude Code no funciona en absoluto
- Se inicia y luego se cierra sin ningún mensaje → ejecuta
claude /doctor; suele ser un problema de la versión de Node o de PATH. - Se queda bloqueado al iniciarse o durante la sesión → consulta bloqueos y sesiones atascadas y errores de conexión.
command not found→ consulta la guía de instalación.- Las herramientas fallan con errores de permisos →
/permissions, o--allowedToolsen scripts.
¿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_keyPreguntas frecuentes
¿Por qué Claude Code sigue devolviendo el error de API 500?
El backend del modelo está fallando o sobrecargado (529 es la forma explícita). Reintenta tras una pausa, cambia de nivel con /model o reanuda con claude -c. No se debe a tu configuración.
¿Cómo soluciono el error 400 de longitud de contexto en Claude Code?
Ejecuta /compact para resumir la sesión, /clear para reiniciarla o cambia a una variante del modelo con un contexto de 1M.
¿Por qué Claude Code indica que la clave API no es válida?
La clave no corresponde al endpoint de ANTHROPIC_BASE_URL. La URL de la pasarela requiere una clave de la pasarela; la URL de Anthropic requiere una clave de la consola.
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 ilimitadosAI 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.