Разбор функции
Git Worktrees в Claude Code: параллельные сессии без конфликтов
Запускайте каждую сессию через claude --worktree — и каждый агент получает собственный чекаут в .claude/worktrees: две задачи одновременно, пять вариантов лендинга по одному промпту и ни одного переключения веток.
Иллюстрированная пошаговая инструкция из 12 шагов — чтение займет около 4 минут. Каждый шаг ведет к точной минуте исходного видео.
Коротко
Git worktree выкачивает вторую ветку того же репозитория в отдельную папку, при этом обе папки делят одну git-историю. Запустите claude --worktree вместо обычного claude — и Claude Code создаст worktree в .claude/worktrees/<случайное-имя> для этой сессии: два терминала правят один репозиторий одновременно, не мешая друг другу. Единственное условие — git init и хотя бы один коммит. Субагентам изоляцию можно запросить на лету одним промптом или закрепить навсегда строкой isolation: worktree во front matter файла агента в .claude/agents.
Исходное видео
Эта страница следует за записью Developers Digest с демонстрацией worktrees в Claude Code и восстанавливает её шаги кадр за кадром. Каждый скриншот ведет к точному моменту в видео.
Скриншоты — кадры из видео с указанием авторства; текст наш. Шаги сверены с видео и документацией Claude Code в сентябре 2026 года.
guide_claude_code_worktrees.sections.why_worktrees_title
guide_claude_code_worktrees.sections.why_worktrees_subtitle
- 1
Что такое worktree
Git worktree выкачивает вторую ветку того же репозитория в отдельную папку. Каждая папка правит свои файлы, но git-данные у них общие — папка feature1 живет на ветке Feature-1, а main в своей папке остается нетронутым.
Один репозиторий, три папки, три ветки — схема, с которой открывается видео.Смотреть с 0:30 - 2
Сделайте первый коммит
Worktrees нужен репозиторий, от которого можно отвести ветку. В видео папку demo-app инициализируют через git init, создают index.html командой touch и коммитят всё через git add и git commit. Единственное условие — хотя бы один коммит; остальное Claude Code берет на себя.
Единственная ручная подготовка в видео: init, один файл, один коммит.Смотреть с 1:10
guide_claude_code_worktrees.sections.parallel_sessions_title
guide_claude_code_worktrees.sections.parallel_sessions_subtitle
- 3
Запустите сессию через claude --worktree
Вместо обычного claude наберите claude --worktree. Экран приветствия покажет, где живет эта сессия: не в корне demo-app, а в .claude/worktrees/clever-munching-toast — папке, которую Claude Code создал для этой сессии. Случайное имя разводит параллельные сессии в стороны.
На баннере приветствия указан автосозданный worktree, который будет править эта сессия.Смотреть с 1:30 - 4
Откройте второй терминал и повторите
Ради параллельности всё и затевалось: откройте еще один терминал Claude Code в той же папке и снова запустите claude --worktree. Эта сессия rooted в .claude/worktrees/spicy-napping-otter. Теперь два агента правят index.html в одном репозитории, не видя изменений друг друга.
Та же команда, тот же репозиторий, другая папка — вот и весь workflow.Смотреть с 1:36 - 5
Дайте первой сессии задачу
Первую сессию просят сделать страницу «hello world» на черном фоне. Она записывает 24 строки в index.html и отчитывается Done. Сессия правит собственный worktree, поэтому с главным чекаутом столкнуться нечему.
Первая сессия пишет свою черную страницу внутри clever-munching-toast.Смотреть с 1:40 - 6
Сравните оба результата рядом
Обе сессии открывают свои страницы в браузере: «hello world» на черном по URL из clever-munching-toast и «hello world» на фиолетовом по URL из spicy-napping-otter. Окно Finder между ними показывает папку .claude/worktrees с подпапкой на каждую сессию — один репозиторий, выкачанный дважды, измененный дважды.
Черная и фиолетовая страницы живут по двум разным worktree-адресам одного репозитория.Смотреть с 1:50
guide_claude_code_worktrees.sections.subagent_isolation_title
guide_claude_code_worktrees.sections.subagent_isolation_subtitle
- 7
Пять агентов одним промптом
Изоляцию worktree можно включать и на лету. Один промпт — пять разных субагентов, пять креативных SaaS-вариантов лендинга для HTML-файла, всем включить git worktree изоляцию — и Claude Code отвечает «Running 5 Task agents», перечисляя Variation 1–5 с числом вызовов инструментов и токенов у каждого. Ctrl+B отправляет эскадрилью в фон.
Один промпт, пять Task-агентов, каждый в собственном изолированном git worktree.Смотреть с 2:52 - 8
Дождитесь финиша эскадрильи
Через несколько минут каждый вариант отчитывается Done — по четыре вызова инструментов и около 50 тысяч токенов. Пять разных дизайнов одного файла существуют одновременно, никто не тронул главный чекаут, и посреди работы не пришлось ни stash-ить, ни мержить.
Пять строк Done: параллельные агенты финишировали без единого конфликта.Смотреть с 4:14 - 9
Выбирайте направление по пути worktree
Claude Code резюмирует пять тем — Minimal Dark Mode, Gradient Dreamscape, Retro Terminal / Hacker, Soft Pastel / Friendly, 3D / Isometric — и печатает точный путь файлов каждой: .claude/worktrees/agent-a01ee76a/index.html и так далее. Принять вариант — значит просто сохранить ветку его worktree.
Каждая тема — отдельная папка в .claude/worktrees: смотрите, потом мержите понравившуюся.Смотреть с 4:22
guide_claude_code_worktrees.sections.agent_config_title
guide_claude_code_worktrees.sections.agent_config_subtitle
- 10
Опишите изолированного субагента обычными словами
Изоляцию можно вшить в определение агента. После /clear — одна фраза: создай субагента фронтенд-разработчика, модель Haiku, включи изоляцию worktree. Claude Code сначала сверяется с собственной документацией по субагентам, потом собирает конфиг — YAML вручную писать не нужно.
Попросите Haiku плюс изоляцию worktree — файл Claude Code напишет сам.Смотреть с 5:46 - 11
Claude Code пишет файл агента
Спецификация ложится в проект: mkdir -p создает .claude/agents, затем внутрь записывается frontend-dev.md. Проектные агенты живут в этой папке — там же, где skills, — поэтому определение ездит вместе с репозиторием.
mkdir -p .claude/agents, затем frontend-dev.md — установка агента одним файлом.Смотреть с 6:18 - 12
Строка, которая делает агента параллельным
Во front matter сказано всё: name, description, model: haiku, дальше isolation: worktree и белый список инструментов Read, Edit, Write, Bash, Glob, Grep. Отныне каждый запуск этого агента автоматически получает собственный git worktree — без флагов и напоминаний в промпте.
isolation: worktree во front matter — постоянная изоляция worktree для этого агента.Смотреть с 6:34