Windows 下配置 Claude Code 依赖 Git Bash 环境

在使用 Claude Code 进行开发时，Windows 用户可能会遇到命令无法识别的问题，通常是因为缺少 Git Bash 环境支持。下面分享一套完整的修复方案，包括安装 Git、配置环境变量以及更新 PowerShell 配置文件。

1. 安装 Git for Windows

首先需要确保系统安装了 Git。推荐使用 winget 快速安装：

winget install Git.Git

默认安装路径通常为 C:\Program Files\Git\。安装完成后，请确认 bash.exe 存在。

2. 配置环境变量

核心在于设置 CLAUDE_CODE_GIT_BASH_PATH 环境变量，指向 Git Bash 的可执行文件路径。建议设置为用户级别，这样对当前登录用户永久生效。

环境变量名： CLAUDE_CODE_GIT_BASH_PATH
值： C:\Program Files\Git\bin\bash.exe

3. 更新 PowerShell 配置文件

为了让每次打开新窗口时自动加载该变量，可以修改 PowerShell 的配置文件。找到你的配置文件路径（通常是 C:\Users\<用户名>\Documents\PowerShell\Microsoft.PowerShell_profile.ps1），添加以下内容：

# 刷新 PATH 以便全局命令生效
$env:Path = [System.Environment]::GetEnvironmentVariable('Path','Machine')+';'+[System.Environment]::GetEnvironmentVariable('Path','User')

# 设置 Git Bash 路径供 Claude Code 使用
$env:CLAUDE_CODE_GIT_BASH_PATH = 'C:\Program Files\Git\bin\bash.exe'

保存后重启终端即可生效。

验证与测试

配置完成后，打开新的 PowerShell 窗口，依次执行以下命令检查环境：

# 检查 Git 是否可用
git --version

# 检查 Bash 路径是否存在
Test-Path $env:CLAUDE_CODE_GIT_BASH_PATH

# 测试 Claude 命令
claude --version

如果上述命令均无报错，说明环境配置成功。

常见问题排查

如果新窗口仍提示需要 Git Bash，可以尝试以下方法：

手动设置当前会话变量 临时在当前窗口运行：

$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"
claude --version

查找 bash.exe 位置 如果 Git 安装在非标准路径，可以通过以下命令搜索：
```
Get-Command bash.exe | Select-Object Source
```
找到路径后，更新环境变量指向即可。
检查配置文件是否生效 运行 $PROFILE 查看配置文件路径是否正确，使用 Get-Content $PROFILE 检查内容是否包含上述配置。如未生效，尝试手动编辑：
```
notepad $PROFILE
```

官方资源

如需了解更多细节，可参考以下官方文档：

Windows 下配置 Claude Code 依赖 Git Bash 环境