最近在 Windows 上安装 Claude Code，官方文档给的命令只有一行，结果连续踩了四个坑。记录排查过程，方便遇到同样问题的人快速定位。
环境说明
- Windows 10/11 64位
- PowerShell
- 网络需要能访问 claude.ai
报错一：执行安装命令返回一堆语法错误
现象
powershell
irm https://claude.ai/install.ps1 | iex
```
报错：
```
此语言版本中不支持"var"关键字
参数列表中缺少参量
标记"||"不是此版本中的有效语句分隔符
原因
irm 没有拿到 PS1 脚本，拿到的是一个 HTML 页面，PowerShell 把 HTML 当成脚本执行了。错误信息里的 var、|| 都是 HTML 里内嵌的 JavaScript 语法。
解决
确保网络能正常访问 claude.ai，或配置好系统代理后执行：
powershell
$Env:HTTPS_PROXY="http://127.0.0.1:7890" # 替换成你自己的代理端口
irm https://claude.ai/install.ps1 | iex
```
---
## 报错二：提示不支持 32位 Windows
### 现象
网络问题解决之后，又报：
```
Claude Code does not support 32-bit Windows.
Please use a 64-bit version of Windows.
但系统明明是 64位。
排查
运行以下三行：
powershell
[Environment]::Is64BitProcess # 当前进程是否64位
[Environment]::Is64BitOperatingSystem # 操作系统是否64位
$env:PROCESSOR_ARCHITECTURE # 架构标识
```
我的输出是：
```
False ← 问题在这里
True
x86
系统是 64位没问题，但当前 PowerShell 进程是 32位的。
原因
Windows 有一个兼容层叫 WOW64，让 32位程序可以在 64位系统上运行。当一个 32位的终端工具启动 PowerShell 时，子进程会继承 32位环境，PROCESSOR_ARCHITECTURE 被设为 x86。
安装脚本读到 x86 就判断是 32位系统，直接报错退出。
解决
强制启动一个 64位 PowerShell 窗口：
powershell
Start-Process "$env:SystemRoot\SysNative\WindowsPowerShell\v1.0\powershell.exe"
在新窗口里验证：
powershell
[Environment]::Is64BitProcess # 必须是 True
```
确认 `True` 之后再执行安装命令。
---
## 报错三：安装成功但找不到 claude 命令
### 现象
安装日志显示成功：
```
✅ Installation complete!
Location: C:\Users\你的用户名.local\bin\claude.exe
```
但运行 `claude` 报错：
```
无法将"claude"项识别为 cmdlet、函数、脚本文件或可运行程序的名称
```
### 原因
PATH 环境变量只在新终端会话里生效。安装程序把 `~.local\bin` 写入了 PATH，但当前终端会话读取的还是旧的 PATH，不包含这个路径。
### 解决
**关掉当前终端，重新打开一个**（注意要打开 64位 PowerShell，重复上面的步骤）。
如果重开之后还是找不到，手动添加路径：
`Win + R` → 输入 `sysdm.cpl` → 高级 → 环境变量 → 用户变量 → PATH → 编辑 → 新建：
```
C:\Users\你的用户名.local\bin
```
保存后重开终端。
---
## 报错四：运行 claude 提示缺少 git-bash
### 现象
安装日志里出现：
```
Claude Code on Windows requires git-bash.
If installed but not in PATH, set environment variable:
CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe
原因
Claude Code 在 Windows 上依赖 Git Bash 来执行 shell 命令。Git Bash 是 Git for Windows 自带的一个 bash 环境，提供了 Windows 原生不具备的 Unix 工具链。
没有安装 Git for Windows，或者安装了但没有加入 PATH，都会触发这个问题。
解决
安装 Git for Windows，安装过程中保持默认选项，确保 Add Git to PATH 保持勾选。
安装完成后验证：
powershell
git --version
# git version 2.47.0.windows.1
如果已经安装了 Git 但还是报这个错，手动指定 bash 路径：
powershell
$Env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
或者写入系统环境变量永久生效。
完整安装流程
按顺序执行，避免反复踩坑：
第一步：打开 64位 PowerShell
powershell
Start-Process "$env:SystemRoot\SysNative\WindowsPowerShell\v1.0\powershell.exe"
第二步：验证是 64位进程
powershell
[Environment]::Is64BitProcess # True 才继续
第三步：执行安装
powershell
$Env:HTTPS_PROXY="http://127.0.0.1:7890" # 按实际代理端口修改
irm https://claude.ai/install.ps1 | iex
第四步：安装 Git for Windows
搜索"Git for Windows"下载安装，保持默认选项。
第五步：关闭终端，重新打开 64位 PowerShell
第六步：验证
powershell
claude --version
git --version
两行都有版本号输出，安装完成。
报错速查表
| 报错信息 | 原因 | 解决 |
|---|---|---|
不支持"var"关键字 | 网络问题，拿到的是 HTML | 配置代理或检查网络 |
does not support 32-bit | 终端是 32位进程 | 用 SysNative 路径启动 64位 PowerShell |
无法将"claude"项识别 | PATH 未刷新 | 关闭重开终端 |
requires git-bash | 未安装 Git for Windows | 安装 Git for Windows |
以上四个报错按顺序出现，逐个解决就能装好。如果遇到其他问题，优先运行 claude doctor 诊断。
