Windows 环境下配置 Claude Code 使用 Git Bash 指南

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 手动创建并粘贴上述配置代码。