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

Claude Code 通用安装教程讲了「装什么、怎么登录」，这篇专门解决 Windows 用户最纠结的问题：原生装还是 WSL 装？ 两条路线官方都支持，但差别不小。本文命令均核实自 Claude Code 官方安装文档，以官方文档为准。

系统要求

官方要求：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」），运行官方安装脚本：

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

用 CMD 的话命令不同：

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 自带包管理器）：

winget install Anthropic.ClaudeCode

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

建议同时安装 Git for Windows

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

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

路线二：WSL2 安装

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

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

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

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

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

设置后重开终端生效。想订阅官方 Pro/Max 的看 Claude 成品号/代充专区。

Windows 特有的坑

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

下一步

不想用命令行？可以试试图形界面的 Claude Desktop 桌面端或 VS Code 插件。macOS/Linux 用户看对应平台安装篇。不确定选哪个客户端，先看客户端总览与选择指南。