问题现象

许多 Claude Code 用户在使用过程中遇到了一个令人困扰的问题：客户端在执行命令时频繁出现 “Exit Code 1” 错误。这个错误通常表现为命令看似执行完成，但实际上没有产生预期的输出结果，严重影响了AI 编程的自动执行。

问题根源

经过深入分析和实践验证，这个问题的根本原因在于环境变量 CLAUDE_CODE_GIT_BASH_PATH 的配置错误。

错误配置示例

# 错误的配置方式
CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\git-bash.exe

正确配置方式

# 正确的配置方式
CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe

为什么会出现这种误导？

在网络上搜索相关解决方案时，不少教程和论坛帖子都建议将 CLAUDE_CODE_GIT_BASH_PATH 指向 git-bash.exe。这种建议看似合理，因为：

1. git-bash.exe 是用户日常使用的 Git Bash 启动程序
2. 直观上认为应该指向用户熟悉的入口程序
3. 部分文档表述不够清晰，容易造成理解偏差

然而，这种配置会导致 Claude Code 无法正确读取 bash 的标准输出和错误输出流，从而出现 Exit Code 1 错误。

技术原理分析

当配置为 git-bash.exe 时：

• Claude Code 启动的是 Git Bash 的图形界面程序
• 输出流被重定向到图形界面，而非标准输出
• 程序无法捕获到期望的命令执行结果
• 导致命令看似执行但无有效输出

当配置为 bash.exe 时：

• Claude Code 直接调用底层的 bash shell
• 标准输入输出流正常传递
• 命令执行结果能够被正确捕获和处理

官方文档佐证

根据 Claude Code 官方文档 https://code.claude.com/docs/zh-CN/setup 的明确说明：

“CLAUDE_CODE_GIT_BASH_PATH 应该指向实际的 bash 可执行文件路径，例如 C:\Program Files\Git\bin\bash.exe”

这证实了我们应该配置 bash.exe 而非 git-bash.exe。

解决方案

1. 检查当前配置

首先确认环境变量是否已设置：

echo %CLAUDE_CODE_GIT_BASH_PATH%

2. 修改环境变量

将 CLAUDE_CODE_GIT_BASH_PATH 修改为正确的路径：

C:\Program Files\Git\bin\bash.exe

3. 验证配置

重启 Claude Code 客户端，重新执行之前出现问题的命令，应该不会再出现 Exit Code 1 错误。

总结

Claude Code 的 “Exit Code 1” 问题往往源于 CLAUDE_CODE_GIT_BASH_PATH 环境变量配置不当。虽然网络上的许多教程建议配置 git-bash.exe，但根据官方文档和技术实现原理，正确做法应该是配置 bash.exe。

建议所有遇到类似问题的用户检查并修正此环境变量配置，以充分发挥 Claude Code 的完整功能。同时，在参考网络教程时，应当结合官方文档进行验证，避免被误导配置。

通过正确的配置，我们可以确保 Claude Code 能够正常调用 bash shell，实现顺畅的命令执行和 Git 集成体验。

---

（END）