Workflow Git de Claude Code

Claude Code intègre profondément les fonctionnalités Git, vous permettant d'effectuer presque toutes les opérations Git en langage naturel, notamment créer des commits, gérer des branches, gérer les conflits de fusion et tirer parti de Git Worktree pour des flux de travail parallèles. Ce chapitre présente en détail l'utilisation efficace de Git dans Claude Code.


Opérations Git de base

1. Affichage des modifications

Il vous suffit de demander en langage naturel pour obtenir le statut Git :

Which files did I change?
What does this change include?
最近 10 次提交都改了什么?
检查一下当前的 git 状态

Claude exécutera automatiquement les commandes Git correspondantes et affichera les résultats.

2. Commiter le code

Commit simple :

Commit this change.
Submit this modification.

Commit avec description :

把这次的修改提交,commit 信息说明修复了登录验证的 bug

Claude générera automatiquement un message de commit bien formé en fonction des modifications réelles.

3. Gestion des branches

新建一个 feature/user-profile 分支
切换到 develop 分支
把 main 分支的最新改动合并进来
View all branches.
Delete merged branches.

Gestion des conflits de fusion

1. Résolution automatique des conflits simples

Help me resolve merge conflicts.
This file has conflicts, help me check which version is correct.

Claude analysera le contenu en conflit et sélectionnera la version appropriée en fonction du contexte du projet, ou proposera une solution.

2. Intervention manuelle pour les conflits complexes

Lorsque le conflit est trop complexe, Claude vous expliquera les avantages et les inconvénients de chaque option :

这个冲突涉及架构设计,你来决定保留哪个方案:
A. 保留我们的实现...
B. 保留引入的优化...

Claude Code affichera les modifications et demandera votre confirmation avant d'effectuer toute modification de fichier. Pour les opérations à haut risque comme les conflits de fusion, il est particulièrement important de vérifier attentivement chaque modification.


Workflow parallèle avec Git Worktree

Git Worktree vous permet de travailler sur différentes branches dans différents répertoires simultanément, sans changer de branche ni cloner le dépôt. C'est l'une des méthodes de travail parallèle les plus puissantes dans Claude Code.

1. Création d'un worktree avec Claude

Spécification d'un worktree lors du démarrage de Claude :

claude --worktree feature-auth

Cela va automatiquement :

  • Dans.claude/worktrees/feature-auth/Créer un nouveau répertoire
  • Basé surorigin/HEADCréer une nouvelle branche à partir de (branche par défaut distante)
  • Démarrer une session Claude indépendante dans le nouveau répertoire

Ouvrir plusieurs worktrees simultanément :

claude --worktree bugfix-123
claude --worktree

Lorsqu'aucun nom n'est spécifié, Claude génère automatiquement des noms intéressants (tels quebright-running-fox)。

2. Propriétés des worktrees

Propriété Valeur
Emplacement <repo>/.claude/worktrees/<name>
Nommage des branches worktree-<name>
Branche de base Distantorigin/HEADBranche vers laquelle il pointe

3. Cycle de vie du worktree

Scénario Comportement
Aucune modification effectuée Worktree et branche supprimés automatiquement
Il y a des modifications ou des commits Claude vous invite à choisir de conserver ou de supprimer
Worktree orphelin causé par un crash de Claude DépassecleanupPeriodDaysSupprimé automatiquement après le nombre de jours configuré

4. Copie de .gitignore vers le worktree

Créer dans le répertoire racine du projet.worktreeincludefichier, en spécifiant les fichiers gitignore à copier vers le worktree :

.env
.env.local
config/secrets.json

Seuls ceux correspondant à un motifetles fichiers ignorés par gitignore seront copiés.

5. Gestion manuelle du worktree

Si vous avez besoin de plus de contrôle, vous pouvez gérer manuellement :

# 创建 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

Il est recommandé d'ajouter.claude/worktrees/ajouter à.gitignore, pour éviter que le contenu du worktree n'apparaisse comme des fichiers non suivis dans le dépôt principal.


Isolation du worktree des sous-agents

Les sous-agents peuvent utiliser la fonctionnalité d'isolation de worktree pour réaliser un travail parallèle totalement indépendant :

Méthode 1 : Laisser Claude le gérer automatiquement

让子代理使用 worktree 来并行处理这些任务

Méthode 2 : Spécifier dans la configuration du sous-agent

Exemple

---
name
: experimental-refactor
description
: Essayer une approche de refactoring dans un worktree isolé
isolation
: worktree    # Exécuter dans un worktree temporaire
outils
: Read, Write, Edit, Bash
---

Vous pouvez apporter librement des modifications dans l'environnement isolé sans affecter la branche principale.
Après avoir terminé, résumez les modifications et indiquez si l'approche a été couronnée de succès.

Fonctionnalités des worktrees de sous-agents

  • Chaque sous-agent obtient automatiquement un worktree indépendant
  • Le worktree est automatiquement nettoyé une fois la tâche terminée
  • Les modifications n'affectent pas le dépôt principal
  • Convient aux tâches exploratoires et à la comparaison d'approches

Flux de travail des pull requests

1. Étapes pour créer une PR

Étape 1 : Demandez à Claude de résumer les modifications

Summarize the changes I made to the authentication module.

Étape 2 : Générer une PR

创建一个 PR

Étape 3 : Affiner la description de la PR

在 PR 描述中补充更多关于安全改进的内容

2. Association de session PR

Utilisationgh pr createLors de la création d'une PR, les sessions Claude sont automatiquement liées à cette PR :

  • Une fois qu'une session est liée à une PR, vous pouvez reprendre la conversation depuis la PR
  • Utilisationclaude --from-pr <number>Reprendre la session liée

3. Utilisation de GitHub CLI

Claude sait utiliserghl'outil CLI. S'il n'est pas installégh, Claude peut lire et écrire dans l'API GitHub, mais avec des fonctionnalités limitées.

# Claude 可以执行的操作
gh pr create --title "Fix login bug"
gh pr view --comments
gh pr diff
gh issue create --title "Bug report"

Gestion des sessions et intégration Git

1. Reprise d'une session précédente

Commande Fonction
claude --continue Continuer la conversation la plus récente dans le répertoire courant
claude --resume Ouvrir le sélecteur de session ou reprendre par nom
claude --from-pr 123 Reprendre une session liée à une PR spécifique

2. Fonctionnalités Git du sélecteur de session

Raccourci Fonction
B Filtrer les sessions pour la branche git actuelle

3. Affichage des métadonnées de session

Le sélecteur de session affiche les informations suivantes :

  • Nom de la session ou invite initiale
  • Temps écoulé depuis la dernière activité
  • Nombre de messages
  • Branche Git (le cas échéant)

4. Sessions de branche

Utilisation/branch、/rewindou--fork-sessionLes sessions créées sont regroupées sous la session racine pour faciliter la gestion.


Mode Plan et analyse de sécurité

Le mode Plan utilise des opérations en lecture seule pour analyser la base de code en toute sécurité sans effectuer d’opérations d’écriture.

Démarrage du mode Plan

claude --permission-mode plan

Ou exécutez une requête ponctuelle dans une session :

claude --permission-mode plan -p "分析认证系统并提出改进建议"

Configuration du mode par défaut dans settings.json

Exemple

{
  "permissions": {
    "defaultMode": "plan"
  }
}

Exemples de workflows typiques

Workflow 1 : Développement parallèle de plusieurs tâches

# 场景:同时开发三个功能,但不想切换分支

> 启动三个 worktree,分别处理登录重构、支付集成和性能优化
> 在每个 worktree 中独立工作,完成后合并到主分支

Workflow 2 : Processus de correction de bug

# 第一步:描述问题
> 用户反馈:用户登出后刷新页面仍然显示已登录

# 第二步:创建修复分支
> 创建一个 bugfix/session-cookie 分支来修复这个问题

# 第三步:分析与修复
> 先分析可能的原因,在 bugfix 分支中修复

# 第四步:提交并创建 PR
> 提交修复并创建一个 PR

Workflow 3 : Revue de code

# 审查特定文件
> 帮我审查 src/payment/processor.ts,重点关注错误处理

# 审查 git 改动
> 审查我这次的所有改动,看看有没有明显的问题

# 在独立分支中审查
> 创建一个 worktree 来审查这个重构方案

Workflow 4 : Développement et vérification de fonctionnalités

# 主会话:实现新功能
> 实现用户资料编辑功能

# 子代理:并行运行测试
> 在子代理中运行所有测试,只返回失败的测试和根因

# 子代理:检查代码规范
> 使用子代理审查代码是否符合项目规范

# 完成后:创建 PR
> 创建一个 PR 并添加详细的描述

Systèmes de contrôle de version non Git

Pour les utilisateurs de SVN, Perforce ou Mercurial, Claude Code prend en charge l'extension via des hooks :

Configuration de hooks personnalisés

Dans.claude/settings.jsonConfigurer dans :

Exemple

{
  "hooks": {
    "WorktreeCreate": "./scripts/create-worktree.sh",
    "WorktreeRemove": "./scripts/remove-worktree.sh"
  }
}

Ces hooks remplacent le comportement git par défaut. Lorsque vous utilisez des scripts de hook, copiez les fichiers de configuration locaux à l'intérieur du script plutôt que d'utiliser.worktreeinclude。


Bonnes pratiques de l'équipe interne d'Anthropic

  • Utilisez plusieurs worktrees: exécutez 3-5 worktrees git simultanément, chacun avec une session indépendante — c'est une bonne pratique d'équipe reconnue pour améliorer l'efficacité
  • Planifiez d'abord les tâches complexes: utilisezplanmode consistant à faire rédiger le plan par un Claude et à faire jouer à un autre le rôle de conseiller pour le réviser
  • Mettre à jour CLAUDE.md après les erreurs: Après chaque correction d'erreur, ajoutez une note disant « mettez à jour votre CLAUDE.md, ne refaites pas la même erreur »
  • Passer en mode planification spécifiquement pour la phase de vérification: S'assurer que le processus de vérification est sûr et contrôlable

Questions fréquentes

Q : Quelle est la différence entre Worktree et les branches ?

Worktree est un répertoire indépendant qui vous permet de travailler dans différents répertoires simultanément ; une branche est un historique de commits différent au sein du même répertoire. Worktree est mieux adapté aux scénarios où vous devez gérer plusieurs tâches complexes en même temps.

Q : Le Worktree créé par Claude affectera-t-il le dépôt principal ?

Non. Worktree dispose d'un répertoire indépendant, et son contenu n'affectera pas les modifications non commitées dans le dépôt principal.

Q : Comment puis-je faire travailler Claude sur une branche spécifique ?

Changez de branche avant de démarrer Claude, ou utilisezclaude --worktree <name>pour créer automatiquement une branche.

Q : Le fait d'avoir trop de Worktrees prendra-t-il trop d'espace ?

Git Worktree partage l'historique du dépôt ; le nouveau répertoire ne contient que les différences de branche, donc il occupe très peu d'espace.

Q : Quand le Worktree du sous-agent sera-t-il nettoyé ?

En cas d'achèvement normal, Claude vous invitera à choisir si vous voulez le conserver ou le supprimer. Les Worktrees orphelins en raison de plantages seront automatiquement supprimés après plus decleanupPeriodDaysle nombre de jours configuré.

Autres extensions