遇到 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。
完成这些调整后,重新执行一遍前面的步骤即可。

