Claude Code 在 Windows 安装与 WSL 配置教程

PowerShell 已经打开，却不知道该复制 Windows 代码块还是 WSL 代码块，往往比安装本身更容易卡住。Claude Code 现在同时支持 Windows 原生环境、WSL 2 和 WSL 1，但三条路径不能混着执行：Windows 原生安装在 PowerShell 或 CMD 中完成，WSL 安装必须进入 Linux 发行版终端后再执行。

需要 Windows 工具链或项目位于 Windows 目录时，优先选原生安装。需要 Linux 工具链或沙箱化命令执行时，优先选 WSL 2。WSL 1 只适合无法使用 WSL 2 的机器，因为 Claude Code 官方页面标明 WSL 1 不支持沙箱功能。

官方 Advanced setup 页的 Native Install 选项已经把 macOS、Linux、WSL、Windows PowerShell 和 Windows CMD 分成独立代码块。先认准当前终端，再复制对应块，能避开“命令存在但外壳不匹配”的问题。

先决定装在 Windows 还是 WSL

1. 项目位置决定安装位置。入口位置：查看日常项目是在 Windows 盘符目录、Windows 专用工具链，还是 WSL 的 Linux 主目录中。

   先做一次明确选择。主要动作：Windows 原生项目选择 Native Windows；Linux 工具链或需要沙箱时选择 WSL 2；只有 WSL 2 无法启用时才考虑 WSL 1。

   路径与终端应当一一对应。成功标志：已经确定后续所有安装和启动命令都在同一个环境执行，不在 PowerShell 与 WSL 终端之间交叉安装。

   项目位置不清楚时先停一下。失败处理：在 PowerShell 执行 Get-Location，在 WSL 执行 pwd。Windows 盘符或 /mnt/c 项目偏向原生 Windows；/home 下的 Linux 项目偏向 WSL 2。

官方 Windows 选择表把三个环境的依赖、沙箱能力和适用场景列在同一行。Native Windows 不要求 WSL，Git for Windows 是可选项；WSL 2 支持沙箱，WSL 1 不支持。

核对 Windows 和硬件前提

2. 先检查系统版本和硬件。入口位置：Windows 打开“设置”中的“系统”与“系统信息”，或在 PowerShell 运行 winver 查看系统版本。

   把最低条件逐项对照。主要动作：确认系统至少为 Windows 10 1809 或 Windows Server 2019，内存不少于 4 GB，处理器为 x64 或 ARM64，并且当前网络可用。

   条件满足后再安装。成功标志：系统版本、内存、处理器架构和网络四项都符合要求；终端类型也已确定为 PowerShell、CMD 或 WSL 中的 Bash。

   系统低于要求时不要硬装。失败处理：先完成 Windows 更新；内存或处理器不符合时改用另一台受支持设备。公司网络受限时由管理员确认下载服务可访问，不要反复执行同一安装命令。

截图中的 System requirements 是当前官方最低要求。Windows 10 1809、4 GB 内存和受支持处理器是继续操作前的判断线，不是安装完成后的排错项。

需要 WSL 时先把 WSL 2 准备好

3. WSL 的启用从管理员终端开始。入口位置：右键 Windows 开始菜单，选择“终端（管理员）”或“PowerShell（管理员）”。这一步只用于安装 WSL，不是安装 Claude Code。

   先安装并确认发行版版本。主要动作：执行 wsl --install，按提示重启 Windows。重启后运行新安装的 Linux 发行版，完成 Linux 用户名和密码设置，再回到 PowerShell 执行 wsl.exe --list --verbose。

   版本列应当清楚可见。成功标志：发行版出现在列表里，VERSION 列为 2。以后新装发行版需要默认使用 WSL 2 时，可执行 wsl.exe --set-default-version 2。

   命令只显示帮助或安装停住时分开处理。失败处理：只显示帮助时先用 wsl --list --online 查看发行版，再用 wsl --install -d 发行版名称 安装。停在 0.0% 时可按微软文档改用带 --web-download 的发行版安装形式。

选择 Windows 原生时在当前终端安装

4. 原生安装不需要管理员权限。入口位置：普通权限打开 PowerShell 或 CMD，进入 Claude Code 官方 Advanced setup 页的 Install Claude Code 区域，保持 Native Install 选项处于选中状态。

   只复制匹配当前外壳的代码块。主要动作：PowerShell 复制 Windows PowerShell 块，CMD 复制 Windows CMD 块，然后粘贴执行。也可在 PowerShell 使用 winget install Anthropic.ClaudeCode 作为官方列出的替代安装方式。

   安装程序正常结束就是第一道结果。成功标志：终端没有出现红色错误，重新打开一个普通终端后执行 claude --version 能返回版本号。

   外壳用错会出现很具体的提示。失败处理：PowerShell 提示 && 不是有效分隔符，说明误用了 CMD 代码块；CMD 提示无法识别 irm，说明误用了 PowerShell 代码块。回到官方页面重新复制正确块，不要修改其中的符号。

原生 Windows 不强制安装 Git for Windows。没有它时，Claude Code 使用 PowerShell 工具执行命令；安装后可使用 Git Bash。若 Claude Code 找不到 Git Bash，在用户配置的 settings.json 中设置 CLAUDE_CODE_GIT_BASH_PATH，值指向本机 bash.exe 的真实路径。

选择 WSL 时只在 Linux 终端内安装

5. 进入发行版后再安装 Claude Code。入口位置：从 Windows Terminal 打开 Ubuntu、Debian 等已配置发行版，确认提示符已经进入 Linux。执行 pwd 时应看到 Linux 路径。

   WSL 使用 Linux 安装块。主要动作：打开 Claude Code 官方 Advanced setup 页，在 Native Install 区域复制 macOS、Linux、WSL 代码块，粘贴到 WSL 终端执行。安装与后续 claude 启动都留在这个 WSL 终端。

   二进制应归属于 WSL 环境。成功标志：在 WSL 中执行 claude --version 能返回版本；回到 PowerShell 后不要求出现同一份安装，因为两边是独立环境。

   WSL 中找不到命令时先检查路径。失败处理：关闭并重新打开发行版终端，再执行 echo $PATH，确认用户目录下的 .local/bin 已进入 PATH。没有时按官方安装排错页把该目录加入 Bash 配置，再重开终端。

WSL 项目尽量放在 /home/用户名/项目名，不要长期放在 /mnt/c 下运行大范围搜索。Claude Code 官方排错页指出，跨 Windows 与 Linux 文件系统读取会带来性能损失，搜索结果也可能少于预期。

用版本和诊断命令完成验收

6. 验证要回到实际安装环境。入口位置：原生安装就在新的 PowerShell 或 CMD 中验证；WSL 安装就在对应 Linux 发行版终端中验证。

   先看版本，再看诊断。主要动作：依次执行 claude --version 和 claude doctor。版本命令确认程序可被找到，doctor 读取安装健康、设置文件错误和警告，不会启动交互会话。

   两类结果都应可读。成功标志：版本命令输出版本号与 Claude Code 名称，doctor 没有阻断启动的问题。随后在项目目录执行 claude，按浏览器提示完成账号登录。

   版本命令找不到程序时先修 PATH。失败处理：Windows 检查用户目录下的 .localbin 是否在 User PATH；WSL 检查 $HOME/.local/bin 是否在 PATH。修改后必须关闭旧终端并重新打开，再做验证。

官方验证区域同时给出版本检查和 doctor 诊断。先确认命令能被找到，再判断配置问题，比直接运行交互会话更容易定位安装失败的位置。

装好后逐项核对

1. 环境唯一：已经明确使用 Windows 原生或某个 WSL 发行版，没有把两边的安装结果混在一起。

2. 前提达标：Windows 版本、内存、处理器和网络符合官方最低要求。

3. WSL 版本正确：选择 WSL 路径时，发行版 VERSION 为 2；只有明确限制时才使用 WSL 1。

4. 项目位置合理：WSL 项目位于 Linux 主目录，避免跨文件系统搜索造成明显性能损失。

5. 命令可用：claude --version 与 claude doctor 都能在实际安装环境中运行。

6. 首次启动完成：在项目目录执行 claude 后进入登录流程，终端没有 PATH 或外壳不匹配错误。

7. 图片可访问：4 张当前页面截图都能打开，并分别证明安装代码块、环境选择、系统前提和验证命令。