"Premature close" en Claude Code: mira primero si falta git o gh

TL;DR Ejecuta which git gh. Si alguno sale como not found, instálalo y actualiza Claude Code a la 2.1.290 o posterior con claude update: desde esa versión el error nombra el programa que falta. Si "Premature close" llega dentro de un error de la API, el problema es la conexión, no git.

"Premature close" es el mensaje genérico de un stream que se cierra antes de terminar. Hasta la 2.1.289, en macOS y Linux, Claude Code lo mostraba cuando intentaba ejecutar un programa que no está instalado, como git o gh, en lugar de decir cuál faltaba. Lo corrigió la 2.1.290, del 5 de octubre de 2026:

Fixed errors reading "Premature close" instead of naming the missing program when a tool Claude Code runs, such as git or gh, is not installed (macOS, Linux)

Git o la red: cómo distinguirlo

• Sale cuando Claude Code ejecuta git o gh por su cuenta, por ejemplo al crear un worktree con claude --worktree o al consultar GitHub con gh. Es casi seguro que falta el programa. Sigue los pasos de abajo.
• Sale dentro de un error de la API o de la conexión. El mismo texto aparece cuando se corta la conexión a mitad de una respuesta. Ahí git no tiene nada que ver: comprueba antes si Claude está caído o eres tú.

Cómo arreglarlo

1. Mira qué programa falta

which git gh

Con los dos instalados, cada uno responde con su ruta:

/opt/homebrew/bin/git
/opt/homebrew/bin/gh

Si falta alguno, zsh lo dice con not found (bash no imprime nada para ese programa). Esta es la salida real con los dos fuera del PATH:

git not found
gh not found

En macOS, /usr/bin/git existe aunque no tengas las Command Line Tools de Xcode. Comprueba con git --version que responde con un número de versión. Si en su lugar te ofrece instalar las herramientas o da un error, instálalas con xcode-select --install.

2. Instala lo que falte

# macOS con Homebrew
brew install git gh

# Debian, Ubuntu
sudo apt install git

Para gh en Linux, la guía de instalación de GitHub CLI tiene el repositorio de cada distribución. Si gh es nuevo en tu máquina, autentícate con gh auth login antes de volver a Claude Code.

3. Actualiza Claude Code

claude update

Desde la 2.1.290, si vuelve a faltar un programa, el error lo nombra. Lo comprobé en la 2.1.293: quité git del PATH y lancé claude --worktree en un repositorio. En lugar de "Premature close", la salida fue:

Error creating worktree: Failed to resolve base branch "HEAD": git rev-parse failed

Si claude update no te sube de versión porque instalaste con Homebrew o npm, cómo actualizar Claude Code tiene el comando de cada caso.

Docs oficiales: Troubleshooting · Changelog de Claude Code, 2.1.290