# git bisect 配 Claude 自动揪出坏提交：让无头模式当"语义法官" ## 概述 当你知道"线上坏了"，却不知道是过去几百次提交里的哪一次把代码改坏了，`git bisect` 是标准答案——但它需要一个能自动判定"这个版本好还是坏"的脚本。传统做法是手写一个复现用例，可一旦回归是"输出语气不对""布局错位""某个边界语义错了"这类难以量化的 bug，脚本根本写不出来。本教程教你把 Claude Code 的 `-p` 无头模式塞进 `git bisect run`，让大模型充当**语义法官**：每个被二分到的提交，自动读代码、按 bug 描述判定好坏、吐出结构化结论，最终无人值守地定位到那一个"罪魁祸首"提交。适合已熟悉 Git 基本操作、想把 Claude Code 接进 CI 与自动化排查流程的后端/前端工程师与 SRE。 ## 前置条件 - **Git ≥ 2.30**：本机已安装 `git`，熟悉 `commit / log / checkout` 基本命令，对 `git bisect` 有概念性了解即可（本教程会带一遍）。 - **Claude Code ≥ v2.1**：已通过 `claude` 命令可用，已完成登录或配置了 `ANTHROPIC_API_KEY`。用 `claude --version` 确认。 - **bash + jq**：判定脚本用 `jq` 解析 JSON 输出，`jq --version` 能跑即可；Windows 用户建议在 Git Bash 或 WSL 下操作。 - **一个有回归的仓库**：最好是你手头真实的、能确认"某个旧 tag 是好的、当前 HEAD 是坏的"的项目。本教程也提供一个 5 分钟可造好的迷你案例用于练手。 - **预算意识**：二分大约需要 `log₂(N)` 次模型调用。100 个提交区间约 7 次调用、1000 个约 10 次，成本可控；但每次调用都会把当前代码读进上下文，大型仓库建议先用 `--add-dir` 或子目录限定范围。 --- ## 正文 ### 步骤 1：理解"二分 + 法官"的工作原理 `git bisect` 在好提交（good）和坏提交（bad）之间做二分搜索：每次 checkout 到中点，由你（或一个脚本）告诉它"这个版本是好是坏"，它再砍一半，直到锁定**第一个**引入回归的提交。`git bisect run