Source: https://aiprimetech.io/es/claude-code/errors/ [Inicio](/es/) › [Claude Code](/es/claude-code/) › Errores [Descripción general](/es/claude-code/)[Instalación](/es/claude-code/install/)[referencia de la CLI](/es/claude-code/cli/)[Precios y límites](/es/claude-code/pricing/)[Agent SDK](/es/claude-code/sdk/)[Habilidades y plugins](/es/claude-code/skills/)[GitHub](/es/claude-code/github/)[Web, escritorio e IDE](/es/claude-code/web-and-desktop/)[Modelos](/es/claude-code/models/)[Errores](/es/claude-code/errors/)[¿Código abierto?](/es/claude-code/open-source/)[Tutorial](/es/claude-code/tutorial/)[Para estudiantes](/es/claude-code/for-students/)[Automatización de QA](/es/claude-code/qa-automation/)[Comparación con Cursor](/es/claude-code/vs-cursor/)[Comparación con Codex y OpenCode](/es/claude-code/vs-codex/)[Subagentes](/es/claude-code/subagents/)[Hooks](/es/claude-code/hooks/)[MCP](/es/claude-code/mcp/)[Ecosistema](/es/claude-code/ecosystem/)[VS Code](/es/claude-code/vscode/)[OpenRouter](/es/claude-code/openrouter/)[Límites de solicitudes](/es/claude-code/rate-limits/)[Guía en chino](/claude-code/zh/) Última actualización: 11 de octubre de 2026 # Errores de Claude Code y cómo solucionarlos Claude Code muestra los errores de API con el estado HTTP en el mensaje, así que el número te da gran parte de la información. Aquí se explica qué significa cada uno en el contexto de una sesión de agente y qué solución funciona. ## TLDR - 500 / 529 — el servicio del modelo falla o está saturado; reintenta con esperas progresivas o cambia de modelo; no hay nada que corregir en tu configuración. - 400 — normalmente, el contexto es demasiado largo para el modelo; usa /compact o /clear, o cambia a una variante con un contexto de 1M. - 429 — límite de solicitudes; los flujos paralelos de Claude Code alcanzan primero el límite de concurrencia. - 401 — clave incorrecta para el endpoint; una clave de la consola con una URL de gateway, o viceversa. - Límite de uso / límite semanal — es un periodo de la suscripción, no un error de API; se restablece por sí solo, y la vía de la API no tiene ese periodo. ## Guías detalladas para cada error - [Error de API: 500 (error interno del servidor)](/es/claude-code/errors/api-error-500/) — interrupciones del servicio, fallos por modelo, compactación al 0%. - [Sobrecarga / Error de API 529](/es/claude-code/errors/overloaded-529/) — capacidad, reintentos, ráfagas de subagentes. - [Error de API 400](/es/claude-code/errors/api-error-400/) — prompt demasiado largo, concurrencia en el uso de herramientas y otras solicitudes rechazadas. - [Errores de OAuth](/es/claude-code/errors/oauth-error/) — tiempo de espera de 15000ms superado, código de estado 500 al iniciar sesión. - [El proceso terminó con el código 1](/es/claude-code/errors/process-exited-code-1/) — cierres inesperados de la extensión de VS Code y la aplicación de escritorio. - [Límite de solicitudes alcanzado / 429](/es/claude-code/rate-limits/) — los tres límites y cómo aumentarlos. - [Prompt demasiado largo / límite de contexto alcanzado](/es/claude-code/errors/prompt-too-long/) — qué llena la ventana, falsas alarmas, fallos de compactación, límites de longitud de claude.ai. - [Límite de uso alcanzado](/es/claude-code/errors/usage-limit-reached/) — 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](/es/claude-code/errors/auth-401-403/) — credenciales no válidas, clave de API no válida, «sesión no iniciada», host_not_allowed. - [Errores de conexión](/es/claude-code/errors/connection-lost/) — ECONNRESET, «esperando la respuesta de la API», certificados, proxies, variables de reintento. - [Se queda bloqueado, atascado o sin responder](/es/claude-code/errors/claude-code-hangs/) — dónde se atasca, teclas de escape, errores conocidos que provocan bloqueos, memoria. - [claude.ai no funciona](/es/claude-code/errors/claude-ai-not-working/) — «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](/es/claude-code/errors/auth-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](/es/claude-code/errors/claude-code-hangs/) y [errores de conexión](/es/claude-code/errors/connection-lost/). - command not found → consulta la guía de instalación. - Las herramientas fallan con errores de permisos → /permissions, o --allowedTools en 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_key ``` [Crea una cuenta con el código FIXIT](/register?promo=FIXIT) ## Preguntas 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](/register?promo=FIXIT) [Ver planes ilimitados](/es/plans/) 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 [Claude Code: la guía completa](/es/claude-code/)[Cómo instalar Claude Code](/es/claude-code/install/)[Documentación de la CLI de Claude Code: comandos y opciones](/es/claude-code/cli/)[Precios y límites de Claude Code, explicados](/es/claude-code/pricing/)[El SDK de Claude Code, ahora Claude Agent SDK](/es/claude-code/sdk/)[Habilidades y plugins de Claude Code](/es/claude-code/skills/)[Claude Code en GitHub: la App, la Action y @claude](/es/claude-code/github/)[¿Claude Code tiene una interfaz web? Explicación de las versiones web, de escritorio y para IDE](/es/claude-code/web-and-desktop/)[Qué modelo utiliza Claude Code y cómo cambiarlo](/es/claude-code/models/)[¿Claude Code es de código abierto?](/es/claude-code/open-source/)[Tutorial de Claude Code: tu primera sesión real](/es/claude-code/tutorial/)[Claude para estudiantes: Claude Code, la API y qué ofrece realmente el ámbito educativo](/es/claude-code/for-students/)[Cómo usar Claude Code para automatizar QA](/es/claude-code/qa-automation/)[Claude Code frente a Cursor: cuál usar, cuándo y cómo ejecutar ambos](/es/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparativa de los agentes de terminal](/es/claude-code/vs-codex/)[Subagentes de Claude Code: cómo funcionan, cómo definirlos y equipos de agentes](/es/claude-code/subagents/)[Hooks de Claude Code: control determinista sobre lo que hace el agente](/es/claude-code/hooks/)[MCP en Claude Code: conexión de servidores, ámbitos, MCP remoto y ejemplos reales](/es/claude-code/mcp/)[El ecosistema de Claude Code: enrutadores, frameworks, plugins y las listas que los recopilan](/es/claude-code/ecosystem/)[Claude Code en VS Code: la extensión, el uso desde la terminal y los errores](/es/claude-code/vscode/)[Cómo usar OpenRouter en Claude Code (y cuándo no hacerlo)](/es/claude-code/openrouter/)[Error de límite de solicitudes de Claude: qué significa «Error de API: se ha alcanzado el límite de solicitudes» y cómo solucionarlo](/es/claude-code/rate-limits/)[Cómo usar Claude Code: desde la instalación hasta el uso diario](/claude-code/zh/)