问题背景
在 Windows 环境下运行 Claude Code 时，经常会遇到提示需要 Git Bash 的情况。这是因为该工具在 Windows 上依赖类 Unix 的 shell 环境来执行部分脚本。如果路径未正确配置，命令将无法识别。
解决方案
1. 安装 Git for Windows
推荐使用 winget 自动安装，版本建议 2.52.0 及以上，默认安装路径为 C:\Program Files\Git\。
winget install Git.Git
2. 配置环境变量
核心是设置 CLAUDE_CODE_GIT_BASH_PATH 指向 bash.exe 的路径。建议在用户级别设置，这样永久生效。
环境变量名: CLAUDE_CODE_GIT_BASH_PATH
值: C:\Program Files\Git\bin\bash.exe
3. 优化 PowerShell 启动配置
为了让每次打开新窗口都能自动识别，可以在 PowerShell 配置文件中添加初始化脚本。
编辑文件：C:\Users\Administrator\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 窗口即可直接使用，无需额外操作。
# 查看版本
claude --version
# 进入项目目录并启动
cd 你的项目目录
claude
如果不确定是否生效，可以运行以下检查命令：
# 检查 Git 是否可用
git --version
# 确认 bash.exe 路径是否存在
Test-Path "C:\Program Files\Git\bin\bash.exe"
# 查看环境变量是否加载
$env:CLAUDE_CODE_GIT_BASH_PATH
常见问题排查
新窗口仍提示需要 Git Bash
这通常意味着环境变量未在当前会话加载。尝试手动设置当前会话变量：
$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"
claude --version
找不到 bash.exe
如果 Git 安装在非标准位置，可以通过以下命令查找：
# 搜索系统内的 bash.exe
Get-Command bash.exe | Select-Object Source
找到后，将路径填入环境变量即可。
配置文件未生效
检查配置文件路径和内容：
# 查看配置文件实际路径
$PROFILE
# 查看内容
Get-Content $PROFILE
若文件不存在或为空，可手动创建并粘贴上述配置代码。
关键配置说明
CLAUDE_CODE_GIT_BASH_PATH
- 用途: 指定 Git Bash 可执行文件的完整路径。
- 必需: 是，Windows 上运行 Claude Code 的基础依赖。
- 格式: 绝对路径，例如
C:\Program Files\Git\bin\bash.exe。 - 作用域: 推荐用户级别，避免影响系统其他服务。
总结
完成上述步骤后，Claude Code 即可在 Windows PowerShell 环境中稳定运行。主要解决了依赖缺失和环境变量传递的问题，后续开发无需重复配置。
参考资料
- Git for Windows: https://git-scm.com/downloads/win
- Claude Code 文档：https://docs.anthropic.com/zh-CN/docs/claude-code/setup