人人都会AI编程

2.1.4 Windows 平台安装步骤

更新时间：2026-06-28

Claude Code 不支持 Windows 原生环境（PowerShell/CMD），必须通过 WSL2（Windows Subsystem for Linux）安装。WSL2 提供了完整的 Linux 内核支持，能确保所有功能（包括文件监听、Git 集成和 Shell 命令执行）正常工作。

前置条件检查

在开始前确认系统满足以下要求：

| 检查项 | 最低要求 | 验证命令 |
|--------|----------|----------|
| Windows 版本 | Windows 10 版本 2004（Build 19041）或 Windows 11 | winver 查看 |
| WSL2 已启用 | 默认发行版为 WSL2 | wsl --status |
| 虚拟化支持 | BIOS 中启用虚拟化（Intel VT-x/AMD-V） | 任务管理器 → 性能 → CPU → 虚拟化：已启用 |

安装 WSL2（如未安装）

如系统尚未安装 WSL2，以管理员身份运行 PowerShell：

# 自动安装 WSL2 并默认安装 Ubuntu
wsl --install -d Ubuntu-22.04

# 如已安装 WSL1，需转换为 WSL2
wsl --set-version Ubuntu-22.04 2

安装完成后重启电脑，首次启动 Ubuntu 时会要求设置 Linux 用户名和密码（注意：这与 Windows 登录密码无关，请牢记）。

在 WSL2 内安装 Claude Code

打开 Ubuntu 终端（或 Windows Terminal 选择 Ubuntu），后续步骤与 Linux 完全一致：

方式一：官方脚本（推荐）

# 在 WSL2 Ubuntu 终端中执行
curl -fsSL https://claude.ai/install.sh | sh

# 如提示权限不足，安装到用户目录
curl -fsSL https://claude.ai/install.sh | sh -s -- --install-dir ~/.local/bin

方式二：npm 安装

# 确保 Node.js 版本正确（Ubuntu 22.04 默认源可能较旧，建议先安装 NodeSource 源）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

Windows 文件系统访问配置

访问 Windows 项目：
WSL2 将 Windows 盘符挂载到 /mnt/ 下：

# 进入 Windows D 盘的项目目录
cd /mnt/d/Projects/my-codebase

# 或 C 盘用户目录
cd /mnt/c/Users/你的用户名/Documents/project

# 启动 Claude Code
claude

性能优化建议：

  • 项目放在 WSL2 文件系统内（~/projects/）比放在 Windows 盘符（/mnt/c/）快 10-20 倍，特别是处理 node_modules 或大量小文件时
  • 如需在 Windows 资源管理器中查看，可在项目目录运行 explorer.exe . 会打开 Windows 文件管理器

路径互操作：

# 在 WSL2 中获取 Windows 格式的路径（用于复制粘贴到 Windows 应用）
wslpath -w /mnt/d/project
# 输出：D:\project

# 在 Windows 侧获取 WSL 路径
# 在 PowerShell 中：wsl wslpath -u "D:\project"

终端环境优化

推荐终端：Windows Terminal（微软商店安装）

  • 支持多标签页、GPU 加速、自定义配色
  • 设置默认启动配置文件为 Ubuntu：设置 → 启动 → 默认配置文件 → Ubuntu

避免常见卡顿：
在 Windows Terminal 设置中添加以下配置，防止 Windows Defender 实时扫描 WSL2 文件导致卡顿：

// 在 Windows Terminal 的 settings.json 中
"profiles": {
    "defaults": {
        "antialiasingMode": "cleartype"
    }
}

已知限制与解决方案

| 问题现象 | 原因 | 解决方案 |
|----------|------|----------|
| 处理 /mnt/c/ 下项目极慢 | WSL2 跨文件系统性能开销 | 将项目移到 ~/（WSL2 根目录）下开发 |
| Git 行尾符警告（LF/CRLF） | Windows 与 Linux 换行符差异 | 在项目根目录运行 git config core.autocrlf false |
| 防火墙提示阻止连接 | Windows Defender 拦截 WSL2 网络 | 允许 vmmem 进程通过防火墙，或暂时关闭防火墙测试 |
| 内存占用过高 | WSL2 默认无内存限制 | 创建 %UserProfile%\.wslconfig 文件，设置 memory=8GB |

验证安装

在 WSL2 终端中依次执行：

# 1. 检查版本
claude --version

# 2. 测试 API 连接（应提示输入或确认 API Key）
claude --help

# 3. 进入 Windows 项目测试文件访问
cd /mnt/c/Users/$USER/Documents
claude
# 应能正常读取目录结构，无 "Permission denied" 错误

下一步

完成安装后，建议阅读 第 7.3 节（多级规则配置）了解如何处理 Windows 与 Linux 路径差异，以及 第 15.1 节（命令执行安全）注意 WSL2 与 Windows 宿主机的权限边界问题。