解决 Claude Code VS Code 扩展在 Windows 上无法检测 Git Bash 的问题

解决 Claude Code VS Code 扩展在 Windows 上无法检测 Git Bash 的问题

问题描述

Claude Code VS Code 扩展在 Windows 上报错：

Error: Claude Code on Windows requires git-bash (https://git-scm.com/downloads/win).
If installed but not in PATH, set environment variable pointing to your bash.exe,
similar to: CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe

即使 Git Bash 已正确安装，扩展仍然无法检测到。

相关 Issue: GitHub #8674

尝试过但无效的方法

1. 添加 C:\Windows\System32\ 到系统 PATH
2. 降级扩展版本到 v2.0.0
3. 设置 CLAUDE_CODE_GIT_BASH_PATH 环境变量（无论路径是否包含空格）

最终解决方案

核心思路：不手动指定 bash.exe 路径，而是让系统通过 PATH 自动发现。

操作步骤

1. 删除环境变量 CLAUDE_CODE_GIT_BASH_PATH（如果存在）

2. 将 Git CMD 目录添加到 PATH

   • 用户安装：%USERPROFILE%\AppData\Local\Programs\Git\cmd
   • 全局安装：C:\Program Files\Git\cmd

3. 完全重启 VS Code

4. 启动 Claude Code 扩展 --- 问题解决

原因分析

初步猜测是 Program Files 路径中的空格导致解析错误，但经测试，即使使用不含空格的路径（如用户安装目录）设置 CLAUDE_CODE_GIT_BASH_PATH，问题依然存在。

因此，真正的原因可能是扩展在处理 CLAUDE_CODE_GIT_BASH_PATH 环境变量时存在 bug。通过 PATH 自动发现机制而非手动指定路径，可以绕过这个问题。