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_PATH=C:\Program Files\Git\bin\bash.exe

前置确认：Git 是否已安装

在解决问题前，先确认 Git 已正确安装。以管理员身份打开 PowerShell，执行：

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

验证：

powershell 复制代码

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，执行：

powershell 复制代码

[System.Environment]::SetEnvironmentVariable(
  "CLAUDE_CODE_GIT_BASH_PATH",
  "C:\Program Files\Git\bin\bash.exe",
  "Machine"
)

设置后仍然提示？逐项排查

原因一：VS Code 未完全重启

环境变量在 VS Code 启动时 读取，修改后必须彻底关闭再重开，仅刷新窗口无效。

原因二：环境变量未成功写入

在 PowerShell 中验证：

powershell 复制代码

# 查看用户变量
[System.Environment]::GetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "User")

# 查看系统变量
[System.Environment]::GetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "Machine")

若两者均返回空，说明变量未成功写入，请检查权限后重新设置。

原因三：bash.exe 路径填写错误

powershell 复制代码

Test-Path "C:\Program Files\Git\bin\bash.exe"
# 返回 True 才说明路径有效

若不确定 Git 的安装位置，执行：

powershell 复制代码

where.exe bash
Get-Command bash -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)，添加以下配置：

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 的路径是否真实存在。

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