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
官方资源
如需了解更多细节，可参考以下官方文档：
通过以上配置，Claude Code 在 Windows 上即可正常调用类 Unix 环境执行脚本，无需频繁手动干预。如果遇到其他特定错误，建议优先检查环境变量是否被其他脚本覆盖。
