教程

Claude Code Windows 完整使用指南：WSL2、PowerShell 工具和 Native 支持

Claude Code Windows 完整使用指南：三种方式对比（WSL2 推荐/PowerShell 原生/Git Bash）；WSL2 安装配置和最佳实践（项目放 WSL2 文件系统避免 10-50 倍速度差）；v2.1.84 原生 PowerShell 工具启用和能力（cmdlet/Windows 路径/对象管道）；Windows 路径处理；MCP 配置（IIS 管理/Azure）；常见问题解决（PATH 配置/CRLF 行尾符/Node 版本）。

2026/5/35分钟 阅读ClaudeEagle

Claude Code 最初以 macOS/Linux 为核心，但 2026 年已经全面支持 Windows。本文是 Windows 用户的完整使用指南，涵盖 WSL2 推荐配置、原生 PowerShell 工具（v2.1.84）、Windows 路径处理，以及常见问题解决。

Windows 上的三种使用方式

方式适合场景体验
WSL2（推荐）开发 Linux/macOS 部署的项目最接近原生 Linux 体验
PowerShell（原生 Windows）Windows 应用、.NET 项目v2.1.84 新增 Native PowerShell 工具
Git Bash简单场景，不想装 WSL2有一些限制

方式一：WSL2 安装和配置（推荐）

安装 WSL2

powershell
# 以管理员权限运行 PowerShell
wsl --install

# 安装后重启电脑
# 默认安装 Ubuntu 22.04

在 WSL2 里安装 Claude Code

bash
# 在 WSL2 终端里运行
curl -sSL https://claude.ai/install.sh | bash

# 或用 Homebrew（在 WSL2 里安装 Homebrew）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install anthropic/claude/claude

claude auth login
claude --version

WSL2 的最佳实践

把项目放在 WSL2 文件系统里（不是 Windows 文件系统）：

bash
# ✅ 推荐：项目在 WSL2 里
~/projects/my-app

# ❌ 避免：通过 /mnt/c 访问 Windows 文件系统（慢 10-50 倍）
/mnt/c/Users/username/projects/my-app

使用 VS Code Remote - WSL 扩展：

  1. 安装 VS Code
  2. 安装 "Remote - WSL" 扩展
  3. 在 WSL2 终端里运行 code .，VS Code 会在 WSL2 环境里打开

Claude Code VS Code 扩展 + WSL2：

  1. 在 VS Code Remote - WSL 模式下，安装 Claude Code 扩展
  2. 扩展会在 WSL2 环境里运行，完整支持

方式二：原生 PowerShell 工具（v2.1.84）

启用 PowerShell 工具

json
// .claude/settings.json
{
  "env": {
    "CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"
  }
}

或者在启动时设置：

powershell
$env:CLAUDE_CODE_USE_POWERSHELL_TOOL = "1"
claude

PowerShell 工具能做什么

启用后，Claude Code 有一个原生 PowerShell 工具，可以：

powershell
# 直接运行 cmdlet
Get-Process | Where-Object { $_.CPU -gt 100 }

# 使用 Windows 原生路径
Get-ChildItem -Path "C:\Users\username\Documents" -Recurse

# .NET 对象管道
Get-EventLog -LogName Application -Newest 50 | 
  Where-Object { $_.EntryType -eq "Error" }

# 注册表操作
Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion"

不需要通过 Git Bash 转换 Windows 路径，直接使用原生 PowerShell 语法。

典型使用场景

> 检查 Windows 服务里哪些 Anthropic 相关的进程在运行 > 分析最近 24 小时的 Windows 事件日志里的错误 > 检查 C:\inetpub\wwwroot 里的 IIS 配置

在 Windows 上安装（不用 WSL2）

直接安装

powershell
# 用 winget（Windows Package Manager）
winget install Anthropic.ClaudeCode

# 或下载安装程序
# 访问 https://claude.ai/download

配置 PATH

powershell
# 检查 claude 是否在 PATH 里
where.exe claude

# 如果不在，手动添加到 PATH
$env:PATH += ";C:\Users\username\AppData\Local\AnthropicClaude\bin"

# 永久添加（以管理员运行）
[Environment]::SetEnvironmentVariable(
  "PATH",
  $env:PATH + ";C:\Users\username\AppData\Local\AnthropicClaude\bin",
  "User"
)

路径处理

Windows 路径在 CLAUDE.md 里

markdown
# CLAUDE.md（Windows 项目）

## 项目路径
- 项目根目录：C:\Projects\MyApp
- 配置文件：%APPDATA%\MyApp\config.json

## 构建命令
- 构建：dotnet build
- 测试：dotnet test
- 运行：dotnet run --project src\MyApp

混合路径（WSL2 访问 Windows 文件）

bash
# 在 WSL2 里访问 Windows 文件
ls /mnt/c/Users/username/Documents/

# 从 Windows 访问 WSL2 文件
# 在 File Explorer 地址栏输入：\\wsl$\Ubuntu

Windows 特有的 MCP 配置

IIS 和 Windows Server 管理

json
{
  "mcpServers": {
    "windows-admin": {
      "command": "powershell",
      "args": ["-Command", "npx -y @mcp/server-windows-admin"],
      "env": {
        "WINDOWS_ADMIN_MODE": "local"
      }
    }
  }
}

Azure（Windows 生态常见）

json
{
  "mcpServers": {
    "azure": {
      "command": "npx",
      "args": ["-y", "@azure/mcp-server"],
      "env": {
        "AZURE_SUBSCRIPTION_ID": "${AZURE_SUBSCRIPTION_ID}",
        "AZURE_TENANT_ID": "${AZURE_TENANT_ID}"
      }
    }
  }
}

常见问题和解决方案

问题 1：claude 命令找不到

powershell
# 检查安装位置
Get-Command claude -ErrorAction SilentlyContinue

# 重新安装
winget install Anthropic.ClaudeCode --force

问题 2：WSL2 里权限问题

bash
# 修复文件权限
chmod +x ~/.local/bin/claude

# 检查 PATH
echo $PATH | tr ':' '\n' | grep -i claude

问题 3：行尾符（CRLF vs LF）

bash
# 在 WSL2 里，Windows 文件可能有 CRLF 行尾符
# 配置 git 自动处理
git config --global core.autocrlf input

# 或在 .gitattributes 里指定
echo "* text=auto" >> .gitattributes

问题 4：Node.js 版本问题

bash
# Claude Code 需要 Node.js 18+
node --version

# 如果版本不对，用 nvm 切换
nvm install 20
nvm use 20

Windows 下的 Claude Code 快捷键

在 Windows Terminal 或 PowerShell 里：

快捷键功能
Escape取消当前操作
Escape Escape快速回退到上一个 Checkpoint
Ctrl+C停止 Claude（注意：不是取消操作）
Ctrl+V粘贴（包括图片！）
↑调出上一条提示词
Ctrl+R历史提示词搜索

来源：Claude Code 官方文档 - Windows 支持 | PowerShell 工具文档 | 整理：ClaudeEagle