解决 VS Code 中 Claude Code 的 Git Bash 链接问题
问题描述
在 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 环境变量的用户变量部分,检查并删除 CLAUDE_CODE_GIT_BASH_PATH 变量(如果存在)。
将 Git CMD 添加到 PATH
编辑用户变量中的 Path,添加 Git 的 cmd 文件夹路径:
- 用户级安装路径:
%USERPROFILE%\AppData\Local\Programs\Git\cmd - 全局安装路径:
C:\Program Files\Git\cmd
重启 VS Code 完全关闭并重新打开 VS Code,启动 Claude Code 扩展。
验证其他路径配置(若仍无效)
检查 Claude 的 PATH 配置
在 PowerShell 中运行 claude --help,若提示 %USERPROFILE%\.local\bin 未在 PATH 中,则将其添加到用户环境变量的 Path 中。
解决 cygpath 错误
若终端报错 cygpath: command not found,需将 Git 的 usr\bin 路径添加到 Path:
%USERPROFILE%\AppData\Local\Programs\Git\usr\bin
完成上述调整后,重新执行上述步骤。

