Параллельная работа [worktrees]

В расширении Клода внутри VS Code можно открыть несколько вкладок и дать каждому агенту свою задачу. Но все они будут работать с одной версией проекта, и редактировать одни и те же файлы.

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

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

Принцип простой:

Три задачи → три копии → три агента работают одновременно. Или больше.

В Claude Code появилась встроенная поддержка «worktrees». Одна команда в терминал и готово:

Claude сам создаёт изолированную копию проекта, создаёт ветку, и начинает работу.

Можно задать ✏️ имя:

Что происходит под капотом ⚙️

Когда заканчиваешь:

Добавь .claude/worktrees/ в .gitignore, чтобы содержимое копий не отображалось как неотслеживаемые файлы.

Можно сделать ещё проще = не создавать «worktrees» вручную, а настроить так, чтобы субагенты автоматически получали свою изолированную копию.

Для этого создаёшь файл агента в .claude/agents/ с параметром isolation: worktree:

Теперь когда Claude решит делегировать работу этому агенту, тот автоматически получит свою копию проекта. Закончил без изменений = копия удалится сама.

Это работает везде: и в чате VS Code, и в терминале, и в десктоп-приложении. Ничего руками делать не нужно. Можно и без файла, просто попроси Claude в чате: «используй worktrees для своих агентов». И объясни зачем тебе это нужно и для чего.

Если тебе нужен полный контроль, можно создать «worktree» вручную через git:

Получается такая структура:

Открываешь каждую папку в отдельном окне VS Code, запускаешь Claude, даёшь задачу.

Когда задача сделана:

Этот способ работал всегда, и продолжает работать. Но встроенная команда claude --worktree делает то же самое быстрее и с автоматической очисткой.

claude --worktree — это команда терминала. Но не обязательно открывать отдельный терминал. Встроенный терминал VS Code работает точно так же.

Два интерфейса, одна цель:

А субагенты с isolation: worktree работают из любого интерфейса, хоть из чата, хоть из терминала. Claude сам разбирается.

[ + ] Несколько независимых задач

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

[ + ] Best-of-N: несколько попыток, выбираешь лучшую

Запускаешь 3-5 агентов на одну и ту же задачу, каждый в своём «worktree». Получаешь несколько вариантов решения. Сравниваешь, выбираешь лучший. Особенно полезно для сложных задач, где с первого раза не всегда получается идеально.

[ + ] Миграции и массовые изменения

Нужно переименовать функцию в 50 файлах, обновить API, или мигрировать на новую версию библиотеки? Субагенты с «worktree» изоляцией могут делать это параллельно, каждый работая со своим куском кодовой базы.

[ - ] Это продвинутая тема. «Worktrees» — штука для тех, кто хотя бы немного разобрался с терминалом и git. Если тебе пока сложно, не обязательно сюда лезть прямо сейчас. Но знать, что это существует — полезно.

[ - ] Фича свежая. Встроенная поддержка --worktree появилась в феврале 2026. Могут быть шероховатости. Ручной способ через git worktree add работает стабильно и давно.

[ - ] Мёрдж-конфликты. Когда несколько агентов работали параллельно и оба правили похожие файлы — при объединении могут быть конфликты. Ничего страшного: Claude хорошо умеет их разрешать. Просто имей в виду.

[ - ] Не теряй контроль. Когда запущено 5 параллельных агентов, легко потерять нить — где что сделано, в какой ветке какая фича. Давай каждому «worktree» понятное имя, и следи за процессом.

В следующем уроке обсудим «Agent Teams».
Это другой подход: несколько агентов в одном проекте, которые координируются между собой. У них общая доска задач, они переписываются друг с другом. Тебе не нужно вручную раздавать задания, они разберутся сами.

👾 Worktrees это как фрилансеры на удалёнке. Каждый получил задание и работает у себя дома. Не видят друг друга, не переписываются. Ты единственный, кто знает что происходит у каждого. Проще, дешевле, и подходит когда задачи не связаны между собой.

😈 Agent Teams это как коллектив в одном офисе. У них общая доска задач, могут подойти друг к другу и спросить. Координируются сами. Дороже (каждый агент тратит токены), но для сложных задач, где нужна совместная работа — окупается.

В этом и соседних уроках описаны три способа масштабировать работу агентов:

💭 От Тома:
Параллельная работа нужна тем, у кого овер много задач и кому жоско важна скорость. Если ты не чувствуешь такой потребности — не парься, вернёшься когда понадобится. А если чувствуешь, что пора, то честно скажу, что работа в параллельных сессия реально меняет ощущение от процесса. Попробуй и зацени сам 🥷🏽