Source: https://aiprimetech.io/es/claude-code/errors/process-exited-code-1/ [Inicio](/es/) › [Claude Code](/es/claude-code/) › [Errores](/es/claude-code/errors/) › Terminó con el código 1 [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 # «El proceso de Claude Code terminó con el código 1»: cómo encontrar el error real y solucionarlo «El proceso de Claude Code terminó con el código 1» es un mensaje del programa que lo ejecuta: la extensión de VS Code o la aplicación de escritorio inició la claude CLI, y esta terminó antes de poder indicar el motivo. La solución empieza por obtener el error real. ## TLDR - Ejecuta claude en un terminal normal: la CLI muestra el error real que oculta el programa que la ejecuta. - Causas habituales: Node.js / PATH desactualizado, settings.jsonno válido, una sesión en segundo plano bloqueada, procesos huérfanos en Windows. - claude doctor comprueba la instalación; reinstalar con el instalador nativo corrige la mayoría de las instalaciones dañadas. - Windows: si la aplicación no vuelve a iniciarse tras un cierre inesperado, un reinicio completo elimina el bloqueo del proceso huérfano. ## Paso 1: obtén el error real ``` claude --version # is the CLI there at all? claude # start it directly: the real error prints here claude doctor # install health check ``` Si funciona en el terminal y solo falla la extensión o la aplicación, el problema está en el entorno desde el que se inicia el programa que ejecuta la CLI (PATH, versión de Node, variables de proxy), no en Claude Code. Si también falla en el terminal, el mensaje que muestra es el que debes buscar. ## Causas conocidas (del registro de incidencias) - Reanudar una sesión en segundo plano en VS Code. Abrir una sesión iniciada con claude --bg genera exactamente este error, notificado en macOS, Windows y Linux ([#77162](https://github.com/anthropics/claude-code/issues/77162)). Detén primero el agente en segundo plano o abre una sesión nueva. - Windows: proceso huérfano tras un cierre inesperado. La aplicación no puede volver a iniciarse porque un proceso anterior sigue manteniendo un bloqueo ([#42776](https://github.com/anthropics/claude-code/issues/42776), [#53247](https://github.com/anthropics/claude-code/issues/53247)). Finaliza los procesos de claude restantes en el Administrador de tareas; la solución fiable que se indica allí es reiniciar Windows por completo. - Aplicación de escritorio en Apple Silicon que falla cada vez que se inicia una sesión mientras la CLI funciona ([#59866](https://github.com/anthropics/claude-code/issues/59866), un duplicado de una incidencia conocida): actualiza la aplicación; mientras tanto, utiliza la CLI en un terminal. - Node.js anterior a 18 o un PATH dañado tras una instalación con npm: el programa que ejecuta la CLI no puede iniciarla. node -v; cambia al instalador nativo para eliminar la dependencia de Node. - `~/.claude/settings.json` no válido. Una coma sobrante en un bloque de hooks o permisos hace que la CLI termine inmediatamente. Valida el JSON. - Incompatibilidad de shell en Windows — una herramienta de PowerShell falla desde Git Bash con un modelo específico ([#87980](https://github.com/anthropics/claude-code/issues/87980)); prueba el otro shell. ## Si nada de lo anterior se aplica - Actualiza todo: claude update, y actualiza la extensión de VS Code o la aplicación de escritorio. - Reinstala con el instalador nativo (curl -fsSL https://claude.ai/install.sh | bash, o los comandos de una sola línea para PowerShell / CMD de la [guía de instalación](/es/claude-code/install/)). - Inicia VS Code desde un terminal para que herede el mismo entorno que la CLI que funciona. - Abre una nueva incidencia con la salida de claude doctor — los cierres inesperados se clasifican rápidamente en el registro de incidencias. ## Relacionado Si Claude Code se inicia pero luego falla con un error de API, se trata de un problema distinto: consulta [Error de API 500](/es/claude-code/errors/api-error-500/), [sobrecarga / 529](/es/claude-code/errors/overloaded-529/), [Error de API 400](/es/claude-code/errors/api-error-400/) o [Errores de OAuth](/es/claude-code/errors/oauth-error/). Para la extensión en concreto, consulta [Claude Code en VS Code](/es/claude-code/vscode/). ## ¿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 ¿Qué significa «El proceso de Claude Code terminó con el código 1»? La extensión de VS Code o la aplicación de escritorio inició la CLI de Claude Code y esta terminó con un error. Ejecuta claude en un terminal para ver el mensaje de error real.¿Cómo soluciono que Claude Code termine con el código 1 en Windows? Finaliza los procesos de claude restantes (o reinicia Windows si la aplicación no vuelve a iniciarse), comprueba node -v y PATH, valida ~/.claude/settings.json y reinstala con el instalador nativo si es necesario.¿Por qué Claude Code funciona en el terminal pero no en VS Code? VS Code se inició con un entorno diferente (PATH, Node, variables de proxy). Inicia VS Code desde el terminal donde funciona claude o corrige las variables en el perfil de tu shell. ## 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 [Errores de Claude Code y cómo solucionarlos](/es/claude-code/errors/)[Claude Code «Error de la API: 500»: qué significa y qué lo soluciona realmente](/es/claude-code/errors/api-error-500/)[Error «Sobrecargado» de Claude (error de la API 529): qué significa y qué hacer](/es/claude-code/errors/overloaded-529/)[Error de la API de Claude Code 400: prompt demasiado largo, concurrencia en el uso de herramientas y los demás](/es/claude-code/errors/api-error-400/)[Errores OAuth de Claude Code: se ha superado el tiempo de espera de 15000ms y código de estado 500](/es/claude-code/errors/oauth-error/)[Claude «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 espacio](/es/claude-code/errors/prompt-too-long/)[Se 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é hacer](/es/claude-code/errors/usage-limit-reached/)[Claude Code 401 y 403: credenciales de autenticación no válidas, clave API no válida, «No has iniciado sesión», host_not_allowed](/es/claude-code/errors/auth-401-403/)[Errores 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 SSL](/es/claude-code/errors/connection-lost/)[Claude Code se bloquea, se queda atascado o deja de responder: cómo averiguar dónde se ha atascado y salir del bloqueo](/es/claude-code/errors/claude-code-hangs/)[Claude.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](/es/claude-code/errors/claude-ai-not-working/)