---

title: Git 集成实战完全指南（一）Claude Code 与 Git 的基础集成
date: 2026-07-10
category: AI 开发工具
tags: [Claude Code, Git, 集成, 入门, 版本控制]

Git 集成实战完全指南（一）：Claude Code 与 Git 的基础集成

Claude Code 不只是个聊天机器人——它能直接操作 Git。从查看状态到提交代码，从创建分支到生成 PR，本篇带你掌握 Claude Code + Git 的最基础集成方式。

前言

在传统开发流程中，Git 操作是纯手动的：

git status
git add .
git commit -m "fix: xxx"
git push
git checkout -b feature/xxx

每一步都需要切到终端、敲命令、确认结果。如果用 Claude Code，你只需要说：

帮我看看当前有什么改动
帮我提交这些改动

Claude 会自动执行对应的 Git 命令，告诉你结果。如果遇到问题，它会自己解决。

一、Claude Code 中的 Git 能力

1.1 核心 Git 操作

Claude Code 支持以下 Git 相关操作：

操作	自然语言指令	Bash 命令
查看状态	“当前有什么改动？”	git status
查看差异	“看看我改了哪些文件”	git diff
添加文件	“把所有改动加进去”	git add .
提交	“提交这些改动，信息是 xxx”	git commit -m "xxx"
推送	“推送到远程”	git push
创建分支	“创建一个新分支 xxx”	git checkout -b xxx
切换分支	“切到 main 分支”	git checkout main
查看日志	“最近的提交记录”	git log --oneline -10

1.2 Git 操作的权限

Claude Code 执行 Git 命令需要你的授权。根据操作的风险等级：

低风险（只读）：git status, git diff, git log
  → 自动执行，无需确认

中风险（写入工作区）：git add, git commit
  → 首次需要确认，之后自动执行

高风险（远程操作）：git push, git pull, git merge
  → 每次都需要确认

你可以通过 settings.json 配置权限，减少确认弹窗：

{
  "permissions": {
    "Bash": {
      "git status": "allow",
      "git diff": "allow",
      "git add": "allow",
      "git commit": "allow",
      "git push": "ask",
      "git pull": "ask"
    }
  }
}

二、实战：用自然语言管理 Git

2.1 查看当前状态

当前分支是什么？有什么未提交的改动？

Claude 执行：

git branch --show-current
git status

输出：

当前分支：develop
未提交的改动：
  M  src/views/UserList.vue
  M  src/api/user.ts
  A  src/types/user.ts

2.2 查看具体改动

看看 UserList.vue 改了什么

Claude 执行：

git diff src/views/UserList.vue

输出 diff 内容，并用自然语言总结：

UserList.vue 的主要改动：
1. 新增了搜索框组件（L12-L25）
2. 表格新增了"状态"列（L45-L52）
3. 修复了分页组件的 pageSize 绑定错误（L78）

2.3 智能提交

帮我提交这些改动

Claude 会自动：

1. 分析 git diff 的内容
2. 生成符合约定式提交（Conventional Commits）信息的 commit message
3. 执行 git add 和 git commit

正在分析改动...
检测到以下变更：
  - UserList.vue：新增搜索功能、状态列
  - user.ts：新增搜索 API
  - user.ts：新增类型定义

生成提交信息：
  feat: 用户列表页新增搜索功能和状态列

确认提交？（是的/修改信息/取消）

2.4 约定式提交信息

Claude Code 支持约定式提交格式：

feat:     新功能
fix:      Bug 修复
docs:     文档变更
style:    代码格式（不影响功能）
refactor: 重构
test:     测试相关
chore:    构建/工具变更

你可以指定提交类型：

用 fix 类型提交这些改动

Claude 会生成：

git commit -m "fix: 修复分页组件 pageSize 绑定错误"

2.5 推送代码

推送到远程 develop 分支

Claude 执行：

git push origin develop

如果需要 SSH 认证或 Two-Factor Auth，Claude 会提示你手动完成。

三、Git 工作区管理

3.1 理解工作区状态

Claude Code 可以帮你理解 Git 的四种状态：

工作区（Working Directory）   → 你修改的文件
暂存区（Staging Area）        → git add 后的文件
本地仓库（Local Repository）  → git commit 后的文件
远程仓库（Remote Repository） → git push 后的文件

对话示例：

我的改动都提交了吗？

Claude 回答：

已提交：
  - src/utils/http.ts（3 天前）
  - src/router/index.ts（2 天前）

未提交的改动：
  - src/views/UserList.vue（今天修改）
  - src/api/user.ts（今天修改）

未跟踪的新文件：
  - src/types/user.ts（新建）

3.2 暂存与取消暂存

只提交 UserList.vue 的改动，user.ts 先不改

Claude 执行：

git add src/views/UserList.vue
git commit -m "feat: 用户列表页新增搜索功能和状态列"
# user.ts 保持未暂存状态

撤回刚才的暂存

Claude 执行：

git reset HEAD src/views/UserList.vue

四、Git 分支管理

4.1 创建分支

基于 main 创建一个新功能分支，叫 feature/user-search

Claude 执行：

git checkout main
git pull origin main
git checkout -b feature/user-search

4.2 智能分支命名

如果你没说分支名，Claude 会根据改动内容自动生成：

帮我开个分支开发用户搜索功能

Claude 会建议：

根据您的需求，建议分支名：
  feature/user-search

确认使用这个分支名？（是的/自定义）

4.3 切换分支

切回 main 分支

Claude 会先检查当前分支是否有未提交的改动：

当前 feature/user-search 分支有未提交的改动：
  M  src/views/UserList.vue

选项：
1. 先提交再切换
2. 暂存改动（stash）再切换
3. 强制切换（丢弃未提交的改动）

4.4 查看分支关系

看看当前分支和 main 差了多少

Claude 执行：

git log main..HEAD --oneline
git diff main...HEAD --stat

输出：

当前分支比 main 多了 5 个提交：
  a1b2c3d feat: 新增用户搜索功能
  e5f6g7h fix: 修复搜索框样式
  i8j9k0l refactor: 抽取搜索逻辑为 composable
  m1n2o3p test: 添加搜索功能单元测试
  q4r5s6t docs: 更新 API 文档

文件变更统计：
  新增 2 个文件，修改 5 个文件，共 +342 -56 行

五、Git 日志与历史

5.1 查看提交历史

最近 10 次提交

Claude 执行：

git log --oneline -10

输出：

a1b2c3d (HEAD -> feature/user-search) docs: 更新 API 文档
e5f6g7h test: 添加搜索功能单元测试
i8j9k0l refactor: 抽取搜索逻辑为 composable
m1n2o3p fix: 修复搜索框样式
q4r5s6t feat: 新增用户搜索功能
...

5.2 查看某个文件的修改历史

UserList.vue 是谁改的？最近一次改了什么？

Claude 执行：

git log -5 --oneline -- src/views/UserList.vue
git show HEAD -- src/views/UserList.vue --stat

输出：

最近 5 次修改 UserList.vue 的记录：

1. a1b2c3d - 张三 - 更新搜索功能（2 小时前）
   变更：+25 -8 行

2. e5f6g7h - 李四 - 添加状态列（昨天）
   变更：+12 -0 行

3. i8j9k0l - 王五 - 重构表格组件（3 天前）
   变更：+45 -60 行

5.3 查找引入 Bug 的提交

这个搜索框的 bug 是什么时候引入的？

Claude 可以用 bisect 帮你找：

# 已知 good commit 和 bad commit
git bisect start
git bisect bad HEAD
git bisect good a1b2c3d
# 中间自动二分查找...

六、这一章的核心心得

1. Claude Code 能直接执行 Git 命令——用自然语言描述，不需要记命令
2. 支持完整的 Git 工作流——status、diff、add、commit、push、branch、log
3. 智能提交信息——自动分析改动内容，生成约定式提交信息
4. 权限分级——只读操作自动执行，写入和远程操作需要确认
5. 分支管理自动化——创建、切换、比较分支都可以用自然语言
6. 历史追踪——查看文件修改历史、查找引入 bug 的提交

七、下一步

掌握了基础 Git 操作后，下一篇我们将学习更高级的主题：智能分支管理。包括分支策略、自动分支创建、分支合并冲突预防等。

---

系列目录：

1. Claude Code 与 Git 的基础集成——自然语言操作 Git ← 本篇
2. 智能分支管理——分支策略、自动创建、合并预防（待写）
3. 自动化 Commit 与 PR——生成提交信息、创建 Pull Request（待写）
4. Git 冲突解决——合并冲突的自动检测与修复（待写）
5. Git Blame 与历史追踪——追溯代码变更的来龙去脉（待写）
6. Git 标签与版本管理——Release 流程自动化（待写）
7. Git 钩子自动化——pre-commit、pre-push 自动执行（待写）
8. Git 团队协作最佳实践——PR Review、Code Review 流程（待写）