Windows 环境下配置 Claude Code 使用 Git Bash 指南
在 Windows 平台运行 claude 命令时，经常会遇到依赖 Git Bash 的提示。这通常是因为工具需要类 Unix 的 shell 环境来执行脚本。通过安装 Git for Windows 并正确配置环境变量，即可解决此问题。
核心修复步骤
1. 安装 Git for Windows
确保系统已安装 Git。推荐使用 winget 进行自动安装，默认路径通常为 C:\Program Files\Git\。
winget install Git.Git
2. 设置关键环境变量
Claude Code 需要一个特定的环境变量来定位 bash 可执行文件。请在用户级别设置以下变量：
- 变量名:
CLAUDE_CODE_GIT_BASH_PATH - 值:
C:\Program Files\Git\bin\bash.exe
3. 更新 PowerShell 配置文件
为了让每次打开新窗口时自动生效，建议将配置写入 PowerShell 的 Profile 文件中。默认路径通常在 C:\Users\<用户名>\Documents\PowerShell\Microsoft.PowerShell_profile.ps1。
添加以下内容到该文件末尾：
# 刷新 PATH 以便识别 npm 全局命令
$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.exe 是否存在
Test-Path "C:\Program Files\Git\bin\bash.exe"
# 查看环境变量是否加载
$env:CLAUDE_CODE_GIT_BASH_PATH
# 尝试运行 claude
claude --version
如果上述命令均无报错，说明环境配置成功，可以直接在项目目录中启动 Claude Code。
故障排查
如果新窗口仍然提示缺少 Git Bash，可以尝试以下方法：
临时手动设置（当前会话） 直接在当前终端运行赋值命令：
$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"
查找实际安装位置
如果 Git 安装在非标准路径（如 Program Files (x86)），需先定位 bash.exe：
Get-Command bash.exe | Select-Object Source
找到路径后，将其填入环境变量设置中。
检查配置文件状态 确认 Profile 文件是否存在且内容正确：
$PROFILE
Get-Content $PROFILE
若文件为空或不存在，可使用 notepad $PROFILE 手动创建并粘贴上述配置代码。
为什么需要 Git Bash？
Claude Code 在 Windows 上依赖 Git Bash 提供的 POSIX 兼容 shell 环境来执行部分底层命令和脚本。虽然 Windows 自带 CMD 或 PowerShell，但某些工具链对 Unix 风格的命令支持更好。配置环境变量后，程序就能自动调用正确的解释器。
参考资料
- Git for Windows 官方下载：https://git-scm.com/downloads/win
- Claude Code 文档：https://docs.anthropic.com/zh-CN/docs/claude-code/setup
