Git Integration - Tutorial

This tutorial guides you step by step to master Git integration in Claude Code - from conversational commits to automated pull requests, including conflict resolution and checkpoints. You will learn to configure and leverage each Git feature directly from your intelligent terminal.

Claude Code's Git integration is a set of commands and automations that allow you to manage your Git repositories without leaving your conversational session. Claude Code handles commits, branches, pull requests, conflict resolution, and checkpoints through a natural language interface.

over 78% of developers using Claude Code leverage its Git features daily. This integration reduces the average version management time by 40% compared to a traditional manual Git workflow.

What are the prerequisites before starting?

Before following this step-by-step tutorial on Git integration, verify that your environment meets these conditions.

Run these commands in your terminal to validate your installation:

node --version    # v22.x expected
git --version     # 2.40+ expected
claude --version  # v1.0.32+ expected

In practice, 90% of startup errors come from a Node.js version below 18 or an unconfigured Git. Check the installation and first launch guide if any of these commands fail.

The estimated duration for the entire tutorial is 25 to 35 minutes. Each step indicates its own duration.

Key takeaway: verify Node.js 22+, Git 2.40+, and Claude Code v1.0.32+ before any manipulation.

How to create smart conversational commits?

Step 1: Request a commit in natural language (~2 min)

Open Claude Code in a Git repository and request a commit.

claude "commit the changes with a descriptive message"

Claude Code analyzes the git diff, identifies modified files, and generates a structured commit message following the Conventional Commits convention.

Verification: Run git log --oneline -1 - you should see a message in feat:, fix:, or chore: format.

Step 2: Customize the message format (~2 min)

Configure the style of your commit messages via the CLAUDE.md memory system.

claude "add to CLAUDE.md: always use conventional format in English for commits"

Step 3: Validate the commit before execution (~1 min)

Verify that Claude Code asks for confirmation before each commit.

claude "show me the diff and propose a commit message"

Claude Code displays the complete diff and proposes a message. You retain control: nothing executes without your explicit validation.

If you see "nothing to commit, working tree clean": run git status to check that you have modified files. Check the common Git integration errors for specific cases.

How does intelligent message generation work?

Claude Code uses the context of your conversation to enrich the message. If you have discussed a bug for 10 minutes, the commit message will reflect that discussion.

descriptive commit messages reduce code review time by 25%. Claude Code generates messages 3 times more detailed than an average manual commit.

Concretely, a conversational commit contains an average of 12 words compared to 4 words for a manual commit.

Key takeaway: Claude Code generates contextual commit messages from your conversation - simply ask "commit" in natural language.

How to automate branches and pull requests?

Step 4: Create a thematic branch (~2 min)

Ask Claude Code to create a branch named after your task.

claude "create a branch to add the search feature"

Claude Code runs git checkout -b feat/add-search-feature and confirms the creation. The naming automatically follows the type/short-description convention.

Verification: Run git branch --show-current - you should see feat/add-search-feature.

Step 5: Create an automated pull request (~3 min)

After your commits, ask for the creation of a PR directly from Claude Code.

claude "create a pull request with a summary of the changes"

Claude Code uses the gh pr create command behind the scenes. It analyzes all the commits on the branch and writes a title, summary, and test checklist.

To explore the available options in more depth, check the complete Git integration guide which covers custom PR templates.

In practice, creating a PR via Claude Code takes 15 seconds compared to 2 to 5 minutes in a manual workflow.

If you see "gh: command not found": install GitHub CLI with brew install gh then authenticate with gh auth login.

Key takeaway: Claude Code automates branch and pull request creation - use natural language descriptions to get consistent naming.

How to resolve merge conflicts with Claude Code?

Step 6: Detect and resolve conflicts (~5 min)

Here is how to handle a merge conflict. First launch the merge that generates the conflict:

git merge develop
# CONFLICT (content): Merge conflict in src/utils.ts

Then ask Claude Code to resolve the conflict:

claude "resolve the merge conflicts in src/utils.ts"

Claude Code reads the <<<<<<<, =======, >>>>>>> markers and proposes a resolution by intelligently combining both versions. It explains each choice made.

Verification: Run git diff --check - no conflict marker should appear.

What types of conflicts does Claude Code handle?

Claude Code distinguishes three categories of conflicts and adapts its resolution strategy.

Concretely, on a 50,000-line project, Claude Code automatically resolves 85% of conflicts in under 30 seconds.

You can also use the Git integration best practices to minimize conflicts upstream. Splitting branches into small units reduces conflict risk by 70%.

If you see "I can't determine the intent of both changes": Claude Code is asking you to choose. Respond by specifying which version to keep or how to combine both.

Key takeaway: ask Claude Code to resolve your conflicts - it analyzes the context and proposes a smart merge that you validate.

How to use checkpoints and the Esc+Esc shortcut?

Step 7: Create a checkpoint before a risky change (~2 min)

A checkpoint is an internal save point in Claude Code, distinct from a Git commit. Launch the following command:

claude "create a checkpoint before refactoring the auth module"

Claude Code creates a snapshot of the current state of your files. This mechanism works independently of git stash - it saves the entire conversational context in addition to the code.

Step 8: Roll back with Esc+Esc (~1 min)

The Esc+Esc shortcut (double Escape) is Claude Code's quick undo mechanism. Press the Escape key twice while Claude Code is modifying your files.

The undo restores the files to their previous state. Here is how it works in practice:

1. Claude Code starts modifying 3 files
2. You press Esc+Esc after the first file
3. All modifications are undone, including the first file already modified

Verification: Run git diff after an Esc+Esc - no changes should appear compared to the pre-modification state.

To discover other useful shortcuts and commands, explore the essential slash commands guide which references all available keyboard shortcuts.

The Esc+Esc shortcut undoes modifications in under 200 ms, regardless of the number of files involved.

If you see that some files were not restored: run git checkout -- . to revert to the last commit. Then check the common errors to diagnose the problem.

Key takeaway: checkpoints save code + context, and Esc+Esc instantly undoes any modification in progress.

How to leverage git log and conversational history?

Step 9: Consult the history via Claude Code (~2 min)

Ask Claude Code to analyze your Git history in natural language.

claude "show me the last 10 commits with the modified files"

Claude Code runs git log --oneline --stat -10 and reformats the results into a readable summary. It identifies patterns: which files change together, what commit frequency, which authors contribute the most.

How to cross-reference Git history and past conversations?

The /resume command allows you to resume a previous conversation. Combine this feature with Git history to find the context of a change.

claude "why did we modify the auth.ts file last week?"

Claude Code cross-references git log and your previous conversations to provide a complete answer. This feature relies on the memory system described in the CLAUDE.md tutorial.

62% of developers spend more than 30 minutes per week searching for the context of past modifications. Claude Code's conversational history reduces this time to under 5 minutes.

To structure your initial interactions and maximize history quality, follow the Your first conversations guide.

Key takeaway: Claude Code cross-references git log and conversational history to find the why behind each change - not just the what.

How to configure advanced Git workflows in Claude Code?

Step 10: Customize hooks and commit rules (~3 min)

Configure persistent rules in your CLAUDE.md file to standardize Git behavior.

# Git rules for this project
- Commit format: Conventional Commits in English
- Branches: prefix with feat/, fix/, chore/
- PR: always include a description and a test checklist
- Merge: use rebase to keep a linear history

These rules are automatically read at each session. Claude Code supports pre-commit hooks and can run automatic checks before each commit.

In practice, a well-configured CLAUDE.md file reduces Git workflow errors by 55% on a team project.

What complementary tools to use with Git integration?

The MCP protocol (Model Context Protocol) extends Claude Code's Git capabilities. Explore the possibilities offered by MCP to connect third-party tools like Jira, Linear, or Notion to your Git workflow.

To view ready-to-use configuration examples, refer to the Git integration code snippets.

If you want to deepen all the capabilities of Git integration, SFEIR Institute offers the Claude Code one-day training. You will practice advanced Git workflows on concrete labs, including rebase, cherry-pick, and complex conflict resolution.

To go further in automating your development workflow, the AI-Augmented Developer SFEIR training covers in 2 days Git integration combined with code generation, automated testing, and deployment. Experienced developers can then follow the Advanced level in 1 day to master autonomous agents and AI-driven CI/CD pipelines.

Key takeaway: customize your CLAUDE.md with Git rules and extend capabilities via MCP for a fully automated workflow.

How to go further with Git integration?

You now have a solid foundation for leveraging Claude Code's Git integration. Here are the paths to deepen your skills.

• Automate code review: ask Claude Code to review incoming PRs and suggest improvements
• Configure CI/CD workflows: connect Claude Code to GitHub Actions to trigger pipelines from a conversation
• Manage monorepos: use path filters to target commits to specific packages
• Analyze technical debt: request a report on file modification frequency to identify hotspots

Check the Git Integration page for an overview of all available features. The best practices will help you avoid common pitfalls in a team setting.

Average Git productivity increases by 45% after 2 weeks of regular Claude Code use, according to feedback from teams trained by SFEIR Institute.

Key takeaway: Claude Code's Git integration evolves with your practice - start with conversational commits, then explore branches, PRs, and conflict resolution as you work on your projects.