# Git es necesario para sesiones locales en Claude Code: 4 casos

> La app de Claude solo exige Git en sesiones con Worktree. Si en Windows te lo pide siempre, es anterior a la 1.49585.0: actualízala antes de reinstalar Git.

- URL: https://blog.laozhang.ai/es/posts/claude-code-git-required-local-sessions
- Published: 2026-10-23
- Updated: 2026-10-23
- Author: LaoZhang AI Team (https://blog.laozhang.ai/es/about)
- Topic: Claude Code
- Tags: Claude Code, Claude Desktop, Git for Windows, CLAUDE_CODE_GIT_BASH_PATH, Solución de problemas

---
Si la pestaña Code de la app de escritorio de Claude te frena con «Git is required for local sessions» o con la variante «Git for Windows is required to run local sessions», lo primero es mirar la versión de la app, no volver a instalar Git. A 23 de octubre de 2026, la documentación de Claude Code dice que solo las sesiones que se ejecutan en su propio worktree necesitan Git, y el interruptor **Worktree** viene desactivado. Las versiones de Claude Desktop para Windows anteriores a la 1.49585.0 pedían Git antes de abrir cualquier sesión local; para ese caso, el arreglo oficial es actualizar la app desde **Help → Check for Updates…**.

Si ya tienes la 1.49585.0 o una posterior (incluidas todas las 2.x y 3.x) y el aviso sigue, desactiva **Worktree** en el control de la carpeta del proyecto, debajo de la caja del mensaje, o instala Git: Git for Windows en Windows, las Command Line Tools con `xcode-select --install` en Mac. Cuando Git ya está instalado y la app no lo ve, el fallo suele estar en la detección: en Windows, la variable `CLAUDE_CODE_GIT_BASH_PATH` tiene que apuntar a `bash.exe`, y Claude tiene que cerrarse también desde la bandeja del sistema; en Mac, falta aceptar la licencia de Xcode o hay un `git` sobrante en el PATH. Si el mensaje sale en la terminal al ejecutar `claude`, no es este aviso y tiene otro arreglo.

Lo único probado directamente es la parte de Mac. El 23 de octubre de 2026, en un Mac con macOS 26.1 y Claude Desktop 3.6556.2, las sesiones locales de la pestaña Code funcionaban con el Git que trae Apple, y la frase antigua «Git is required for local sessions» no aparece en el paquete de esa versión de la app. No se probó nada en Windows: los pasos de Windows que siguen vienen de la documentación oficial y de reportes de usuarios en GitHub, no de una prueba propia.

## Cuál de las 4 situaciones de «Git is required» tienes

El mismo aviso aparece en cuatro situaciones que se arreglan de forma distinta, y lo que las separa es el número de versión de la app, si **Worktree** está activado y si Git responde en una terminal. Empieza por la versión, porque confirma o descarta la primera fila en un minuto.

![Árbol de decisión: si el aviso sale en la terminal es del CLI; si la app es una 1.x anterior a la 1.49585.0, hay que actualizarla; si git --version falla, toca desactivar Worktree o instalar Git, y si responde, revisar cómo la app detecta Git](https://blog.laozhang.ai/posts/es/claude-code-git-required-local-sessions/img/diagnostico-cuatro-casos.webp)

| Situación | Cómo reconocerla | Qué hacer |
| --- | --- | --- |
| Windows con una versión antigua que pide Git para cualquier sesión local | Versión 1.x por debajo de 1.49585.0; el aviso sale aunque no uses Worktree y menciona `CLAUDE_CODE_GIT_BASH_PATH` | Actualizar la app; instalar Git no siempre lo quita |
| Versión actual, sesión con Worktree y sin Git | Versión 1.49585.0 o posterior (incluidas 2.x y 3.x), **Worktree** activado o un entorno guardado con Worktree, y `git --version` falla en la terminal | Desactivar Worktree o instalar Git |
| Git instalado, pero la app no lo encuentra o no puede ejecutarlo | `git --version` funciona en la terminal y el aviso sigue; en Mac puede decir «Git is installed but isn't working» | Windows: variable a `bash.exe` y salir desde la bandeja. Mac: licencia de Xcode, `git` sobrante en el PATH o acceso total al disco |
| El mensaje es del CLI, no de la app | Sale al ejecutar `claude` en PowerShell o CMD y habla de «git-bash» o de «Git for Windows (for bash) or PowerShell» | Es otra superficie: se resuelve en la instalación del CLI |

Hay un quinto texto que no pertenece a esta tabla: «Git LFS is required by this repository but is not installed» significa que el repositorio usa Git LFS, y la [sección «Errores de Git y Git LFS» de la documentación de Claude Code Desktop](https://code.claude.com/docs/es/desktop#git-and-git-lfs-errors) indica instalarlo desde git-lfs.com, ejecutar `git lfs install` y reiniciar la app.

## ¿Cómo usar Claude Code en local sin Git? Solo Worktree lo necesita

Con la versión actual de la app puedes trabajar en local sin Git. Según la [documentación de Claude Code Desktop sobre sesiones en su propio worktree](https://code.claude.com/docs/es/desktop#run-a-session-in-its-own-worktree), Worktree está desactivado por defecto y Claude trabaja directamente en la carpeta del proyecto; solo cuando lo activas, la sesión corre en un worktree de Git, una copia aislada del proyecto, y ahí sí hace falta Git. Una carpeta que no es un repositorio Git ni siquiera puede usar Worktree.

Para comprobarlo, abre el control de la carpeta del proyecto en la fila que hay bajo la caja del mensaje y desactiva **Worktree**. En el diseño anterior de la app es la casilla **worktree** junto al nombre de la rama, encima de la caja. Si empiezas las sesiones desde un entorno guardado, ese entorno tiene su propio ajuste de Worktree, así que revísalo al editar el entorno: apagarlo en la sesión nueva no cambia el del entorno. Mantén Git y Worktree solo si quieres sesiones en paralelo que no se pisen los cambios.

En la terminal ocurre algo parecido. La [guía de configuración avanzada de Claude Code](https://code.claude.com/docs/es/setup) indica que en Windows nativo Git for Windows es opcional: sin él, Claude Code ejecuta los comandos con la herramienta de PowerShell, y con él, Git Bash se usa para la herramienta Bash. Las instalaciones en WSL no necesitan Git for Windows. La idea de que Claude Code «necesita Git Bash para funcionar» ya no es cierta con la versión actual.

## Mira la versión de Claude Desktop: por debajo de 1.49585.0, actualiza

La versión de la app decide si tu aviso es del tipo antiguo. Cualquier versión 2.x o 3.x es posterior a la 1.49585.0 (la documentación ya cita requisitos de la v2.37337.0 y la v3.1623.0), y las 1.x desde la 1.49585.0 en adelante, como la 1.52386, tampoco tienen la comprobación vieja: solo existe en una 1.x por debajo de esa cifra. Compara el segundo número como número entero: 1.5354.0 y 1.24012.9 son anteriores a 1.49585.0, porque 5354 y 24012 son menores que 49585, aunque a simple vista no lo parezca. Anthropic no publica la fecha de la 1.49585; por las fechas de los reportes en GitHub, llegó a los usuarios de Windows hacia principios de septiembre de 2026.

1. Abre la información de la versión: en Windows, **Help → About Claude**; en Mac, **Claude → About Claude** en la barra de menús. Si pulsas el número, se copia al portapapeles.
2. Si es una 1.x por debajo de 1.49585.0, actualiza con **Help → Check for Updates…** en Windows o **Claude → Check for Updates…** en Mac.
3. Si **Check for Updates…** no aparece, tu organización tiene desactivadas las actualizaciones automáticas: pide a tu administrador una versión actual.
4. Con la app ya actualizada, abre una sesión nueva en la pestaña Code.

Los nombres de menú son los de la interfaz en inglés, que es como los recoge también la documentación en español. Un dato que confirma el diagnóstico: en el paquete de Claude Desktop 3.6556.2 para Mac, leído el 23 de octubre de 2026, los mensajes de Git son «Git is required but was not found…» y «Git is installed but isn't working…», y la frase «Git is required for local sessions» no aparece ninguna vez. Si ves esa frase exacta, lo más probable es que tu app sea anterior. El paquete de Windows no se inspeccionó.

## Instalaste Git en Windows y el aviso no se va: revisa bash.exe

Cuando Git for Windows ya está instalado y la app sigue sin verlo, revisa tres cosas antes de reinstalar nada: a qué archivo apunta la variable, cómo está escrito su nombre y si Claude se quedó abierto en la bandeja sin leer la variable nueva. La primera se presta a error porque el aviso antiguo pedía la ruta de «your git executable», mientras que la [guía de configuración avanzada de Claude Code](https://code.claude.com/docs/es/setup) indica la ruta de `bash.exe`. Ninguno de estos pasos se ha probado en un PC con Windows; salen de esa documentación y de reportes de usuarios, citados en cada paso.

![Cuatro pasos para Windows, sin probar en un PC propio: apuntar la variable al bash.exe de la carpeta bin y no al de usr, escribir CLAUDE_CODE_GIT_BASH_PATH con GIT, salir con Quit desde la bandeja y abrir una sesión nueva revisando main.log](https://blog.laozhang.ai/posts/es/claude-code-git-required-local-sessions/img/windows-bash-exe-pasos.webp)

1. Localiza `bash.exe`. En una instalación estándar de [Git for Windows](https://git-scm.com/downloads/win) está en `C:\Program Files\Git\bin\bash.exe`. Si instalaste Git en otra unidad, por ejemplo `D:\Git`, o usas Git portable, la ruta que vale es la de `bin\bash.exe` dentro de esa carpeta. `where.exe git` en PowerShell te dice dónde está `git.exe`, y `bash.exe` está en la carpeta `bin` de esa misma instalación. Usa `bin\bash.exe` y no `usr\bin\bash.exe`: en el [issue #72976 de Claude Code en GitHub](https://github.com/anthropics/claude-code/issues/72976), un usuario con Git portable en un disco externo vio que el aviso seguía con la variable en `Git\usr\bin\bash.exe` y desaparecía al cambiarla a `Git\bin\bash.exe`, sin tocar nada más.
2. Crea la variable de usuario con el nombre exacto `CLAUDE_CODE_GIT_BASH_PATH`. En PowerShell, un usuario de GitHub la creó así:

   ```powershell
   [Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "C:\Program Files\Git\bin\bash.exe", "User")
   ```

   Algunos vídeos de YouTube escriben `CLAUDE_CODE_GET_BASH_PATH`, con GET en lugar de GIT, y una variable con otro nombre simplemente no se lee. Las mayúsculas no importan en Windows; esa letra sí.
3. Sal de Claude del todo. Un informe de campo publicado en note.com, con cuatro casos de clientes, y un usuario del mismo issue #72976 coinciden en que cerrar la ventana con la X deja la app en la bandeja del sistema, junto al reloj, y la app solo lee las variables al arrancar. Haz clic derecho en el icono de Claude de la bandeja y elige **Quit**; si no lo encuentras, reinicia el PC.
4. Abre Claude y empieza una sesión local nueva en la pestaña Code.
5. Si el aviso sigue, abre el registro `%LOCALAPPDATA%\Claude\logs\main.log`, la ruta que citan los usuarios en GitHub, y busca líneas con «Git». Las instalaciones desde Microsoft Store pueden guardar esa carpeta en otra ubicación.

Hay un punto en el que conviene dejar de insistir. Con versiones anteriores a la 1.49585.0 hubo casos en los que ni la variable de sistema, ni el diálogo de entorno local de la app, ni reinstalar Git quitaron el aviso, también con Windows en ARM64 ([#83178](https://github.com/anthropics/claude-code/issues/83178), [#73461](https://github.com/anthropics/claude-code/issues/73461)). El primero se cerró como duplicado de [#75570](https://github.com/anthropics/claude-code/issues/75570), que a su vez se cerró como duplicado de #72976, cuyo autor reinstaló Git cuatro veces en tres meses. Si estás en una de esas versiones y ya hiciste lo anterior, la salida es actualizar la app; si no puedes, usa una sesión en la nube o la terminal.

## ¿CLAUDE_CODE_GIT_BASH_PATH va en las variables de Windows o en settings.json?

Para la app de escritorio, ponla en las variables de entorno de usuario o de sistema de Windows. La documentación de Claude Code Desktop dice que en Windows la app hereda esas variables al arrancar y no lee los perfiles de PowerShell, así que un `$env:CLAUDE_CODE_GIT_BASH_PATH` en tu perfil no le llega. El bloque `env` de `~/.claude/settings.json` sirve para todas las sesiones locales, pero Claude Code lo ignora si la misma variable ya está en el entorno con el que arranca la sesión, y la documentación no dice si la comprobación previa de las versiones antiguas lo lee. Si lo usas, en JSON las barras invertidas van dobles:

```json
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}
```

Una clave `gitBashPath` en settings.json no figura en la documentación, y el usuario de #83178 que la probó siguió con el aviso; no la uses.

## En Mac dice que las herramientas ya están instaladas y sigue pidiendo Git

En Mac, el aviso antiguo terminaba con «Run `xcode-select --install` in Terminal to install the Command Line Tools», y muchos usuarios lo vieron con un `/usr/bin/git` que funcionaba. Ese comando solo responde que las herramientas ya están instaladas: no revisa la licencia de Xcode ni lo que hay en el PATH, que es donde estaban las causas en los reportes de GitHub ([#44297](https://github.com/anthropics/claude-code/issues/44297), [#72588](https://github.com/anthropics/claude-code/issues/72588)).

1. En Terminal, ejecuta `git --version` y `which -a git`. Si la primera devuelve un aviso de licencia, ve al paso 2. Si la segunda muestra más de una ruta, la primera es la que gana: un archivo vacío llamado `git`, un `~/bin/git` o una carpeta llamada `git` dentro de un directorio del PATH provocaron errores `spawn … EACCES`. Renómbralo o quítalo del PATH.
2. Si tienes Xcode completo, acepta la licencia con `sudo xcodebuild -license`; después de actualizar macOS puede hacer falta abrir Xcode y aceptarla otra vez. Con solo las Command Line Tools, ese comando responde que necesita Xcode, y esa no es tu causa.
3. Lee el registro de la app con `grep 'error' ~/Library/Logs/Claude/main.log` y busca líneas como `Git command failed: git --version`, `EACCES` o `xcodebuild -license`.
4. Si el mensaje dice «Git is installed but isn't working», la propia app indica dar a Claude acceso total al disco en **Ajustes del Sistema → Privacidad y seguridad** y volver a intentarlo.
5. Actualiza la app como en la sección de la versión, sal con **Cmd + Q** y vuelve a abrirla.

El paso 5 importa en macOS 26. La Desktop 1.32885.0 exigía `xcrun` y `git` dentro de la carpeta de las Command Line Tools, y el paquete de herramientas 26.6 no trae `xcrun` ahí, así que mostraba la pantalla de instalar Git aunque `/usr/bin/git` funcionara ([#87762](https://github.com/anthropics/claude-code/issues/87762), cerrado el 25 de agosto de 2026). El 23 de octubre de 2026, en un Mac con macOS 26.1 y esa misma carpeta sin `xcrun`, Claude Desktop 3.6556.2 abría sesiones locales con normalidad, y los registros de la app desde el 5 de octubre no tenían ni una línea «Git is required». Una comprobación sana en esa máquina se ve así:

```text
$ git --version
git version 2.50.1 (Apple Git-155)
$ which -a git
/usr/bin/git
$ xcode-select -p
/Library/Developer/CommandLineTools
```

Eso no prueba un Mac sin Git ni otra versión de la app, pero sí que el falso positivo de macOS 26 ya no aparece en la versión actual.

## Cuándo dejar de reintentar: sesión en la nube, remota o terminal

Si tienes la versión actual, Git responde en la terminal, la variable es correcta y has salido de la app del todo, y la sesión local sigue sin abrir, deja de reinstalar y cambia de ruta. Las variantes del aviso que circularon entre abril y agosto de 2026 ya proponían cambiar a un entorno remoto. Las sesiones en la nube clonan un repositorio de GitHub en una máquina de Anthropic y exigen una cuenta de GitHub conectada, así que no trabajan sobre tu carpeta local ni con tus herramientas instaladas; cómo empezar está en [Claude Code en la web: del navegador a tu primer PR](https://blog.laozhang.ai/es/posts/claude-code-web-interface).

La otra salida es la terminal, que no depende de este aviso. Si allí te sale «requires git-bash» o «requires either Git for Windows (for bash) or PowerShell», ese mensaje del CLI se resuelve en [Cómo instalar Claude Code en Windows, Mac o Linux y actualizarlo](https://blog.laozhang.ai/es/posts/claude-code-install), y si dudas entre terminal y app, [Cómo instalar Claude Code en Mac, Windows y Linux: terminal o app](https://blog.laozhang.ai/es/posts/how-to-install-claude-code) compara las dos. Si la sesión local por fin arranca y después se corta con «exited with code 1», es otro fallo: sigue con [Claude Code process exited with code 1: diagnostica la rama antes de reinstalar](https://blog.laozhang.ai/es/posts/error-claude-code-process-exited-with-code-1).

## Fuentes

Páginas externas que cita esta guía, en el orden en que aparecen. Última actualización: 2026-10-23.

- [sección «Errores de Git y Git LFS» de la documentación de Claude Code Desktop](https://code.claude.com/docs/es/desktop) (code.claude.com)
- [guía de configuración avanzada de Claude Code](https://code.claude.com/docs/es/setup) (code.claude.com)
- [Git for Windows](https://git-scm.com/downloads/win) (git-scm.com)
- [issue #72976 de Claude Code en GitHub](https://github.com/anthropics/claude-code/issues/72976) (github.com)
- [#83178](https://github.com/anthropics/claude-code/issues/83178) (github.com)
- [#73461](https://github.com/anthropics/claude-code/issues/73461) (github.com)
- [#75570](https://github.com/anthropics/claude-code/issues/75570) (github.com)
- [#44297](https://github.com/anthropics/claude-code/issues/44297) (github.com)
- [#72588](https://github.com/anthropics/claude-code/issues/72588) (github.com)
- [#87762](https://github.com/anthropics/claude-code/issues/87762) (github.com)