Intégration Git

Problème : Tu as enveloppé un lot de modifications avec Claude Code et maintenant le diff est là, non stagé, et tu as besoin que l'historique soit lisible.

Victoire rapide : Une fois que Claude a terminé le travail, demande un commit en langage naturel :

claude "commit these changes"

Le diff est lu, un vrai message de commit est écrit, et git commit tourne en ton nom. Pas de fausse configuration, pas de plugins, rien à installer.

Les commandes git tournent directement dans ton terminal quand Claude Code est ouvert. Il n'y a pas de mode "auto-commit" à basculer et rien à brancher. Tu demandes, ça se fait.

Voilà ce que Claude gère :

Exécuter n'importe quelle commande git : add, commit, push, pull, branch, merge
Écrire des messages de commit : Basés sur les vraies modifications effectuées
Créer des branches : Pour des fonctionnalités ou des expérimentations
Créer des PRs : Via le CLI gh si installé
Résoudre les conflits : En lisant les deux versions et en fusionnant intelligemment

Comme Claude peut voir l'historique git et suivre le fil de ton travail, les messages de commit décrivent ce qui a vraiment changé et pourquoi.

Définis les conventions dans CLAUDE.md

Oublie les fausses commandes de configuration. Mets les règles de commit de ton équipe dans CLAUDE.md à la place :

## Git Conventions
 
- Use conventional commits: feat:, fix:, docs:, refactor:
- Keep subject lines under 72 characters
- Always run tests before committing
- Create feature branches for new work

Demande un commit après ça et Claude s'aligne sur ce que tu as écrit.

Workflows git réels

Commit simple après des modifications

# Claude just finished implementing a feature
claude "commit these changes"
 
# Or be more specific
claude "commit with message: add user authentication flow"

Workflow de branche de fonctionnalité

# Start new work on a branch
claude "create a feature branch called auth-improvements and switch to it"
 
# Make changes, then commit
claude "commit the auth changes with a descriptive message"
 
# When ready, create a PR
claude "push this branch and create a PR with a summary of changes"

Revue avant de committer

# See what changed first
claude "show me a summary of all uncommitted changes"
 
# Then commit selectively
claude "commit only the changes in src/auth/ with message: refactor auth module"

Les commits et PRs de Claude portent une attribution par défaut, pour que ton équipe (et toi dans le futur) puisse voir quel travail a été assisté par IA. Ce qui apparaît dans le message est géré par la clé attribution dans settings.json.

Attribution par défaut

Les commits reçoivent deux lignes ajoutées :

Generated with Claude Code (https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply>

La première ligne est du texte brut. La seconde est un trailer git, un format que GitHub (et d'autres hébergeurs) analyse pour faire apparaître Claude comme co-auteur du commit.

Pour les pull requests, l'attribution arrive comme un court blurb dans la description :

Generated with Claude Code (https://claude.com/claude-code)

Personnaliser l'attribution

L'attribution des commits et des PRs a chacune sa propre clé dans settings.json :

{
  "attribution": {
    "commit": "Generated with AI\n\nCo-Authored-By: AI Assistant <your-ai-alias>",
    "pr": "AI-assisted PR"
  }
}

Réécris le corps du texte, le nom et l'email du Co-Authored-By, ou chaque partie à la fois. Le \n\n est ce qui sépare le message du bloc de trailer, et le format des trailers git l'exige.

Désactiver l'attribution

Une chaîne vide sur l'une ou l'autre clé désactive la ligne :

{
  "attribution": {
    "commit": "",
    "pr": ""
  }
}

Ça masque l'attribution sur les commits, les PRs, ou les deux. Pratique pour les équipes qui loggent l'usage de l'IA ailleurs.

Migration depuis includeCoAuthoredBy

L'ancien booléen includeCoAuthoredBy est en cours de retrait. Si tu avais "includeCoAuthoredBy": false, migre vers attribution :

// Old (deprecated)
{ "includeCoAuthoredBy": false }
 
// New (recommended)
{
  "attribution": {
    "commit": "",
    "pr": ""
  }
}

Un contrôle plus fin découle du nouveau paramètre. L'attribution des commits peut être désactivée pendant que celle des PRs reste active, ou l'inverse. Ajoute le bloc dans la portée que tu veux couvrir, que ce soit utilisateur, projet, ou local.

Quand ça tourne mal

Erreur : "nothing to commit". Correction : soit Claude a déjà exécuté le commit, soit les fichiers n'ont jamais été ajoutés à l'index. Demande à Claude de vérifier :

claude "what's the current git status?"

Erreur : "permission denied" sur push. Correction : le remote demande une auth. Les identifiants ne sont pas quelque chose que Claude peut fournir pour toi, mais il peut t'aider à diagnostiquer :

claude "help me debug this git push error"

Erreur : Conflits de merge. Correction : Claude peut les résoudre :

claude "there are merge conflicts in auth.js - resolve them keeping our new changes"

Prochaines étapes

Boucles de feedback pour itérer plus vite
Workflows todo pour suivre le travail
Modes de planification pour les changements complexes
Référence des paramètres pour l'attribution et d'autres options
Optimisation de l'utilisation pour gérer les coûts

Git dans Claude Code n'a pas d'étape de configuration. Dis à Claude le mouvement git dont tu as besoin, et les commandes s'exécutent. C'est tout le secret.