Claude Code Windows 11 安装全攻略：在 WSL2 中开启 AI 原生编程新时代

Claude Code 是 Anthropic 官方推出的 AI 驱动终端编程助手。它能够直接在你的终端中运行，协助进行代码编辑、调试、测试以及 Git 工作流管理。然而，Claude Code 是为类 Unix 系统（Linux 和 macOS）设计的，无法直接在 Windows 上原生运行。这意味着 Windows 11 用户需要借助 WSL2（Windows Subsystem for Linux 2） 来搭建运行环境。

本文将详细介绍如何在 Windows 11 上从零开始配置 WSL2 并成功安装 Claude Code。

一、 系统要求与准备工作

在开始安装之前，请确保你的电脑符合以下“硬件和软件食谱”：

1. 软件要求

• Windows 11 版本 21H2 或更高：较新版本对 WSL2 的文件系统性能和 GPU 支持有显著提升。你可以按下 Win + R 输入 winver 检查版本。
• Windows 终端 (Windows Terminal)：强烈建议从 Microsoft Store 安装，它能更好地处理 Claude Code 使用的特殊字符和颜色。

2. 硬件要求

• 虚拟化支持：需在 BIOS/UEFI 中开启（Intel VT-x 或 AMD-V）。你可以在“任务管理器 > 性能 > CPU”中确认“虚拟化：已启用”。
• 内存与空间：建议至少 8GB 内存；预留 2-4GB 磁盘空间用于 WSL2 和环境配置。

二、 第一步：安装与配置 WSL2

1. 开启 WSL2 功能

以管理员身份打开 PowerShell，运行以下命令：

wsl --install

该命令会自动开启必要功能、下载 Linux 内核并默认安装 Ubuntu。安装完成后，必须重启电脑。

2. 初始化 Linux 环境

重启后，打开 Ubuntu 应用。首次启动会提示你创建 Unix 用户名和密码。请注意，输入密码时屏幕不会显示任何字符，这是 Linux 的安全机制。

3. (进阶) 将 WSL 迁移至非系统盘

如果你的 C 盘空间紧张，可以将 Ubuntu 导出并重定向到其他磁盘（如 E 盘）：

# 在 PowerShell 中运行
wsl --export Ubuntu E:\WSL\ubuntu-backup.tar
wsl --unregister Ubuntu
wsl --import Ubuntu E:\WSL\Ubuntu E:\WSL\ubuntu-backup.tar --version 2

三、 第二步：搭建 Node.js 开发环境

Claude Code 基于 Node.js 构建，且需要 Node.js 18+ 和 npm 10+。

1. 更新系统包

在 Ubuntu 终端中执行：

sudo apt update && sudo apt upgrade -y

2. 安装 Node.js

推荐通过 NodeSource 安装 LTS 版本：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

3. 配置 npm 全局路径（避免权限错误）

为了避免在安装全局包时使用 sudo 导致权限混乱，建议将 npm 路径设在用户目录下：

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

四、 第三步：正式安装 Claude Code

一切就绪后，运行以下命令安装 Claude Code：

npm install -g @anthropic-ai/claude-code

注意： 请勿在此命令前加 sudo。安装完成后，输入 claude --version 验证，若显示版本号（如 1.0.38），则说明安装成功！

五、 第四步：身份验证与首次运行

首次启动 Claude Code：

claude

系统会提示你进行身份验证，你可以选择：

• Anthropic Console (API)：按量计费，适合已有 API Key 的开发者。
• Claude Pro/Max 订阅：每月固定费用，适合经常使用 Claude.ai 的个人用户。

选择后，浏览器会自动打开授权页面。将获得的 Token 粘贴回终端即可完成连接。

六、 实战演练：创建你的第一个项目

让我们试着用 Claude Code 创建一个简单的 C# Hello World 项目：

1. 创建目录：

   mkdir ~/hello-world-project && cd ~/hello-world-project
   

2. 启动 Claude：输入 claude。
3. 对话式编程：
   • 你可以问：“我想创建一个 C# 控制台程序，请帮我设置项目结构并解释每个文件的作用。”
   • Claude Code 会自动生成 .csproj 项目文件和 Program.cs 代码。
4. 运行测试：
   • 如果你还没安装 .NET 环境，可以直接问 Claude：“我该如何在 WSL 中安装 .NET SDK 并运行这个项目？”，它会提供详细的安装指令。

七、 常见问题与最佳实践

• 文件系统建议：为了获得最佳性能，请将项目文件放在 WSL 的文件系统内（如 /home/username/projects），而不是通过 /mnt/c/ 访问 Windows 磁盘上的文件。
• 权限管理：在 Claude 内部输入 /permissions 可以查看和修改它的操作权限（如是否允许运行 shell 命令、修改文件等）。
• 错误处理：如果遇到 Command not found，通常是 PATH 环境变量没配置对，请重新运行 source ~/.bashrc。

结语

虽然在 Windows 11 上运行 Claude Code 多了配置 WSL2 的步骤，但这同时也为你提供了一个更纯粹、更接近生产环境的 Linux 开发空间。有了 Claude Code 的协助，你的终端将不再仅仅是输入命令的地方，而是一个能够思考、编码和持续进化的 AI 工作站。

现在，尽情享受 AI 原生编程带来的效率革命吧！