# Git worktree для ИИ-агента: как вести две задачи в отдельных папках

Git worktree даёт ИИ-агенту свою папку и ветку. Как проверить базу и изменения перед переносом, развести порты и не подключить обе задачи к одной базе.

URL: https://posts.danashkin.ru/guides/git-worktree-dlya-ii-agenta
Обновлено: 2026-11-15

---

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

Через десять минут придётся выяснять, кто поправил какой файл и что можно унести в отдельную ветку. Git worktree позволяет сделать для второй задачи собственную папку с файлами, отдельной веткой и общей историей репозитория.

**Главное**

Выбери базовый коммит, создай связанную рабочую папку и укажи её агенту. Перед запуском проверь порт, базу и внешние подключения. На приёмке смотри изменения именно второй ветки и отдельно проверь их в приложении.

## Что Git worktree разделяет между двумя задачами?

**Главное**

У каждой связанной папки свои рабочие файлы, текущая ветка и область подготовки коммита. Коммиты и ссылки на ветки принадлежат общему репозиторию. Сетевые подключения, переменные окружения и запущенные процессы Git сам не разводит. Если агенту доступна соседняя папка, worktree сам по себе не отнимет у него этот доступ.

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

Ты оставляешь форму заказа открытой в первом окне, а в другом окне агент видит ветку с исправлением доставки. Сохранение файла в одном каталоге не меняет одноимённый файл во втором.

История при этом общая. Когда агент закоммитит исправление во второй папке, в первой можно посмотреть его ветку и сравнить её с базой. Копировать файлы между папками для этого не нужно. Работа без коммита остаётся на месте: правка, которую ты вчера сохранил только в первом каталоге, во второй не появится.

Удобный способ держать картину в голове: ветка отвечает на вопрос «куда попадёт следующий коммит», а папка отвечает на вопрос «какие файлы прямо сейчас лежат перед агентом». Когда две задачи должны идти параллельно, оба ответа нужно дать явно.

Если тебе пока непривычна работа с ветками, начни со [словаря вайбкодинга](/guides/slovar-vibecodinga-bez-zhargona). Если сложность в том, что две сессии пишут в один каталог, прочитай [разбор двух окон агента](/guides/dva-okna-agenta-odnovremenno).

## Папка и ветка

**Главное**

Из текущего репозитория создай новую ветку и связанную папку от выбранной базы. Затем проверь список рабочих деревьев и статус именно во второй папке. Все имена в примере условные.

Допустим, на доставке меняется только текст, а незаконченная форма заказа ей не нужна. Сначала выбери базу. Если нужен код из основной ветки, укажи `main`.

Если исправление должно опираться на твою текущую ветку, возьми её последний коммит или конкретный хеш. Попроси агента назвать выбранную базу до правок. Если он отвечает «текущая версия», уточни, имеется ли в виду зафиксированный коммит или файлы в открытой папке.

```bash
git worktree add -b fix/delivery-copy ../shop-delivery main
git worktree list
git -C ../shop-delivery status --short --branch
git -C ../shop-delivery rev-parse HEAD
```

Первая команда создаёт ветку `fix/delivery-copy` и открывает её в соседней папке `shop-delivery`. Следующие команды показывают обе папки, статус новой ветки и её базовый коммит. Если ты рассчитываешь на последнюю версию с сервера, отдельно проверь, что локальная база актуальна. Наличие второй папки про свежесть основной ветки ничего не говорит.

При старте задания [ИИ-агенту](/concepts/ai-agent) лучше назвать абсолютный путь к новой папке. В первых строках ответа попроси вернуть текущую директорию, ветку и краткий статус Git.

Если окно открылось в основной папке, это видно ещё до первой правки. Особенно легко перепутать каталоги, когда в обоих корнях лежат файлы с одинаковыми именами и обе локальные версии показывают один и тот же заголовок страницы.

## Где две папки всё ещё могут столкнуться?

**Главное**

Локальные порты, базы, очереди, общие каталоги выгрузки и доступы к внешним сервисам проверяй отдельно. Если второму заданию нужен только текстовый файл, хватит локальной проверки. Если обе версии приложения должны работать одновременно, запусти их на разных портах, например 3000 и 3001, штатной настройкой проекта. Открой оба адреса и сверь, какой каталог обслуживает каждый процесс.

В нашем примере агент меняет текст про доставку. Для первого просмотра можно открыть файл, посмотреть изменённый абзац и запустить существующую проверку текста. Если нужна страница в браузере, придётся понять, какой экземпляр приложения там открылся.

Иначе агент запустит второе приложение, увидит, что привычный порт уже занят, откроет первую вкладку и отчитается о результате, который проверял в соседней версии.

Отдельно проверь настройки, которые не хранятся в Git. У новой папки может не быть файла локальной конфигурации. Простое копирование такого файла из первой папки способно вернуть ровно ту зависимость, ради которой ты разделил задачи: оба процесса начинают писать в одну тестовую базу, перезаписывать один отчёт или слать письма из одного аккаунта.

Сначала выясни, какая настройка реально нужна проверке. Для текста о доставке часто хватит статической страницы или тестового источника с несколькими строками.

| Что проверить | Как заметить общую зависимость |
|---|---|
| Порт приложения | Оба окна показывают один адрес, а тестовая правка видна только в одном процессе |
| База | Изменение тестовой заявки в одной папке появляется в другой |
| Папка результатов | После второго прогона изменилось время файла, созданного первой задачей |
| Внешний сервис | Обе конфигурации указывают на один рабочий аккаунт |
| Настройки запуска | Агент не может назвать, откуда взял соединение или данные для проверки |

**Один контроль перед запуском**

Попроси агента назвать точную команду проверки и перечислить, какие файлы или записи она может изменить. После этого проще решить, нужен ли ему отдельный порт и тестовая база.

При приёмке одной из задач этого блога ветка автора уже была открыта в другом дереве, поэтому для проверки завели отдельную ветку от того же коммита. В других рабочих деревьях тогда не оказалось игнорируемых локальных материалов, а база рабочей ветки осталась на старом коммите, пока main ушёл вперёд. Из этого опыта получились три быстрые сверки: занята ли ветка, какие входные файлы реально лежат в папке и совпадает ли базовый коммит с выбранным.

## Приёмка изменений во второй папке

**Главное**

Сначала сравни изменения ветки с известной базой, затем посмотри состояние рабочей папки. Отдельно запусти действие, которое должен увидеть пользователь, и запиши, где проходила проверка.

Агент пишет: текст доставки обновлён. Возьми исходный коммит и посмотри, какие файлы затронуты. В нашем примере изменение страницы доставки ожидаемо. Правка формы заказа или общих настроек запуска требует объяснения.

Даже если агент изменил один файл, проверь его целиком по разнице: не ушло ли вместе с новым сроком обещание, которое относилось к другой зоне доставки.

Если агент уже сделал коммит, сравни ветку с записанной базой. Если ещё нет, проверь подготовленные и неподготовленные изменения, а в статусе посмотри новые файлы.

Одна команда, сравнивающая два коммита, незакоммиченный файл не покажет. И наоборот, чистый статус ветки может означать, что весь объём уже зафиксирован в коммитах. В командах ниже замени BASE на хеш, записанный при создании рабочей папки.

```bash
git -C ../shop-delivery diff BASE HEAD
git -C ../shop-delivery diff --cached
git -C ../shop-delivery diff
git -C ../shop-delivery status --short
```

Первый вывод покажет изменения между базовым коммитом и HEAD. Для списка коммитов используй `git -C ../shop-delivery log BASE..HEAD`. Следующие два покажут подготовленные и неподготовленные правки. В статусе отдельно проверь новые файлы, которые Git ещё не отслеживает.

На схеме с двумя задачами удобно хранить короткий журнал. Для формы заказа базой был её собственный коммит, а для доставки база взята из основной ветки.

Рядом отметь имя файла, который ожидал увидеть в изменениях, и имя каталога, где запускал проверку. Если через день обнаружится, что текст взят из старой редакции сайта, по этому журналу сразу ясно, где искать: в выборе базы или в самом исправлении.

Проверь один пользовательский маршрут в рабочем экземпляре из второй папки. Например, открой страницу доставки, выбери нужный регион и сверь текст в карточке условий. Запиши адрес и действие, которыми подтверждалась правка.

Для более широких задач пригодится [порядок приёмки кода без технического бэкграунда](/guides/kak-proveryat-ai-kod-bez-teh-bekgraunda). Если нужна программа обучения для команды, посмотри [практикум по работе с агентами](https://danashkin.ru/agents/). Для параллельной работы заранее согласуйте, кто принимает изменения и от какой базы.

## Когда вторую папку лучше оставить открытой?

**Главное**

Оставь рабочее дерево, пока нужна проверка или в нём лежат незакоммиченные результаты. Удаляй связанную папку средствами Git после того, как нужная работа сохранена и её можно найти в истории.

У второй папки есть стоимость: зависимости, локальные настройки и внимание. Когда исправление принято, сначала проверь статус, ветку и место, где остался нужный коммит. Если результат ещё будут обсуждать, оставь папку открытой до конца обсуждения.

Для чистого завершённого рабочего дерева подходит `git worktree remove` с путём к папке. Удаление рабочего дерева и удаление ветки идут отдельно. Можно убрать папку, а ветку оставить для ревью.

Если Git отказывается убрать папку, прочитай причину. Там могут лежать новые тестовые материалы, незакоммиченная правка или файл, который нужен только для воспроизведения.

Открой статус и реши судьбу каждого такого результата. Если папку создал Claude Code Desktop, сначала закоммить правки, которые хочешь сохранить, затем архивируй сессию. В Codex архивируй связанный чат: у управляемого рабочего дерева приложение сохраняет снимок перед удалением, а при повторном открытии чата снимок можно восстановить.

При одной последовательной задаче тебе может хватить одной папки и обычного переключения ветки. Worktree окупается, когда две линии работы действительно пересекаются по времени: ты принимаешь одну правку, пока агент продолжает другую, или надо держать две версии приложения открытыми одновременно.

## Как проверить разделение на двух файлах?

**Главное**

Поменяй один файл в каждой папке и сравни короткий статус Git. Рабочие правки должны появиться только там, где ты их сделал.

Проверить это можно в учебном репозитории магазина. Измени checkout.txt в основной папке без коммита, затем создай рабочее дерево с новой веткой от main, как в команде `git worktree add -b` выше. Во второй папке checkout.txt останется в виде, сохранённом в коммите.

Затем измени delivery.txt во второй папке и открой одноимённый файл в первой: там останется старая строка. Короткий статус первой папки покажет только checkout.txt, второй только delivery.txt. Такой прогон можно сделать перед первым поручением, чтобы оба окна сразу показали разные ветки и ожидаемые правки.

Если статус во второй папке уже показывает изменения до твоего задания, разберись с ними перед работой. Они могли появиться после установки зависимостей, запуска форматтера или другой сессии. Сравни фактический статус с тем, что агент видел на старте. Тогда новая правка не потеряется среди изменений окружения.

## Что чаще всего спрашивают про Git worktree?

**Главное**

Рабочее дерево берёт файлы из коммита. Git обычно защищает ветку от одновременного открытия в двух деревьях. Новая папка требует собственной проверки окружения.

### Частые вопросы

**Увидит ли агент мою незакоммиченную правку?**

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

**Можно ли открыть ту же ветку во второй папке?**

В обычном режиме Git не даёт одновременно открыть одну и ту же ветку в двух рабочих деревьях. Создай отдельную ветку от того же коммита. Тогда ты сможешь по истории увидеть, какой результат принесла каждая задача.

**Папка пустая от зависимостей. Это ошибка?**

Если зависимости не отслеживаются Git, новая папка может появиться без них. Установи их штатной командой проекта, если они нужны проверке, и отдельно посмотри настройки локального запуска.

Перед передачей второй задачи запиши папку, базовый коммит и ожидаемый результат. Эти три значения пригодятся при приёмке изменений.

### Источники

- [Создание, список, удаление связанных рабочих деревьев](https://git-scm.com/docs/git-worktree)
- [Состояние рабочей папки и неотслеживаемые файлы](https://git-scm.com/docs/git-status)
- [Как сравнивать коммиты и ветки](https://git-scm.com/docs/git-diff)

- [Claude Code Desktop: сохранение изменений перед архивированием сессии](https://code.claude.com/docs/en/desktop#keep-uncommitted-changes-when-a-session-is-archived)
- [Codex: рабочие деревья и их жизненный цикл](https://learn.chatgpt.com/docs/environments/git-worktrees)
