12 Авг в 14:11

Claude Code и Git worktree: как безопаснее запускать несколько ИИ-агентов в одном репозитории

Три ИИ-агента работают в отдельных ветках программного репозитория

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

Это полезное улучшение для команд, которые уже запускают агентов на нескольких задачах. Но worktree решает только изоляцию файлов и веток: он не разделяет секреты, сетевые права, внешние базы данных или общие сервисы разработки.

Как работает новый режим

Git worktree позволяет иметь несколько checkout одного репозитория без полного клонирования истории для каждого из них. Claude Code создаёт такую рабочую директорию внутри <repo>/.claude/worktrees/<name> и запускает сессию в ней. Если имя не указано, система генерирует его автоматически.

Базовый пример выглядит так: claude --worktree feature-auth. Во втором терминале можно запустить другую сессию с другим именем. Каждая получит собственную ветку и набор рабочих файлов, поэтому агент, исправляющий ошибку, не столкнётся с незавершённым рефакторингом другой сессии.

Короткий флаг — -w. Документация также поддерживает запуск от номера pull request или его URL, если необходимо исследовать конкретную ветку. Для отображения сессии в tmux предусмотрен флаг --tmux, который используется вместе с worktree.

Что это даёт на практике

Главный выигрыш — параллельность без постоянного переключения веток. Один агент может писать тесты, второй — обновлять документацию, третий — изучать независимую ошибку. Разработчик видит отдельные diff и решает, какие изменения объединять.

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

Ограничения Git worktree

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

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

Worktree — не песочница безопасности

Отдельная ветка защищает рабочие файлы от пересечения, но процесс по-прежнему работает с правами текущего пользователя. Сессии могут видеть одни и те же переменные окружения, SSH-ключи, облачные credentials, Docker daemon, локальные базы и сетевые ресурсы. Ошибочная команда в одном worktree способна затронуть общую инфраструктуру.

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

Что это означает для интеграторов ИИ

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

Следующий шаг — связать worktree с политикой доступа, наблюдаемостью и проверками качества: кто создал сессию, какие инструменты она вызывала, какой diff получила, какие тесты прошли и кто одобрил объединение. Именно такой конвейер превращает параллельных агентов из удобной демонстрации в управляемый инженерный процесс.

Практический вывод

Флаг --worktree делает параллельные сессии Claude Code заметно проще и безопаснее для рабочего дерева. Он хорошо решает конфликт файлов и веток, но не заменяет песочницу, контроль секретов и ревью. Начинать стоит с двух независимых задач, измерить время до принятого merge и только затем расширять число одновременных агентов.