Рабочий процесс Git в Claude Code
Claude Code глубоко интегрирует функции Git, позволяя выполнять почти все операции Git с помощью естественного языка, включая создание коммитов, управление ветками, разрешение конфликтов слияния и использование Git Worktree для параллельных рабочих процессов. В этой главе подробно рассказывается об эффективном использовании Git в Claude Code.
Основные операции Git
1. Просмотр изменений
Просто спросите на естественном языке, чтобы получить статус Git:
Which files did I change?
What does this change include?
最近 10 次提交都改了什么?
检查一下当前的 git 状态
Claude автоматически выполнит соответствующие команды Git и отобразит результаты.
2. Коммит кода
Простой коммит:
Commit this change.
Submit this modification.
Коммит с описанием:
把这次的修改提交,commit 信息说明修复了登录验证的 bug
Claude автоматически сгенерирует правильно оформленное сообщение коммита на основе фактических изменений.
3. Управление ветками
新建一个 feature/user-profile 分支
切换到 develop 分支
把 main 分支的最新改动合并进来
View all branches.
Delete merged branches.
Обработка конфликтов слияния
1. Автоматическое разрешение простых конфликтов
Help me resolve merge conflicts.
This file has conflicts, help me check which version is correct.
Claude проанализирует конфликтующее содержимое и выберет подходящую версию на основе контекста проекта или предложит решение.
2. Ручное вмешательство при сложных конфликтах
Когда конфликт слишком сложен, Claude объяснит вам плюсы и минусы каждого варианта:
这个冲突涉及架构设计,你来决定保留哪个方案: A. 保留我们的实现... B. 保留引入的优化...
Claude Code отобразит изменения и запросит ваше подтверждение перед внесением любых изменений в файлы. Для высокорисковых операций, таких как конфликты слияния, особенно важно внимательно проверять каждое изменение.
Параллельный рабочий процесс с Git Worktree
Git Worktree позволяет работать с разными ветками в разных каталогах одновременно без переключения веток или клонирования репозитория. Это один из самых мощных способов параллельной работы в Claude Code.
1. Создание worktree с Claude
Указание worktree при запуске Claude:
claude --worktree feature-auth
Это автоматически:
- В
.claude/worktrees/feature-auth/Создаст новый каталог - На основе
origin/HEADСоздаст новую ветку от (удалённой ветки по умолчанию) - Запустит независимую сессию Claude в новом каталоге
Открыть несколько worktree одновременно:
claude --worktree bugfix-123
claude --worktree
Если имя не указано, Claude автоматически сгенерирует интересные имена (например,bright-running-fox)。
2. Свойства worktree
| Свойство | Значение |
|---|---|
| Расположение | <repo>/.claude/worktrees/<name> |
| Именование веток | worktree-<name> |
| Базовая ветка | Удалённый репозиторийorigin/HEADВетка, на которую он указывает |
3. Жизненный цикл Worktree
| Сценарий | Поведение |
|---|---|
| Изменения не внесены | Worktree и ветка автоматически удаляются |
| Есть изменения или коммиты | Claude предлагает выбрать: сохранить или удалить |
| Осиротевший worktree, вызванный сбоем Claude | ПревышаетcleanupPeriodDaysАвтоматически удаляется через заданное количество дней |
4. Копирование .gitignore в Worktree
Создайте в корневом каталоге проекта.worktreeincludeфайл, указывающий файлы gitignore для копирования в worktree:
.env .env.local config/secrets.json
Будут скопированы только соответствующие шаблонуифайлы, игнорируемые gitignore.
5. Ручное управление worktree
Если вам нужен больший контроль, вы можете управлять вручную:
# 创建 worktree 并指定分支 git worktree add ../project-feature-a -b feature-a # 使用已有分支创建 worktree git worktree add ../project-bugfix bugfix-123 # 在 worktree 中启动 Claude cd ../project-feature-a && claude # 完成后清理 git worktree list git worktree remove ../project-feature-a
Рекомендуется добавить
.claude/worktrees/добавить в.gitignore, чтобы содержимое worktree не отображалось как неотслеживаемые файлы в основном репозитории.
Изоляция worktree для субагентов
Субагенты могут использовать функцию изоляции worktree для полностью независимой параллельной работы:
Способ 1: позволить Claude сделать это автоматически
让子代理使用 worktree 来并行处理这些任务
Способ 2: указать в конфигурации субагента
Пример
name: experimental-refactor
description: Попробуйте подход к рефакторингу в изолированном worktree
isolation: worktree # Запуск во временном worktree
инструменты: Read, Write, Edit, Bash
---
Вы можете свободно изменять в изолированной среде, не затрагивая основную ветку.
После завершения обобщите изменения и укажите, был ли подход успешным.
Возможности рабочего дерева субагента
- Каждый субагент автоматически получает независимое рабочее дерево
- Рабочее дерево автоматически очищается после завершения задачи
- Изменения не влияют на основной репозиторий
- Подходит для исследовательских задач и сравнения подходов
Рабочий процесс Pull Request
1. Шаги по созданию PR
Шаг 1: Попросите Claude обобщить изменения
Summarize the changes I made to the authentication module.
Шаг 2: Сгенерировать PR
创建一个 PR
Шаг 3: Уточните описание PR
在 PR 描述中补充更多关于安全改进的内容
2. Связывание сессии с PR
Использованиеgh pr createПри создании PR сессии Claude автоматически связываются с этим PR:
- После того как сессия связана с PR, вы можете возобновить беседу из PR
- Использование
claude --from-pr <number>Возобновите связанную сессию
3. Использование GitHub CLI
Claude знает, как использоватьghCLI-инструмент. Если не установленgh, Claude может читать и записывать в GitHub API, но с ограниченной функциональностью.
# Claude 可以执行的操作 gh pr create --title "Fix login bug" gh pr view --comments gh pr diff gh issue create --title "Bug report"
Управление сессиями и интеграция с Git
1. Возобновление предыдущей сессии
| Команда | Функция |
|---|---|
claude --continue |
Продолжите последнюю беседу в текущем каталоге |
claude --resume |
Открыть селектор сессий или возобновить по имени |
claude --from-pr 123 |
Возобновить сессию, связанную с конкретным PR |
2. Git-функции селектора сессий
| Горячая клавиша | Функция |
|---|---|
B |
Фильтровать сессии по текущей ветке git |
3. Отображение метаданных сессии
Селектор сессий отображает следующую информацию:
- Имя сессии или начальный запрос
- Время с момента последней активности
- Количество сообщений
- Ветка Git (если есть)
4. Сессии ветки
Использование/branch、/rewindили--fork-sessionСозданные сессии группируются под корневой сессией для упрощения управления.
Режим планирования и анализ безопасности
Режим планирования использует операции только для чтения, чтобы безопасно анализировать кодовую базу, не выполняя никаких операций записи.
Запуск режима планирования
claude --permission-mode plan
Или выполните одноразовый запрос в сессии:
claude --permission-mode plan -p "分析认证系统并提出改进建议"
Настройка режима по умолчанию в settings.json
Пример
"permissions": {
"defaultMode": "plan"
}
}
Типичные примеры рабочих процессов
Рабочий процесс 1: параллельная разработка нескольких задач
# 场景:同时开发三个功能,但不想切换分支 > 启动三个 worktree,分别处理登录重构、支付集成和性能优化 > 在每个 worktree 中独立工作,完成后合并到主分支
Рабочий процесс 2: процесс исправления ошибок
# 第一步:描述问题 > 用户反馈:用户登出后刷新页面仍然显示已登录 # 第二步:创建修复分支 > 创建一个 bugfix/session-cookie 分支来修复这个问题 # 第三步:分析与修复 > 先分析可能的原因,在 bugfix 分支中修复 # 第四步:提交并创建 PR > 提交修复并创建一个 PR
Рабочий процесс 3: ревью кода
# 审查特定文件 > 帮我审查 src/payment/processor.ts,重点关注错误处理 # 审查 git 改动 > 审查我这次的所有改动,看看有没有明显的问题 # 在独立分支中审查 > 创建一个 worktree 来审查这个重构方案
Рабочий процесс 4: Разработка и проверка функций
# 主会话:实现新功能 > 实现用户资料编辑功能 # 子代理:并行运行测试 > 在子代理中运行所有测试,只返回失败的测试和根因 # 子代理:检查代码规范 > 使用子代理审查代码是否符合项目规范 # 完成后:创建 PR > 创建一个 PR 并添加详细的描述
Системы контроля версий, отличные от Git
Для пользователей SVN, Perforce или Mercurial Claude Code поддерживает расширение через хуки:
Настройка пользовательских хуков
В.claude/settings.jsonНастройте в:
Пример
"hooks": {
"WorktreeCreate": "./scripts/create-worktree.sh",
"WorktreeRemove": "./scripts/remove-worktree.sh"
}
}
Эти хуки заменяют поведение git по умолчанию. При использовании скриптов хуков копируйте локальные файлы конфигурации внутри скрипта вместо использования.worktreeinclude。
Лучшие практики от внутренней команды Anthropic
- Используйте несколько рабочих деревьев: запускайте 3-5 git worktrees одновременно, каждое с независимой сессией — это признанная лучшая практика команды для повышения эффективности
- Сначала планируйте сложные задачи: используйте
planрежим, в котором один Claude пишет план, а другой выступает в роли советника и проверяет его - Обновляйте CLAUDE.md после ошибок: После каждого исправления ошибки добавляйте примечание: "обновите свой CLAUDE.md, не совершайте ту же ошибку снова"
- Войдите в режим планирования специально для этапа проверки: убедитесь, что процесс проверки безопасен и контролируем
Часто задаваемые вопросы
Вопрос: В чём разница между Worktree и ветками?
Worktree — это независимая директория, позволяющая одновременно работать в разных директориях; ветка — это другая история коммитов в той же директории. Worktree лучше подходит для сценариев, когда нужно одновременно решать несколько сложных задач.
Вопрос: Повлияет ли Worktree, созданный Claude, на основной репозиторий?
Нет. Worktree имеет независимую директорию, и его содержимое не повлияет на незакоммиченные изменения в основном репозитории.
Вопрос: Как заставить Claude работать в определённой ветке?
Переключите ветку перед запуском Claude или используйтеclaude --worktree <name>для автоматического создания ветки.
Вопрос: Если создать слишком много Worktree, не займут ли они слишком много места?
Git Worktree использует общую историю репозитория; новая директория содержит только различия веток, поэтому занимает очень мало места.
Вопрос: Когда будет очищен Worktree субагента?
При обычном завершении Claude предложит вам выбрать, сохранить его или удалить. Worktrees, осиротевшие из-за сбоев, будут автоматически удалены по истечении более чемcleanupPeriodDaysзаданного количества дней.