Windows 上 Claude Code 报错 “requires git-bash“ 的完整解决方案

Windows 上 Claude Code 报错 “requires git-bash” 的完整解决方案Claude Code 在 Windows 上依赖 Git Bash 作为 Shell 环境。若系统已安装 Git 但未正确配置启动时会出现如下提示Claude Code on Windows requires git-bash. If installed but not in PATH, set environment variable pointing to your bash.exe, similar to:CLAUDE_CODE_GIT_BASH_PATHC:\Program Files\Git\bin\bash.exe前置确认Git 是否已安装在解决问题前先确认 Git 已正确安装。以管理员身份打开 PowerShell执行git-v若提示命令不识别请先前往 Git 官网 下载安装Git for Windows安装时勾选Add Git to PATH完成后重启终端再继续。方案一将 Git Bash 添加到 PATH推荐这是最彻底的解决方式配置一次、全局生效无需为每个工具单独设置。如果系统种已安装WSL发行版则不推荐此种配置方案因为会造成与WSL的bash冲突这种情况下推荐方案二、方案三。步骤按Win S搜索**“环境变量”**打开系统属性 → 高级 → 环境变量在系统变量中找到Path点击编辑新增一行C:\Program Files\Git\bin全部点击确定保存完全关闭并重新打开VS Code验证where.exe bash# 输出路径即表示配置成功方案二设置CLAUDE_CODE_GIT_BASH_PATH环境变量若不希望修改全局 PATH可单独设置此变量告知 Claude Code bash 的具体位置。方式 A通过系统界面设置打开环境变量窗口同上在用户变量中点击新建变量名CLAUDE_CODE_GIT_BASH_PATH变量值C:\Program Files\Git\bin\bash.exe变量值不要加引号直接填写路径即可。保存后完全重启 VS Code方式 B通过 PowerShell 设置以管理员身份运行 PowerShell执行[System.Environment]::SetEnvironmentVariable(CLAUDE_CODE_GIT_BASH_PATH,C:\Program Files\Git\bin\bash.exe,Machine)设置后仍然提示逐项排查原因一VS Code 未完全重启环境变量在 VS Code启动时读取修改后必须彻底关闭再重开仅刷新窗口无效。原因二环境变量未成功写入在 PowerShell 中验证# 查看用户变量[System.Environment]::GetEnvironmentVariable(CLAUDE_CODE_GIT_BASH_PATH,User)# 查看系统变量[System.Environment]::GetEnvironmentVariable(CLAUDE_CODE_GIT_BASH_PATH,Machine)若两者均返回空说明变量未成功写入请检查权限后重新设置。原因三bash.exe 路径填写错误Test-PathC:\Program Files\Git\bin\bash.exe# 返回 True 才说明路径有效若不确定 Git 的安装位置执行where.exe bashGet-Commandbash-ErrorAction SilentlyContinue常见安装路径路径说明C:\Program Files\Git\bin\bash.exe默认安装路径C:\Git\bin\bash.exe自定义安装路径原因四变量值误加了引号通过系统界面设置时变量值不要加引号C:\Program Files\Git\bin\bash.exe ✓ 正确 C:\Program Files\Git\bin\bash.exe ✗ 错误方案三通过 VS Code settings.json 直接注入若以上方法均无效可绕过系统环境变量直接在 VS Code 配置中指定按Ctrl Shift P搜索Open User Settings (JSON)添加以下配置{terminal.integrated.env.windows:{CLAUDE_CODE_GIT_BASH_PATH:C:\\Program Files\\Git\\bin\\bash.exe}}JSON 中路径分隔符需使用双反斜杠\\。保存后重启 VS Code 即可生效。排查流程速览报错 requires git-bash │ ▼ Git 是否已安装─── 否 ──→ 下载安装 Git for Windows │ 是 │ ▼ bash.exe 路径是否正确─── 否 ──→ 用 where.exe bash 确认路径 │ 是 │ ▼ 环境变量是否已设置─── 否 ──→ 按方案一或方案二配置 │ 是 │ ▼ VS Code 是否完全重启─── 否 ──→ 彻底关闭后重新打开 │ 是 │ ▼ 仍未解决 ──→ 在 VS Code settings.json 中直接配置总结方案适用场景是否需要重启 VS Code添加 Git 到 PATH推荐一劳永逸是设置专用环境变量不想修改全局 PATH是VS Code settings.json系统变量不生效时的兜底是大多数情况下方案一将C:\Program Files\Git\bin加入系统 PATH是最简洁的解决方式。若已按步骤配置但问题持续优先检查 VS Code 是否完全重启以及bash.exe的路径是否真实存在。