Git worktree в Claude Code: 3 сессии сразу без конфликтов

Зачем вообще заводить отдельную копию проекта

Представь, что ты работаешь над одним и тем же документом в Word с другом одновременно: пока ты правишь абзац наверху страницы, друг правит абзац внизу той же страницы - и в какой-то момент чьи-то правки затираются или файл вообще ругается на конфликт. Ровно то же самое происходит, если вести две разные задачи в ОДНОЙ и той же папке проекта: пока Claude Code чинит одну ошибку, ты хочешь параллельно попросить его добавить новую функцию - и обе задачи трогают одни и те же файлы одновременно

Worktree решает это иначе, чем спор из-за одного документа: вместо одной общей папки под каждую задачу заводится СВОЯ копия, у неё своя ветка истории, и обе копии физически не пересекаются на диске. По официальному описанию Anthropic, это «отдельная рабочая папка со своими файлами и своей веткой, использующая ту же самую историю и то же общее хранилище проекта, что и твоя основная копия. Если каждую сессию Claude Code вести в своей копии, правки одной сессии никогда не задевают файлы другой - поэтому одна сессия может собирать новую функцию, пока вторая чинит ошибку»

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

Шаг 1. Проверь, что в проекте уже есть хотя бы одна сохранённая версия

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

Что это тебе даёт: если ты только что создал папку проекта и ещё ни разу не сохранял в ней изменения, сначала нужно сохранить хотя бы одну версию (как первая точка сохранения игры, от которой можно будет начинать заново). Если проект уже какое-то время живёт и правки в нём уже сохранялись раньше - этот шаг у тебя уже выполнен, можно идти дальше. Если условие не выполнено, официальная документация честно называет ошибку: команда завершится строкой «Failed to resolve base branch», то есть дословно «не удалось определить, от какой версии начинать копию». Как вообще устроен весь путь от первой команды Claude Code до таких приёмов - в «7 уровнях Claude Code: от первой команды до команды агентов»

Шаг 2. Запусти Claude Code с именем своей копии

Открой Claude Code в папке своего проекта, как обычно, и вместо обычного запуска набери одну команду с именем задачи:

По официальной документации, копия создаётся по умолчанию в специальной служебной папке внутри проекта, на новой ветке с автоматическим именем: «по умолчанию копия создаётся в папке .claude/worktrees/<имя>/ внутри корня твоего проекта, на новой ветке под именем worktree-<имя>». Если имя вообще не указать, Claude Code сам придумает случайное вроде bright-running-fox

Один практический совет из той же документации: служебную папку копий стоит добавить в список файлов, которые система не отслеживает (файл .gitignore), иначе содержимое копий будет мозолить глаза в основном проекте как «незафиксированные файлы»

Собственная проверка прямо на рабочей машине автора этой статьи (04.09.2026): установленная версия Claude Code 2.1.251 реально поддерживает этот флаг, команда claude --help печатает строку про -w, --worktree [name] дословно - то есть это не гипотетическая функция из документации, а рабочая настройка на живом инструменте

Шаг 3. Открой вторую копию в другом окне для второй задачи

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

По официальному описанию функции обзора всех таких параллельных сессий (claude agents), «каждый новый запрос, введённый в этом окне, запускает свою собственную новую сессию. Ввод следующего запроса и нажатие Enter запускает вторую сессию рядом с первой, а не отправляет продолжение в неё - так можно вести сразу несколько сессий параллельно». Здесь же дана честная оговорка про расход: «каждая сессия расходует твой лимит подписки отдельно от других, поэтому перед запуском сразу многих стоит свериться с ограничениями»

Своя проверка: создал демонстрационный проект на этой же машине, сохранил первую версию, потом той же командой, что использует Claude Code внутри, завёл вторую копию на отдельной ветке и сделал в ней правку. Результат: в основной папке проекта новый файл не появился ни разу - изоляция сработала на практике, а не только по описанию. Программа при этом сама подтвердила создание новой копии строкой «Preparing worktree (new branch 'feature-auth')». Полный дословный протокол этого прогона (13 действий подряд) сохранён рядом со страницей

Что новая копия НЕ получает по умолчанию

У свежей копии нет тех файлов, которые система специально не отслеживает - например, файла с личными паролями или ключами доступа к сервисам. Это может неожиданно сломать вторую сессию, если она не сможет подключиться к тем же сервисам, что и первая

По официальной документации, для этого есть отдельный файл-список: «поскольку копия - это свежая версия проекта, неотслеживаемые файлы вроде файла с паролями из основной папки в ней отсутствуют. Чтобы копировать их автоматически при создании каждой новой копии, добавь файл .worktreeinclude в корень проекта». В этот файл построчно вписываются имена файлов, которые нужно копировать в каждую новую копию - сам список пишется в том же формате, что обычный .gitignore

Почему вторая копия иногда «не запускается»

Отдельно стоит понимать: сами вспомогательные программы, которые нужны проекту для работы (то, что разработчики называют библиотеками - готовые чужие кусочки кода, встроенные в проект), копия НЕ наследует - это свежий проект, и их нужно установить заново внутри новой копии (или попросить об этом саму сессию Claude Code). Именно здесь чаще всего спотыкаются новички: открывают вторую копию, а она «не запускается», хотя причина простая - установка ещё не сделана внутри неё. Если Claude Code вообще ещё не подключён к внешним сервисам, с чего начать - в «Claude MCP: как подключить свой первый сервис за 10 минут»

Сколько места занимают копии на диске

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

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

Грабли, на которых спотыкаются новички

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

Шаг 4. Убери за собой, когда задача закрыта

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

Если правки уже закреплены и перенесены в основной проект, безопасно выбирать удаление копии: сама история проекта при этом никуда не денется, потому что и копия, и основная папка используют одну и ту же общую историю на диске. Как настроить Claude Code так, чтобы он вообще запоминал контекст твоего проекта между сессиями - в «CLAUDE.md: как настроить память Claude Code»

Как назвать копию, чтобы не запутаться

Имя копии - это то же самое имя, что попадёт в название её ветки, поэтому короткое и понятное название задачи экономит время уже через день работы. Плохая привычка - называть копии подряд («копия1», «копия2»): через неделю параллельной работы над тремя-четырьмя задачами вспомнить, что где лежит, станет сложно

Рабочий принцип простой: имя копии должно отвечать на вопрос «что я тут делаю», а не «когда я это создал». Имя вроде fix-bug-header или feature-auth через месяц всё ещё понятно с первого взгляда, а worktree3 уже нет

Что происходит с общей историей, когда копий несколько

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

Когда worktree не нужен

Не любая параллельная работа требует отдельной копии проекта. Если задачи связаны между собой (например, ты меняешь один и тот же файл в двух шагах подряд) - разумнее вести это как одну сессию по порядку, а не заводить две изолированные копии, между которыми потом придётся сводить результат вручную

Отдельная функция, которую легко перепутать с worktree - параллельные ПОМОЩНИКИ внутри одной задачи (subagents): это не копии проекта на диске, а несколько версий самого Claude, которые одновременно разбирают куски ОДНОЙ и той же задачи внутри одного и того же разговора. Разница разобрана отдельно в «Агенты Claude вышли из терминала: полный разбор для новичка» - там же честно сказано про цену: параллельные помощники расходуют «примерно в семь раз больше токенов, чем один разговор», поэтому имеет смысл сравнить, что решает именно твою задачу - копия проекта под независимые дела или несколько помощников под одно общее дело

Ещё один соседний механизм - когда Claude сам решает, разбивать ли большую задачу на план из десятков помощников (режим ultracode). Это тоже не про копии проекта, а про автоматическое планирование внутри одной сессии - полный разбор в «Ultracode в Claude Code: 2 способа включить режим workflow». Если параллельная работа в принципе кажется медленной и хочется разобраться с настройками вообще, а не только с worktree - есть отдельный разбор «Как усилить Claude в 10 раз: 7 настроек вместо промптов»

Что ещё почитать про Claude Code

• Агенты Claude вышли из терминала: полный разбор для новичка - чем параллельные помощники внутри одной сессии отличаются от отдельных копий проекта
• Ultracode в Claude Code: 2 способа включить режим workflow - ещё один соседний механизм автоматического планирования, тоже не про копии проекта
• Claude Code: что это и как работает - если ты вообще не работал с этим инструментом раньше
• Как установить Claude Code - шаг раньше, чем любые режимы и настройки
• 7 уровней Claude Code: от первой команды до команды агентов - если хочется увидеть весь путь целиком, а не один приём
• CLAUDE.md: как настроить память Claude Code - ещё один инструмент, который меняет поведение Claude Code на постоянной основе
• Скиллы, агенты и автоматизация Claude - все разборы Claude Code на одной странице

Источники

Все страницы открыты живым браузером 4 сентября 2026 года, плюс собственный прогон команд на этой же машине Голые адреса тех же документов: code.claude.com/docs/en/common-workflows, code.claude.com/docs/en/worktrees, code.claude.com/docs/en/agent-view, code.claude.com/docs/en/tools-reference, git-scm.com/docs/git-worktree

• Anthropic Claude Code Docs: Common workflows - Run parallel sessions with worktrees - краткое описание команды и сценария использования
• Anthropic Claude Code Docs: Worktrees - полное описание флага --worktree, файла .worktreeinclude, поведения при выходе из сессии
• Anthropic Claude Code Docs: Agent view - обзор и запуск нескольких параллельных сессий из одного окна
• Anthropic Claude Code Docs: Tools reference - описание инструментов EnterWorktree и ExitWorktree, которыми Claude управляет копиями изнутри сессии
• Git: официальная документация git-worktree - формат команды создания, удаления и списка копий, ограничение на одну и ту же ветку в двух копиях Голые адреса тех же документов: code.claude.com/docs/en/common-workflows, code.claude.com/docs/en/worktrees, code.claude.com/docs/en/agent-view, code.claude.com/docs/en/tools-reference, git-scm.com/docs/git-worktree

Памятка: git worktree за 5 минут

Пять строк, которые закрывают путь от «что это такое» до первой рабочей копии

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