worktree — команда для Claude Code: изолированная работа с ветками
Команда создаёт отдельную папку git worktree для работы над фичей или фиксом. Полезна, когда нужно параллельно вести несколько задач без конфликтов в основной ветке.
CC-BY-SA-4.0 ★ 6 529 обновлён 2026-10-22
.claude/commands/worktree.mdЧто делает worktree
Команда /worktree автоматизирует создание изолированного рабочего пространства на базе git worktree. Вы задаёте имя ветки в формате префикс/описание (например, feature/pr-9-skill-improvements), а скрипт создаёт папку .worktrees/префикс-описание, проверяет, добавлен ли .worktrees/ в .gitignore, и переходит на новую ветку.
Скрипт валидирует имя ветки, отклоняя пробелы и зарезервированные git-символы. Есть флаг --fast для пропуска проверки .gitignore. Если ветка уже существует, worktree её переиспользует. По завершении команда подсказывает, как переключиться в новую папку и запустить Claude там.
Для удаления используйте /remove-worktree (конкретный worktree) или /clean-worktrees (все слитые). Это удобно при параллельной разработке или когда вы работаете в документации и хотите проверить разные версии одновременно.
Какие задачи решает
- Создать отдельную ветку для фичи без конфликтов с основной кодовой базой
- Работать параллельно над несколькими задачами в разных папках
- Быстро переключаться между изолированными рабочими окружениями
- Автоматически добавить
.worktrees/в.gitignoreпри первом запуске
Примеры запросов агенту
- Создай worktree для фичи:
/worktree feature/pr-9-skill-improvements - Создай worktree для фикса:
/worktree fix/typo-in-guide - Создай worktree с пропуском проверки gitignore:
/worktree feat/new-section --fast
Как установить worktree
Вручную: положить файлы
.claude/commands/worktree.mdВызов — /worktree. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/worktree.mdВызов — /prompts:worktree. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/worktree.prompt.mdВручную: положить файлы
.gemini/commands/worktree.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о worktree
Как установить worktree в Claude Code?
Скопируй файл команды в папку .claude/commands/worktree.md вашего проекта. Этот путь Claude Code читает автоматически при запуске.
Что делает команда worktree?
Создаёт изолированную папку для работы над ветко́й git, проверяет .gitignore и валидирует имя ветки. После этого вы можете открыть эту папку отдельно в Claude Code, чтобы работать параллельно с другими ветками.
Какой формат имени ветки нужен?
Используй префикс/описание, например feature/pr-9-skills, fix/typo или docs/add-section. Слэш в имени преобразуется в дефис для названия папки (.worktrees/feature-pr-9-skills).