Изоляция, команды агентов и советник

Почему это важно именно вам

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

Сегодня — про то, как это решается технически, и про две продвинутые возможности, о которых стоит знать, даже если вы включите их не завтра.

Что это такое

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

Часть изоляции вы уже получаете бесплатно: фоновые сессии из Дня 71 перед первой правкой файлов сами переезжают в собственную копию под .claude/worktrees/. Руками изоляцию задают там, где сессия обычная (флаг --worktree) или где её нужно дать конкретному субагенту (поле isolation). Вне git-репозитория изоляции нет вообще — там параллельные правки одних и тех же файлов опасны.

Это единственный честный способ дать нескольким агентам менять файлы одновременно. Каждый в своей копии — конфликтов нет по построению. В конце изменения сводятся вместе обычными средствами системы контроля версий.

Agent teams — команда сессий, где одна ведущая раздаёт задачи остальным, а те работают самостоятельно и общаются между собой. Возможность экспериментальная и выключена по умолчанию: включается переменной CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. У неё есть известные ограничения по возобновлению сессий, координации задач и медленному завершению работы.

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

Advisor — второй, обычно более сильный, модельный «советник», к которому основная модель обращается в ключевые моменты: перед выбором подхода, при повторяющейся ошибке, перед объявлением задачи выполненной. Советник видит весь разговор и возвращает рекомендацию. Возможность экспериментальная; работает и на подписке, и при оплате по API, но недоступна через сторонние облака (Amazon Bedrock, Google Cloud, Microsoft Foundry). На подписке его работа идёт в ваш обычный лимит.

Как работает на практике

Запустить сессию в отдельной копии

claude --worktree аудит-договоров

Создаётся рабочая копия в .claude/worktrees/аудит-договоров/ на новой ветке, и Claude стартует прямо в ней. Второй терминал с другим именем — вторая независимая копия.

Важно, откуда копия стартует: по умолчанию — от основной ветки репозитория на сервере (обычно main), а не от вашего текущего состояния. Ваших несохранённых на сервер коммитов агент в такой копии не увидит. Если он должен работать поверх вашей незавершённой работы, поставьте в настройках worktree.baseRef значение "head".

Короткая форма — -w. Если имя не указать, оно сгенерируется само.

Важная деталь: для интерактивного запуска нужна ранее подтверждённая доверенность к каталогу. Если вы в этой папке Claude ещё не запускали, сначала запустите обычный claude и подтвердите диалог доверия.

Изолировать субагента

Изоляцию можно задать не только сессии, но и отдельному субагенту — полем isolation: worktree в его описании. Тогда агент получает временную копию репозитория, а если он ничего не изменил, копия удаляется автоматически.

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

Изоляция не бесплатна

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

Убирать за собой

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

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

Команды агентов — когда это оправдано

Сильные сценарии для agent teams — исследование и разбор с нескольких сторон, когда участники должны спорить: несколько «коллег» проверяют конкурирующие гипотезы и сходятся к ответу быстрее.

Но прежде чем включать экспериментальную возможность, честно спросите: не хватит ли субагентов внутри одной сессии или обмена сообщениями между вашими сессиями? В большинстве директорских задач — хватит.

Советник — второе мнение внутри задачи

/advisor

/advisor без аргумента открывает список моделей, /advisor opus задаёт сразу. Дальше Claude сам решает, когда обратиться: перед выбором подхода, при застревании, перед финальным «готово». Выбор сохраняется в настройках и действует во всех следующих сессиях — попробовали и передумали, выключайте командой /advisor off.

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

Частые ошибки

Запускать параллельных агентов на запись без изоляции. Самая дорогая ошибка блока: результат выглядит выполненным, а часть правок потеряна.

Включать изоляцию везде. На задачах чтения это чистые накладные расходы.

Копить рабочие копии. Через месяц вы не помните, что в ветке worktree-bright-running-fox, и боитесь её удалять.

Включать экспериментальные возможности в рабочем процессе. Agent teams и advisor помечены как экспериментальные не для красоты: у них меняется поведение и есть известные ограничения. Пробуйте на задачах, где сбой не критичен.

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

Когда нужно / когда нет

Изоляция нужна:

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

Не нужна:

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

Советник имеет смысл: в длинных задачах, где большая часть шагов рутинна, но качество плана решает. Не имеет: в коротких задачах — там проще сразу взять сильную модель.

Связь с другими уроками

День 37 — git worktrees. Базовое знакомство; сегодня — применение к параллельным агентам.

День 74 — workflow. Массовые правки в скрипте почти всегда требуют изоляции агентов.

День 61 — модели. Советник — способ получить качество сильной модели, не переводя на неё всю работу.

Задание на сегодня

Запустите claude --worktree тест-изоляции в проекте под контролем версий и убедитесь, что работаете в отдельной копии.
Внесите изменение, вернитесь в основную сессию и проверьте, что там файл не тронут.
Сведите изменения и удалите копию — пройдите цикл до конца, чтобы он не пугал.
Если у вас есть задача с массовой правкой файлов — попробуйте субагента с изоляцией worktree.
Прочитайте про advisor и решите, есть ли у вас задача, где нужно точечное второе мнение.

Критерий «выполнено»: вы провели полный цикл «отдельная копия → изменения → сведение → удаление» и понимаете, когда изоляция нужна, а когда мешает.

Резюме

Worktree — отдельная рабочая копия проекта: единственный надёжный способ дать нескольким агентам править файлы параллельно.
claude --worktree <имя> (или -w) создаёт копию и стартует в ней; для новой папки нужен подтверждённый диалог доверия.
Субагенту изоляция задаётся полем isolation: worktree; если он ничего не изменил, копия удаляется сама.
Изоляция стоит времени и места — на задачах чтения она не нужна.
Agent teams (ведущий + самостоятельные коллеги) экспериментальны, выключены по умолчанию и не разводят участников по копиям — работу между ними делят по файлам вручную.
Advisor подключает более сильную модель точечно в ключевые моменты; работает и на подписке, выключается командой /advisor off.