# Windows 安装 Claude Code：原生安装与 WSL 两条路线详解

> Windows 上装 Claude Code 该选原生还是 WSL？本文对比两条路线，给出 PowerShell/CMD 原生安装命令、Git for Windows 依赖说明、WSL 安装步骤，以及 PATH、沙箱等 Windows 特有的坑。
> 更新于 2026-08-04 · 难度 初级 · 来源 https://aicdks.com/guides/claude-code-windows-install

[Claude Code 通用安装教程](/guides/install-claude-code-china)讲了「装什么、怎么登录」，这篇专门解决 Windows 用户最纠结的问题：**原生装还是 WSL 装？** 两条路线官方都支持，但差别不小。本文命令均核实自 [Claude Code 官方安装文档](https://code.claude.com/docs/en/install)，以官方文档为准。

## 系统要求

官方要求：Windows 10 1809+ 或 Windows Server 2019+，4 GB 以上内存，x64 或 ARM64 处理器，需联网。

## 先做选择：原生 vs WSL

| 对比项 | 原生 Windows | WSL2 |
| --- | --- | --- |
| 额外依赖 | 无（建议装 Git for Windows） | 需启用 WSL 并装一个 Linux 发行版 |
| 沙箱（sandboxing） | 不支持 | 支持 |
| 项目在哪 | 项目放 Windows 盘（C:\ 等） | 项目放 Linux 文件系统里更快 |
| 适合谁 | Windows 原生开发（.NET、Win 桌面应用） | Web/后端开发、想要 Linux 工具链的人 |

简单判断：**项目本来就在 Windows 里、不想折腾就选原生；日常写 Web/Python/Node 的建议 WSL2**，环境和 Linux 服务器一致，坑更少。

## 路线一：原生 Windows 安装

打开 PowerShell（开始菜单搜「PowerShell」），运行官方安装脚本：

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

用 CMD 的话命令不同：

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

两个提示帮你分清自己在哪个终端：提示符带 `PS C:\` 是 PowerShell；报 `The token '&&' is not a valid statement separator` 说明你在 PowerShell 里跑了 CMD 命令；报 `'irm' is not recognized` 说明你在 CMD 里跑了 PowerShell 命令。

也可以用 WinGet（Windows 自带包管理器）：

```powershell
winget install Anthropic.ClaudeCode
```

注意 WinGet 装的版本**不会自动更新**，要定期跑 `winget upgrade Anthropic.ClaudeCode`；官方脚本装的版本会后台自动更新。

### 建议同时安装 Git for Windows

官方推荐在原生 Windows 上安装 [Git for Windows](https://git-scm.com/downloads/win)，这样 Claude Code 才能使用 Bash 工具执行命令；没装的话它会退回用 PowerShell 执行。如果装在了非默认路径，需要在 `settings.json` 里指定：

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

## 路线二：WSL2 安装

1. 管理员 PowerShell 运行 `wsl --install`（默认装 Ubuntu），重启；
2. 打开 Ubuntu 终端（注意：**是在 WSL 终端里装和启动，不是 PowerShell**），运行 Linux 安装脚本：

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

3. 验证：`claude --version` 输出版本号即成功。WSL 路线不需要 Git for Windows。

## 登录

装好后在项目目录运行 `claude`，按提示登录。国内用户的账号/网络/支付三个障碍与通用篇相同，三条路线（官方订阅 / 官方 API Key / API 中转）的详细配置见 [Claude Code 通用安装教程](/guides/install-claude-code-china)。最省事的是中转路线：买好[支持 Claude Code 的中转额度](/category/api-中转与额度-claude-额度)，设置 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_AUTH_TOKEN` 两个环境变量即可。原生 Windows 上设置环境变量用：

```powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://你的中转地址", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的中转key", "User")
```

设置后重开终端生效。想订阅官方 Pro/Max 的看 [Claude 成品号/代充专区](/category/ai-账号与服务-claude)。

## Windows 特有的坑

| 现象 | 解决 |
| --- | --- |
| `claude` 命令不存在 | 重开终端；仍不行则检查安装目录是否在 PATH，或运行 `claude doctor` 诊断 |
| 安装脚本报 403 / curl 错误 | 网络问题，换网络环境或参考官方 [Troubleshoot installation](https://code.claude.com/docs/en/troubleshoot-install) |
| 原生模式执行命令行为怪异 | 确认装了 Git for Windows（见上文），否则退回 PowerShell 工具 |
| WSL 里装完 PowerShell 找不到 claude | 正常——WSL 路线只能在 WSL 终端里用 |
| 需要沙箱隔离 | 原生 Windows 不支持 sandboxing，改用 WSL2 |

## 下一步

不想用命令行？可以试试图形界面的 [Claude Desktop 桌面端](/guides/claude-desktop-guide)或 [VS Code 插件](/guides/vscode-ai-extensions)。macOS/Linux 用户看[对应平台安装篇](/guides/claude-code-macos-linux-install)。不确定选哪个客户端，先看[客户端总览与选择指南](/guides/ai-coding-clients-overview)。