# Claude Code: «Git is required for local sessions» — 4 причины

> В Claude Desktop Git нужен только сеансам с Worktree. Старое окно «Git is required for local sessions» убирает обновление приложения, а не переустановка Git.

- URL: https://blog.laozhang.ai/ru/posts/claude-code-git-required-local-sessions
- Published: 2026-10-23
- Updated: 2026-10-23
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ru/about)
- Topic: Claude Code
- Tags: Claude Code, Claude Desktop, Git for Windows, Worktree, CLAUDE_CODE_GIT_BASH_PATH, Диагностика

---
Окно "Git is required for local sessions" во вкладке **Code** настольного приложения Claude чаще всего означает не то, что вам не хватает Git, а то, что у вас старая сборка приложения. По документации Anthropic на 23 октября 2026 года Git нужен только тем сеансам, у которых включён переключатель **Worktree**, то есть сеансам в отдельной рабочей копии проекта на основе git worktree, а по умолчанию **Worktree** выключен. Сборки для Windows до версии 1.49585.0 требовали Git перед запуском любого локального сеанса, и для этого случая Anthropic советует не ставить Git, а обновить приложение через **Help → Check for Updates…**.

Поэтому начните с номера версии в **Help → About Claude** (на Mac — **Claude → About Claude**). Если на Windows версия начинается с 1 и число после «1.» меньше 49585, обновите приложение. Если у вас 1.49585.0 или новее (в том числе 2.x и 3.x) и окно появляется только при включённом **Worktree**, выключите его или установите Git for Windows, а на Mac — Command Line Tools командой `xcode-select --install`. Если Git уже установлен, а окно возвращается, значит, приложение его не находит: на Windows переменная `CLAUDE_CODE_GIT_BASH_PATH` должна указывать на `bash.exe`, а не на `git.exe`, и Claude нужно закрыть целиком, включая значок в трее; на Mac в сообщениях пользователей чаще всего мешали непринятая лицензия Xcode или посторонний файл `git` в PATH. Сообщение в терминале "Claude Code on Windows requires either Git for Windows (for bash) or PowerShell" выдаёт уже другая программа, Claude Code CLI.

Что из этого проверено на практике. 23 октября 2026 года на одном Mac (macOS 26.1, Claude Desktop 3.6556.2) локальные сеансы открываются без этого окна, а в самом приложении старой фразы "Git is required for local sessions" нет. На Windows ничего не запускалось: шаги для Windows ниже взяты из документации Anthropic и сообщений пользователей на GitHub и не являются проверенным рецептом.

## Какая из четырёх ситуаций у вас: версия, Worktree и текст окна

Одно и то же окно возникает в четырёх разных ситуациях, и различить их можно за минуту по трём признакам: номеру версии приложения, состоянию переключателя **Worktree** и точному тексту сообщения. От ситуации зависит, поможет ли установка Git вообще.

| Ситуация | Как узнать | Что делать |
| --- | --- | --- |
| Старая сборка приложения | Windows: версия 1.x ниже 1.49585.0, окно появляется при любом новом локальном сеансе, даже без Worktree. На любой ОС — текст "Git is required for local sessions…", на старых сборках для Windows также "Git for Windows is required to run local sessions…" | Обновить приложение. Ставить Git для обычного сеанса не нужно |
| Текущая сборка, включён Worktree | Версия 1.49585.0 или новее, в том числе 2.x и 3.x; окно только при включённом **Worktree**; на Mac текст "Git is required but was not found…" | Выключить **Worktree** или установить Git |
| Git установлен, но приложение его не находит или не может запустить | `git --version` в терминале печатает номер версии, а окно остаётся; на Mac текущая сборка пишет "Git is installed but isn't working…" | Windows: переменная на `bash.exe` и полный выход из приложения. Mac: лицензия Xcode, лишний `git` в PATH, полный доступ к диску, журнал |
| Сообщение пришло из терминала, а не из приложения | Текст появился в PowerShell или CMD после команды `claude` | Это Claude Code CLI, решение — в статье об установке CLI |

Любое изменение — установка Git, новая переменная среды, обновление — приложение увидит только после полного выхода. На Windows крестик закрывает окно, но Claude остаётся работать в области уведомлений, а переменные среды программа читает один раз при запуске. Щёлкните правой кнопкой по значку Claude в трее и выберите выход (Quit) или завершите процессы Claude в диспетчере задач, затем откройте приложение снова; если сомневаетесь, перезагрузите компьютер. На Mac выйдите через **Claude → Quit Claude** или Cmd+Q. Документация Anthropic даёт тот же совет для случаев, когда CLI работает, а приложение нет: закрыть приложение полностью, а не только его окно.

![Схема выбора: сообщение в терминале, версия ниже 1.49585.0 или вывод git --version ведут к одной из четырёх ситуаций и следующему шагу](https://blog.laozhang.ai/posts/ru/claude-code-git-required-local-sessions/img/situation-decision-tree.webp)

## Нужен ли Git, чтобы работать с Claude Code локально

В текущих версиях приложения обычный локальный сеанс Git не требует: Claude работает прямо в выбранной папке, и она даже не обязана быть Git-репозиторием. Git понадобится, только если вы включаете **Worktree**, а этот переключатель доступен лишь в проекте, который уже является Git-репозиторием. На Windows без Git for Windows Claude Code выполняет команды через PowerShell, а с ним использует Git Bash; по [документации Anthropic об установке Claude Code](https://code.claude.com/docs/en/setup) Git for Windows на Windows необязателен.

«Локально» здесь значит, что Claude читает и меняет файлы на вашем компьютере. Это не офлайн-режим: вкладке **Code** нужен вход в аккаунт с платным планом Pro, Max, Team или Enterprise. Отдельное сообщение "Git LFS is required by this repository but is not installed" относится к репозиториям с Git LFS: установите его с [git-lfs.com](https://git-lfs.com/), выполните `git lfs install` и перезапустите приложение.

## Версия ниже 1.49585.0: как узнать номер и обновить Claude Desktop

Если номер версии начинается с 1 и число после «1.» меньше 49585, у вас сборка, которая проверяла Git перед любым локальным сеансом. Например, 1.24012.9 из сообщения на GitHub от августа 2026 года — старая, а любая версия 2.x или 3.x новее 1.49585.0. Точной даты выхода 1.49585.0 Anthropic не публикует; судя по сообщениям пользователей на GitHub, к 9–10 сентября 2026 года она уже стояла у многих на Windows.

1. Откройте номер версии: на Windows **Help → About Claude**, на Mac **Claude → About Claude**. Щелчок по номеру копирует его.
2. Запустите обновление: на Windows **Help → Check for Updates…**, на Mac **Claude → Check for Updates…**.
3. Полностью выйдите из приложения и откройте его снова, как описано в разделе о четырёх ситуациях.
4. Начните новый сеанс во вкладке **Code** с выключенным **Worktree**.

Названия пунктов меню приведены по англоязычной документации Anthropic. Если пункта **Check for Updates…** нет, автообновление, скорее всего, отключено политикой организации: попросите администратора поставить новую версию. Основание — [раздел «Git and Git LFS errors» в документации Claude Desktop](https://code.claude.com/docs/en/desktop#git-and-git-lfs-errors): там сказано, что сборки для Windows до 1.49585.0 спрашивали Git перед любым локальным сеансом и что при этом окне без Worktree приложение нужно обновить.

## Окно появляется при включённом Worktree: выключите его или установите Git

Если версия свежая и окно появляется только тогда, когда включён **Worktree**, приложение работает как задумано: изолированный сеанс без Git невозможен. Выбор простой — либо отказаться от изоляции, либо поставить Git.

Чтобы выключить **Worktree**, нажмите на элемент с папкой проекта в строке под полем ввода и снимите переключатель. В прежнем варианте интерфейса это флажок **worktree** рядом с названием ветки над полем ввода. Если вы запускаете сеансы из сохранённого окружения, у него свой параметр **Worktree**, и менять его нужно в настройках окружения, иначе он снова включится.

Если изоляция нужна, установите Git. На Windows это [Git for Windows с сайта git-scm.com](https://git-scm.com/downloads/win), в нём уже есть Git Bash. На Mac выполните в Терминале `git --version`: если выводится номер, Git есть; если система предлагает установить инструменты разработчика, согласитесь или выполните `xcode-select --install`. После установки перезапустите приложение полностью.

## Git for Windows установлен, а окно не уходит: путь к bash.exe

Если Git стоит, а старая сборка всё равно показывает окно, первым шагом остаётся обновление из раздела о версии 1.49585.0. Шаги ниже собраны из документации Anthropic и сообщений пользователей на GitHub; на Windows они не проверялись. Выполняйте их по порядку в новом окне PowerShell.

1. Убедитесь, что Git виден системе: `git --version` должен вывести номер версии, а `where.exe git` — путь, например `C:\Program Files\Git\cmd\git.exe`.
2. Найдите `bash.exe`. В стандартной установке это `C:\Program Files\Git\bin\bash.exe`; если Git стоит в другой папке, например `D:\Git`, файл лежит в её подпапке `bin`. Проверка: `Test-Path "C:\Program Files\Git\bin\bash.exe"` должна вернуть `True`.
3. Задайте переменную пользователя: `[Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "C:\Program Files\Git\bin\bash.exe", "User")`. Значение — полный путь именно к `bash.exe`. В старом окне написано "your git executable", но и документация, и более поздняя версия того же окна говорят о `bash.exe`.
4. Сверьте имя переменной по буквам: `CLAUDE_CODE_GIT_BASH_PATH`, через GIT. В описаниях нескольких видеоинструкций на YouTube она написана как `CLAUDE_CODE_GET_BASH_PATH`, а переменную с другим именем приложение не прочитает. Регистр букв в Windows роли не играет, важна именно буква.
5. Выйдите из Claude полностью, включая значок в трее, и откройте снова.
6. Если окно осталось, посмотрите журнал приложения. По сообщениям пользователей он лежит в `%LOCALAPPDATA%\Claude\logs\main.log`; при установке из Microsoft Store путь может отличаться.

![Сравнение для Windows: путь к bin\bash.exe вместо cmd\git.exe, имя CLAUDE_CODE_GIT_BASH_PATH вместо опечатки GET, переменные среды Windows вместо профиля PowerShell и выход через трей вместо крестика](https://blog.laozhang.ai/posts/ru/claude-code-git-required-local-sessions/img/windows-bash-path-check.webp)

### CLAUDE_CODE_GIT_BASH_PATH: в переменные Windows или в settings.json

Для этого окна задавайте переменную в переменных среды Windows, пользовательских или системных. По документации приложение на Windows наследует именно их при запуске и не читает профили PowerShell, поэтому `$env:` в профиле не сработает. Ключ `env` в `~/.claude/settings.json` из документации CLI — `"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"`, обратные слэши внутри JSON удваиваются — передаёт значение уже запущенным сеансам Claude Code. Читает ли его старая проверка, которая срабатывает до старта сеанса, в документации не сказано, а у пользователей на GitHub эта настройка окно не убирала. Ключа `gitBashPath`, который пробовали пользователи в тех же обсуждениях, в документации нет, и он тоже не помог.

### Когда перестать переустанавливать Git

Есть задокументированные на GitHub случаи, когда на старой сборке не помогало ничего: Git 2.53.0 с верным путём к `bash.exe` и несколько полных перезапусков (март 2026 года), системная переменная на `D:\Git\bin\bash.exe` вместе с настройками в самом приложении (август 2026 года), Git для ARM64, затем для x64 на Windows ARM (июль 2026 года). Автор одной из веток четыре раза переустанавливал Git за три месяца, и окно исчезло только 28 августа 2026 года после повторного входа в аккаунт; почему, Anthropic не объяснял. Поэтому, если Git на месте, путь к `bash.exe` верный, а приложение перезапущено полностью, пятая переустановка ничего не даст. Обновите приложение, а если обновить нельзя, работайте через удалённый сеанс или запускайте Claude Code в терминале.

## Mac: Command Line Tools уже стоят, а Claude просит Git

На Mac окно с подсказкой `xcode-select --install` часто появляется при рабочем `/usr/bin/git`. Сама команда `xcode-select --install` проверяет только, установлены ли инструменты, поэтому повторный запуск ничего не меняет. Пройдите проверки по порядку в Терминале.

1. `git --version`. Если вместо номера появляется требование принять лицензию Xcode, выполните `sudo xcodebuild -license` и согласитесь. После обновления macOS, если установлен полный Xcode, откройте его и примите соглашение.
2. `which -a git`. Первой строкой должен быть настоящий Git, например `/usr/bin/git` или Git из Homebrew. Пустой файл с именем `git`, лишний `~/bin/git`, папка `git` в одном из каталогов PATH или ссылка Homebrew, которая указывает на каталог в Cellar, а не на программу, перехватывают вызов; в журнале это обычно выглядит как `spawn … EACCES`. Переименуйте или удалите лишнее.
3. `grep -i 'git' ~/Library/Logs/Claude/main.log | tail -20`. В журнале приложения видна настоящая причина, например `You have not agreed to the Xcode license agreements` или `EACCES`.
4. Если текущая сборка пишет "Git is installed but isn't working" и добавляет, что Claude не может прочитать файл конфигурации Git, откройте **Системные настройки → Конфиденциальность и безопасность → Полный доступ к диску** и включите Claude.
5. На macOS 26 сборка 1.32885.0 (август 2026 года) требовала утилиту `xcrun` внутри папки Command Line Tools, а в пакете CLT 26.6 её там нет, поэтому приложение показывало экран установки Git при рабочем Git. Это лечится обновлением приложения.

После каждого исправления перезапускайте Claude полностью, через Cmd+Q.

## Что показала проверка на Mac 23 октября 2026 года

23 октября 2026 года на одном Mac с macOS 26.1 (25B78) и Claude Desktop 3.6556.2 локальные сеансы во вкладке **Code** работают. Конфигурация совпадает с той, на которой старые сборки ошибались: Git от Apple, папка Command Line Tools без `xcrun`, полного Xcode нет. Во всех журналах приложения с 5 по 23 октября строка "Git is required" не встречается ни разу. Вот как выглядит нормальный вывод проверок из списка выше:

```text
$ git --version
git version 2.50.1 (Apple Git-155)
$ which -a git
/usr/bin/git
$ xcode-select -p
/Library/Developer/CommandLineTools
$ xcodebuild -license check
… requires Xcode, but active developer directory … is a command line tools instance
```

Последняя строка на Mac без полного Xcode — норма, а не причина окна. Строки `Git command failed: git fetch … code: 128` и `git status timed out` в `main.log` тоже встречаются на этом исправном Mac: это сбои отдельных команд Git в конкретном репозитории, например обращения к удалённому серверу, а не проверка наличия Git.

В файлах приложения 3.6556.2 для Mac остались только новые сообщения: "Git is required but was not found. Run `xcode-select --install` in Terminal to install the Command Line Tools, then try again." и "Git is installed but isn't working", к которому добавляется совет выдать Claude полный доступ к диску или проверить файл конфигурации Git. Старой фразы "Git is required for local sessions" там нет, так что, если вы видите именно её, у вас старая сборка. Сборка для Windows не проверялась, как и Mac без установленного Git; русский текст этого окна не наблюдался.

## Если нужно просто работать: облачный сеанс, терминал или Remote Control

Облачный сеанс в claude.ai/code или в удалённом окружении приложения обходится без Git на вашем компьютере, но требует подключённого аккаунта GitHub, потому что репозиторий клонируется в виртуальную машину Anthropic. Чем он отличается от локальной работы, разобрано в статье [Есть ли у Claude Code веб-версия: чем отличаются облачный Web, Remote Control и локальная работа](https://blog.laozhang.ai/ru/posts/claude-code-web-interface). Если вы хотите управлять локальным сеансом с другого устройства, есть [Claude Code Remote Control: полное руководство по программированию с любого устройства (2026)](https://blog.laozhang.ai/ru/posts/remote-control-claude-code).

Claude Code в терминале — отдельная программа со своим сообщением о Git, и Git for Windows ему тоже необязателен: см. [Как установить Claude Code на Windows, Mac и Linux: Git не нужен](https://blog.laozhang.ai/ru/posts/claude-code-install). Выбрать между CLI и приложением помогает статья [Как установить Claude Code на Mac, Windows и Linux: CLI или .dmg](https://blog.laozhang.ai/ru/posts/how-to-install-claude-code). Если сеанс наконец запустился, но падает с кодом выхода 1, это следующая ошибка: [Claude Code process exited with code 1: найдите ветку перед переустановкой](https://blog.laozhang.ai/ru/posts/error-claude-code-process-exited-with-code-1).

## Источники

Внешние страницы, на которые ссылается это руководство, в порядке упоминания. Последнее обновление: 2026-10-23.

- [документации Anthropic об установке Claude Code](https://code.claude.com/docs/en/setup) (code.claude.com)
- [git-lfs.com](https://git-lfs.com/) (git-lfs.com)
- [раздел «Git and Git LFS errors» в документации Claude Desktop](https://code.claude.com/docs/en/desktop) (code.claude.com)
- [Git for Windows с сайта git-scm.com](https://git-scm.com/downloads/win) (git-scm.com)