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 --versionWSL2 的最佳实践
把项目放在 WSL2 文件系统里（不是 Windows 文件系统）：
bash
# ✅ 推荐：项目在 WSL2 里
~/projects/my-app
# ❌ 避免：通过 /mnt/c 访问 Windows 文件系统（慢 10-50 倍）
/mnt/c/Users/username/projects/my-app使用 VS Code Remote - WSL 扩展：
- 安装 VS Code
- 安装 "Remote - WSL" 扩展
- 在 WSL2 终端里运行
code .，VS Code 会在 WSL2 环境里打开
Claude Code VS Code 扩展 + WSL2：
- 在 VS Code Remote - WSL 模式下，安装 Claude Code 扩展
- 扩展会在 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"
claudePowerShell 工具能做什么
启用后，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$\UbuntuWindows 特有的 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 20Windows 下的 Claude Code 快捷键
在 Windows Terminal 或 PowerShell 里：
| 快捷键 | 功能 |
|---|---|
Escape | 取消当前操作 |
Escape Escape | 快速回退到上一个 Checkpoint |
Ctrl+C | 停止 Claude（注意：不是取消操作） |
Ctrl+V | 粘贴（包括图片！） |
↑ | 调出上一条提示词 |
Ctrl+R | 历史提示词搜索 |
来源：Claude Code 官方文档 - Windows 支持 | PowerShell 工具文档 | 整理：ClaudeEagle