Claude Code Git Bash 依赖修复说明
问题背景
问题: 运行 claude 命令时提示需要 Git Bash
解决方案
1. 安装 Git for Windows
- 版本: Git 2.52.0
- 安装方式: 使用 winget 自动安装
- 安装路径:
C:\Program Files\Git\
2. 设置环境变量
- 环境变量名:
CLAUDE_CODE_GIT_BASH_PATH - 值:
C:\Program Files\Git\bin\bash.exe - 作用域: 用户级别(永久生效)
3. 更新 PowerShell 配置文件
- 配置文件:
C:\Users\Administrator\Documents\PowerShell\Microsoft.PowerShell_profile.ps1 - 添加内容: 自动设置
CLAUDE_CODE_GIT_BASH_PATH环境变量 - 效果: 每次打开新 PowerShell 窗口时自动配置
配置文件内容
PowerShell 配置文件现在包含:
# Auto-refresh PATH for npm global commands
$env:Path = [System.Environment]::GetEnvironmentVariable('Path','Machine')+';'+[System.Environment]::GetEnvironmentVariable('Path','User')
# Set Git Bash path for Claude Code
$env:CLAUDE_CODE_GIT_BASH_PATH = 'C:\Program Files\Git\bin\bash.exe'
使用方法
在新打开的 PowerShell 窗口中
现在可以直接使用,无需任何额外操作!
# 查看版本
claude --version
# 在项目目录中启动
cd 你的项目目录
claude
验证安装
# 检查 Git 是否安装
git --version
# 检查 Git Bash 路径
Test-Path "C:\Program Files\Git\bin\bash.exe"
# 检查环境变量
$env:CLAUDE_CODE_GIT_BASH_PATH
# 测试 claude 命令
claude --version
故障排除
如果新窗口仍然提示需要 Git Bash
方法 1: 手动设置环境变量(当前会话)
$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"
claude --version
方法 2: 检查 Git Bash 是否存在
# 检查标准路径
Test-Path "C:\Program Files\Git\bin\bash.exe"
# 如果返回 False,查找其他位置
Get-ChildItem "C:\Program Files" -Recurse -Filter "bash.exe" -ErrorAction SilentlyContinue | Select-Object FullName

