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é sur
origin/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
- Utilisation
claude --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: utilisez
planmode 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é.