Vibe Coding 最佳实践：Claude Code 检查点回溯与 Git 自动存档每轮对话

在 vibe coding 过程中，经常遇到这样的场景：

修改失控 : Claude 修改了多个文件，但效果不尽如人意，我们想回溯到本轮对话之前的状态
代码审计: 你需要记录 Claude 每一轮的修改细节，以便后续进行 Code Review

针对这两个需求，可以结合使用 Claude checkpointing（原生检查点） 与 Git 自动化钩子

版本: claude code: 2.0.75

检查点

Claude Checkpointing 回滚
- 双重回滚 ：当你使用 /rewind 或恢复检查点时，它不仅会将文件恢复到之前的状态，还会让 Claude "忘记" 刚才的对话。
- 上下文同步：这保证了 AI 的记忆与当前文件状态是完全同步的
Git 回滚
- 单向回滚 ：如果你在对话中途手动执行 git reset 回滚代码，Claude 依然记得它刚才修改了代码。
- 脑裂风险：此时 AI 的记忆（Context）显示代码已修改，但文件系统（Files）显示代码未修改。这会导致 Claude 产生幻觉，或者在后续修改中覆盖掉你的回滚

	检查点	Git
主要用途	实验与纠错。 "Claude 你刚才改乱了，回到两分钟前重新试一次。"	存档与日志。 "我完成了这部分功能，先存个档，以防万一。"
回滚范围	文件 + AI 记忆 (Context Window)	仅文件 (Filesystem)
持久性	临时。通常随会话结束或时间推移被清理	永久。保存在 .git 历史中，随时可以找回。
可读性	较差。主要用于机器回滚，用户很难直观看到差异	极佳。可以通过 git log 或 GUI 工具查看详细 Diff。
外部访问	仅能在 Claude Code 终端内访问。	可以在 VS Code、GitHub、其他 IDE 中访问。

Git 自动化钩子

1. 工作原理

利用 Stop 钩子，在 Claude 完成一轮对话或任务后 自动触发。
执行 commit_per_turn.sh 脚本。
脚本逻辑：
- 检测并初始化 Git 仓库（如果不存在）。
- 检测是否有文件变动（无变动则跳过）。
- 自动切换或创建 claude 专属分支（避免污染主分支）。
- 生成变更摘要并提交

2. 修改配置文件 (settings.json)

在 Claude Code 的配置文件 (~/.claude/settings.json) 中添加如下 Hook：

json 复制代码

"hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "command": "~/.claude/hooks/commit_per_turn.sh",
            "type": "command"
          }
        ],
        "matcher": ""
      }
    ]
  }

3. 自动化脚本 (commit_per_turn.sh)

创建脚本并赋予执行权限 (chmod +x commit_per_turn.sh)

bash 复制代码

#!/bin/bash

# --- 配置 ---
BRANCH_NAME="claude"
# ------------

# 1. 确保 Git 仓库存在
if ! git rev-parse --is-inside-work-tree > /dev/null 2>&1; then
    echo "📦 初始化 Git 仓库..."
    git init
    git commit --allow-empty -m "Initial commit" > /dev/null 2>&1
fi

# 2. 检查是否有文件变动 (包括未追踪的文件)
if [ -z "$(git status --porcelain)" ]; then
    # 没有文件变动，直接退出，不产生空提交
    exit 0
fi

# 3. 确保在 claude 分支
CURRENT_BRANCH=$(git symbolic-ref --short HEAD 2>/dev/null)
if [ "$CURRENT_BRANCH" != "$BRANCH_NAME" ]; then
    if git show-ref --verify --quiet refs/heads/$BRANCH_NAME; then
        git checkout $BRANCH_NAME > /dev/null 2>&1
    else
        echo "🌱 创建 claude 分支..."
        git checkout -b $BRANCH_NAME > /dev/null 2>&1
    fi
fi

# 4. 添加所有文件
git add .

# 5. 生成概要总结 (关键步骤)
# 获取简短的统计信息，例如: " file1.py | 2 +- \n file2.js | 5 +++++"
# 处理输出变成单行: "file1.py (2), file2.js (5)"
SUMMARY=$(git diff --cached --stat --format=oneline | head -n -1 | awk '{print $1}' | paste -sd ", " -)

# 组合最终提交信息
COMMIT_MSG="Claude Update: Modified [${SUMMARY}]"

# 如果信息太长，进行截断
if [ ${#COMMIT_MSG} -gt 150 ]; then
    COMMIT_MSG="${COMMIT_MSG:0:147}..."
fi

# 6. 提交
git commit -m "$COMMIT_MSG" > /dev/null 2>&1

echo "✅ [自动备份] 已提交变更到 $BRANCH_NAME 分支: $COMMIT_MSG"

建议:

关于 .gitignore：由于脚本执行的是 git add .，请务必确保你的项目根目录下有配置良好的 .gitignore 文件，防止 node_modules / 虚拟环境等临时文件被意外提交