共计 1538 个字符，预计需要花费 4 分钟才能阅读完成。
最近在 Windows 上尝试运行 Claude 代码时，遇到了 error: claude code on windows requires git-bash 的错误提示。经过一番折腾，终于搞清楚了背后的原因和解决方案，记录下来希望对遇到同样问题的朋友有所帮助。
错误原因分析
这个错误的根本原因是 Windows 和 Unix-like 系统（如 Linux、macOS）在环境上的差异。Claude 代码中可能使用了以下特性：
- Unix 风格的路径分隔符（/）
- Shell 脚本命令（如 grep、awk 等）
- 特定的环境变量设置
Git-Bash 提供了类 Unix 环境，因此成为在 Windows 上运行这类代码的桥梁。
解决方案
方案 1：Git-Bash 完整配置
这是最直接的解决方案，适合简单的开发需求。
- 下载并安装最新版 Git for Windows（含 Git Bash）
- 配置环境变量：
# PowerShell 中检查 PATH
$env:PATH -split ';' | Where-Object {$_ -like '*git*'}# Git Bash 中验证安装
git --version
bash --version- 在 VS Code 中设置默认终端为 Git Bash：
// settings.json
{
"terminal.integrated.defaultProfile.windows": "Git Bash",
"terminal.integrated.shell.windows": "C:\\Program Files\\Git\\bin\\bash.exe"
}验证方法：
# 在 Git Bash 中运行
./claude-script.sh方案 2：WSL2 环境搭建
适合需要完整 Linux 环境的开发场景。
- 启用 WSL 功能：
# 以管理员身份运行
wsl --install
wsl --set-default-version 2- 安装 Ubuntu 发行版
- 配置 VS Code 远程开发：
# WSL 中安装必要组件
sudo apt update && sudo apt install -y build-essential- 内存分配调整（可选）：
# %USERPROFILE%\.wslconfig
[wsl2]
memory=4GB
swap=2GB验证方法：
# 在 WSL 终端中运行
./claude-script.sh方案 3：Docker 容器化方案
最适合需要环境隔离和部署的场景。
- 创建 Dockerfile：
FROM ubuntu:20.04
RUN apt update && \
apt install -y git bash && \
rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY . .
CMD ["bash", "claude-script.sh"]- 构建并运行容器：
docker build -t claude-env .
docker run -it --rm claude-env验证方法：
# 在容器内检查
bash --version
./claude-script.sh性能对比
| 方案 | 启动时间 | 文件 I / O 速度 | 跨平台兼容性 |
|---|---|---|---|
| Git-Bash | 1-2s | 中等 | 一般 |
| WSL2 | 3-5s | 快 | 优秀 |
| Docker | 5-8s | 中等 | 优秀 |
避坑指南
- 中文路径问题：
- 避免在路径中使用中文
-
或设置系统区域为英文
-
权限问题：
# Git Bash 中 chmod +x claude-script.sh -
杀毒软件冲突：
- 将项目目录添加到杀毒软件白名单
- 临时禁用实时保护进行测试
延伸思考
- 设计跨平台 CLI 工具时，应考虑：
- 使用跨平台运行时（如 Node.js、Python）
- 避免系统特定命令
-
提供安装程序自动处理依赖
-
WSL 与 Docker 适用场景对比：
- WSL 更适合开发环境
- Docker 更适合部署和测试
- 两者可以结合使用
经过这些尝试，我最终选择了 WSL2 方案，因为它提供了最接近原生 Linux 的开发体验。希望这篇指南能帮你顺利解决这个问题！
正文完
