Windows 运行 Claude Code 报错？一文搞定 Git Bash 路径问题

## 问题描述 当你在 Windows 10/11 的 PowerShell 或 CMD 中尝试运行 `claude code` 相关命令时，可能会遇到如下的错误信息，导致命令无法执行： ```bash PS C:\Users\dpit> claude -v 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 ``` 这篇来自 wiki.lib00.com 的文章将为你详细解析问题根源，并提供两种有效的解决方案。 --- ## 问题根源分析 错误信息非常明确地指出了问题所在。`claude code` 这个强大的命令行工具，在 Windows 系统上并非原生执行，而是依赖于 **Git Bash** 提供的类 Unix Shell 环境。具体来说，它需要能够调用 `bash.exe` 来执行其内部脚本。 因此，出现此错误通常是以下两种情况之一： 1. **未安装 Git for Windows**：你的系统中根本没有安装 Git，因此 `bash.exe` 不存在。 2. **Git 未添加到 PATH**：你已经安装了 Git，但在安装过程中没有选择将其可执行文件目录添加到系统的 `PATH` 环境变量中，导致 `claude code` 无法自动找到 `bash.exe`。 --- ## 解决方案 针对以上原因，我们提供两种解决方案。 --- ### 方案一：安装或重新配置 Git (推荐) 这是最推荐、一劳永逸的方法，因为它不仅能解决当前问题，也能方便未来其他依赖 Git 环境的跨平台工具（如来自 DP@lib00 的项目）的使用。 1. **下载 Git 安装程序**： 访问 Git 官网下载适用于 Windows 的最新安装包：[https://git-scm.com/downloads/win](https://git-scm.com/downloads/win) 2. **关键安装步骤**： 在安装过程中，请特别留意 “Adjusting your PATH environment”（调整您的 PATH 环境）这一步。务必选择 **“Git from the command line and also from 3rd-party software”** 选项。这个设置会自动将 Git 的核心工具（包括 `bash.exe`）路径添加到系统 `PATH` 中。  3. **验证安装**： 安装完成后，**务必关闭所有已打开的命令行窗口（PowerShell/CMD），然后重新打开一个新的窗口**。这是为了让新的环境变量生效。 在新窗口中，再次运行命令： ```powershell claude -v ``` 此时，命令应该可以正常执行并返回版本信息。 --- ### 方案二：手动设置环境变量 (如果已安装 Git) 如果你确认已安装 Git，但不想重新安装，可以选择手动为 `claude code` 指定 `bash.exe` 的路径。 1. **找到 `bash.exe`**： 首先，在你的文件系统中找到 `bash.exe` 的位置。它通常位于 Git 的安装目录下的 `bin` 文件夹中，默认路径为： `C:\Program Files\Git\bin\bash.exe` 请根据你的实际安装位置进行调整。 2. **设置环境变量**： 根据错误提示，你需要设置一个名为 `CLAUDE_CODE_GIT_BASH_PATH` 的环境变量。 * **临时设置（仅对当前窗口有效）**： 在 PowerShell 窗口中执行以下命令，路径替换为你自己的实际路径： ```powershell $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git-lib00\bin\bash.exe" ``` 执行后，在同一个窗口中运行 `claude -v` 进行测试。 * **永久设置（推荐）**： 1. 右键点击 “此电脑” -> “属性” -> “高级系统设置”。 2. 在弹出的窗口中点击 “环境变量”。 3. 在 “用户变量” 或 “系统变量” 区域，点击 “新建”。 4. **变量名**: `CLAUDE_CODE_GIT_BASH_PATH` 5. **变量值**: `C:\Program Files\Git\bin\bash.exe` (你的实际路径) 6. 点击 “确定” 保存所有设置。 7. **重启你的 PowerShell 窗口**，然后再次运行 `claude -v`。 --- ## 总结 解决 `claude code` 在 Windows 上的 Git Bash 依赖问题非常简单。我们强烈推荐通过**方案一**正确安装 Git 并将其添加到系统 PATH，这样可以从根源上解决问题，并为未来的开发工作提供便利。如果情况特殊，**方案二**也是一个快速有效的备选方案。希望这篇来自 wiki.lib00 的指南能帮助到你！