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 checkSi 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 --bggenera exactamente este error, notificado en macOS, Windows y Linux (#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, #53247). Finaliza los procesos de
clauderestantes 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, 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); 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). - 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, sobrecarga / 529, Error de API 400 o Errores de OAuth. Para la extensión en concreto, consulta Claude Code en VS Code.
¿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
¿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 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.