Windows Claude Code Git Bash 依赖修复教程

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 配置文件现在包含：

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 窗口中

现在可以直接使用，无需任何额外操作！

powershell 复制代码

# 查看版本
claude --version

# 在项目目录中启动
cd 你的项目目录
claude

验证安装

powershell 复制代码

# 检查 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: 手动设置环境变量（当前会话）

powershell 复制代码

$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"
claude --version

方法 2: 检查 Git Bash 是否存在

powershell 复制代码

# 检查标准路径
Test-Path "C:\Program Files\Git\bin\bash.exe"

# 如果返回 False，查找其他位置
Get-ChildItem "C:\Program Files" -Recurse -Filter "bash.exe" -ErrorAction SilentlyContinue | Select-Object FullName

方法 3: 手动设置永久环境变量

powershell 复制代码

# 设置用户级别环境变量
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "C:\Program Files\Git\bin\bash.exe", "User")

# 刷新当前会话
$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"

方法 4: 检查 PowerShell 配置文件

powershell 复制代码

# 查看配置文件路径
$PROFILE

# 查看配置文件内容
Get-Content $PROFILE

# 如果配置文件不存在或内容不正确，手动编辑
notepad $PROFILE

然后添加以下内容：

powershell 复制代码

# Set Git Bash path for Claude Code
$env:CLAUDE_CODE_GIT_BASH_PATH = 'C:\Program Files\Git\bin\bash.exe'

如果 Git Bash 安装在其他位置

如果 Git 安装在其他位置（例如 C:\Program Files (x86)\Git\），需要相应修改环境变量：

powershell 复制代码

# 查找 bash.exe
Get-Command bash.exe | Select-Object Source

# 设置正确的路径
$env:CLAUDE_CODE_GIT_BASH_PATH = "找到的路径\bash.exe"
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", $env:CLAUDE_CODE_GIT_BASH_PATH, "User")

📝 环境变量说明

CLAUDE_CODE_GIT_BASH_PATH

用途: 指定 Git Bash 可执行文件的完整路径
必需: 是（Windows 上运行 Claude Code 必需）
格式 : 完整路径，例如 C:\Program Files\Git\bin\bash.exe
作用域: 用户级别（推荐）或系统级别

为什么需要 Git Bash？

Claude Code 在 Windows 上需要 Git Bash 来执行某些 shell 命令和脚本。Git Bash 提供了类 Unix 的 shell 环境，使 Claude Code 能够正常工作。

🎉 修复完成

现在您可以：

✅ 在任何 PowerShell 窗口中直接使用 claude 命令
✅ 无需手动设置环境变量
✅ 新打开的窗口自动配置 Git Bash 路径
✅ Claude Code 可以正常启动和运行

📚 相关资源

Git for Windows 下载: https://git-scm.com/downloads/win
Claude Code 文档: https://docs.anthropic.com/zh-CN/docs/claude-code/setup