遇到 VS Code 中 Claude Code 的 Git Bash 报错
在 Windows 环境下使用 VS Code 的 Claude Code 扩展时，偶尔会弹出一个让人头疼的错误提示：
Error: Claude Code on Windows requires git-bash (https://git-scm.com/downloads/win).
明明已经确认安装了 Git，甚至按照官方建议设置了环境变量 CLAUDE_CODE_GIT_BASH_PATH，问题依然存在。这通常是因为 Windows 的路径解析机制与工具链检测逻辑发生了冲突。
核心解决思路
1. 清理干扰的环境变量
有时候显式指定的环境变量反而会覆盖系统的自动检测。请打开 Windows 用户环境变量设置，检查是否存在 CLAUDE_CODE_GIT_BASH_PATH。如果存在，直接将其删除，让程序尝试通过系统 PATH 自动寻找。
2. 将 Git CMD 加入系统 PATH
这是最关键的一步。编辑用户变量中的 Path，添加 Git 安装目录下的 cmd 文件夹路径。根据你的安装方式，通常是以下两者之一：
- 普通用户安装：
%USERPROFILE%\AppData\Local\Programs\Git\cmd - 全局安装：
C:\Program Files\Git\cmd
3. 重启编辑器生效 修改完环境变量后，必须完全关闭并重新打开 VS Code，确保新环境被加载。再次启动 Claude Code 扩展，通常就能正常识别了。
进阶排查（若仍无效）
如果上述步骤完成后依然报错，或者终端提示 cygpath: command not found，则需要补充更多路径：
- 检查 Claude 自身路径：在 PowerShell 中运行
claude --help，若提示%USERPROFILE%\.local\bin未在 PATH 中，请将其添加到用户环境变量的Path里。 - 解决 Cygpath 错误：将 Git 的
usr\bin路径也补进Path，例如%USERPROFILE%\AppData\Local\Programs\Git\usr\bin。
完成这些调整后，重新执行一遍前面的步骤即可。