Windows 安装指引：原生、WSL 2 与 WSL 1

三条路各装各的，先选路再动手。绝大多数人应该走第一条——另外两条是给有特定需求的人准备的。

约 8 分钟

先确认前置条件已经对过：Windows 10 版本 1809 或更高、64 位、内存 4 GB 以上、Pro 及以上订阅。

Windows 上有三条路，先选路，再动手。

先选路

	需要什么	支持沙箱	什么时候选
原生 Windows	什么都不用	不支持	绝大多数人选这个
WSL 2	先启用 WSL 2	支持	你要用 Linux 工具链，或者需要沙箱执行
WSL 1	先启用 WSL 1	不支持	WSL 2 用不了的时候

不确定的话选原生。 你的文件在 Windows 上、你的工具是 Windows 的，就没有理由绕进 Linux 环境。

WSL 是 Windows 里的一个 Linux 子系统。如果你不知道自己需不需要它，那就是不需要。

路线一：原生 Windows（推荐）

第一步：确认自己在哪个窗口里

按 Win + X，选 Windows PowerShell 或终端。

看行首：

PS C:\Users\你的名字> —— PowerShell
C:\Users\你的名字> —— CMD

两者的安装命令不一样，用错会直接报错。

不要选带 (x86) 的那一项。 它是 32 位进程，会报「不支持 32 位 Windows」，哪怕你的电脑是 64 位的。

第二步：装

PowerShell 里：

PowerShell

irm https://claude.ai/install.ps1 | iex

CMD 里：

CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

不需要用管理员身份运行。

结束时出现 Claude Code successfully installed! 就是成功了。

第三步：验证

PowerShell

claude --version

正常会打印一个版本号，形如 2.1.211 (Claude Code)。

报 'claude' 不是内部或外部命令 或 claude : 无法将"claude"项识别为 cmdlet： 先关掉窗口重开一个再试——安装时打开的那个窗口用的还是旧环境。仍然不行看安装故障排查。

另一种：WinGet

PowerShell

winget install Anthropic.ClaudeCode

代价是没有自动更新，要你定期自己跑 winget upgrade Anthropic.ClaudeCode。

推荐用上面的官方安装脚本，理由是自动更新。 Claude Code 迭代很快，用包管理器装的人经常在几个月后发现少了一堆功能——不是没有，是没升级。

Git for Windows：装不装

是可选的。 官方明确写着 optional。

	Claude Code 用什么执行命令
装了	Git Bash
没装	PowerShell

两种都能跑。 建议装上，因为装的过程只是一路点「下一步」，而以后不用回头补。下载地址 git-scm.com/downloads/win，安装时到「Adjusting your PATH environment」那一屏保持推荐选项不动。

你不需要学 Git。 装它只是为了提供一个 Bash 环境。

如果它找不到你装的 Git

报错是这一句：

Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

在设置文件 settings.json 里指路：

JSON

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

如果你的 Git 装在别处，在 PowerShell 里跑 where.exe git 找到实际路径，取其中的 bin\bash.exe。

有一个容易踩的细节：这个路径必须指向名叫 bash.exe、sh.exe、bash 或 sh 的文件。指向 Git for Windows 那个 git-bash.exe 启动器不算——它会被忽略，且不报错，表现得像你没设过一样。

路线二：WSL 2

先在 WSL 里打开你的发行版，然后跑 macOS / Linux 那条安装命令：

Terminal

curl -fsSL https://claude.ai/install.sh | bash

装在 WSL 里，也要在 WSL 里启动——不是从 PowerShell 或 CMD 启动。

WSL 下不需要装 Git for Windows。

WSL 2 下登录会多一步。 浏览器通常开在 Windows 那一侧，回调到不了 WSL 里的 Claude Code。这不是故障——登录后浏览器会显示一个验证码，把它粘回终端就行。完整说明见登录授权、安装验证与工作目录。

路线三：WSL 1

只在 WSL 2 用不了的时候才走这条。

WSL 1 上有一个已知问题：运行 claude 会报

cannot execute binary file: Exec format error

最干净的办法是转成 WSL 2。 在 PowerShell 里：

PowerShell

wsl --set-version <你的发行版名> 2

必须留在 WSL 1 的话，官方给了一个绕法：在 WSL 里的 ~/.bashrc 末尾加上这段，然后 source ~/.bashrc。

Terminal

claude() {
  /lib64/ld-linux-x86-64.so.2 "$(readlink -f "$HOME/.local/bin/claude")" "$@"
}

一个 Windows 独有的坑

运行 claude 打开的是桌面应用，不是命令行。

原因是旧版本的 Claude 桌面应用在系统里注册了一个同名程序，而它的优先级更高。

处理办法：把桌面应用升级到最新版。

装完之后

跑一次体检：

PowerShell

claude doctor

它不启动会话，只打印安装与配置的诊断结果。装完跑一次，以后出问题也先跑它。

然后去登录授权、安装验证与工作目录。

本节事实查证日期：2026-08-05。 依据：官方 Advanced setup 的 Set up on Windows 一节，与 Troubleshoot installation and login。