Auto-generated English stub on 2026-04-24. Replace with a proper translation.

title: "Claude Code Windows 安装指南：免 WSL（3 分钟 PowerShell 配置）" description: "原生 Windows 版 Claude Code 3 分钟安装教程。无需 WSL，PowerShell 直接运行。Node.js/Git 自动配置、剪贴板图片修复。2025 分步指南。" date: 2026-01-24 keywords: ["Claude Code Windows", "原生安装", "免 WSL", "PowerShell", "剪贴板", "图片粘贴", "PATH 设置", "故障排除", "3 分钟设置"] tags: ["Claude Code", "Windows", "安装指南", "PowerShell"] categories: ["generative-ai/claude"]

Claude Code Windows 安装指南：免 WSL（3 分钟 PowerShell 配置）¶

概述¶

Claude Code 于 2025 年发布原生 Windows 版！此前必须安装 WSL（Windows Subsystem for Linux），如今 PowerShell 可直接运行，Windows 用户的体验大幅提升。

原生 Windows 版优势

免 WSL — 直接在 Windows 运行
自动安装 — Node.js、Git 一并配置
PowerShell 集成 — 使用 Windows 标准 Shell
剪贴板改进 — 原生实现增强了集成

安装步骤¶

1. 在 PowerShell 中运行安装脚本¶

无需管理员权限。在普通 PowerShell 中执行：

Invoke-RestMethod -Uri https://gist.githubusercontent.com/bjornmage/f4b136150f6904b812c1ece49e49d12e/raw/claudecode_installer.ps1 | Invoke-Expression

2. 安装过程中的选项¶

选择 AI 提供商¶

Please choose an AI provider to configure:
  1. Moonshot (Kimi)
  2. OpenAI (GPT)
  3. Google (Gemini)
  4. Anthropic (Official)  ← 选这个
  5. Azure OpenAI
  6. Custom / Local Model
  7. Clear Configuration

Enter your choice (1-7): 4

选择认证方式¶

How do you want to authenticate with Anthropic?
  1. Use an API Key
  2. Use Web Login (opens a browser on first run)  ← 推荐
Enter your choice: 2

3. 安装完成后的关键步骤¶

必做：重启 PowerShell

安装完成后，务必关闭当前 PowerShell 窗口并重新打开，以使环境变量生效。

故障排除¶

`claude` 命令无法识别¶

症状¶

PS C:\Users\YourUser> claude
claude : 无法将 'claude' 项识别为 cmdlet、函数、脚本文件
或可操作程序的名称。

原因与解决方法¶

确认 npm 全局安装路径

npm config get prefix
# 示例输出: C:\Users\YourUser\npm-global

确认 Claude Code 存在

# 查看安装状态
npm list -g @anthropic-ai/claude-code

# 确认 claude.cmd 文件存在
Test-Path "C:\Users\YourUser\npm-global\claude.cmd"
# 返回 True 即存在

检查并修正 PATH

# 查看当前 PATH
$env:PATH -split ";" | Where-Object {$_ -like "*npm*"}

# 若 npm-global 不在 PATH 中则添加
[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;C:\Users\YourUser\npm-global", [EnvironmentVariableTarget]::User)

# 当前会话也同步
$env:PATH = "$env:PATH;C:\Users\YourUser\npm-global"

验证
```
claude --version
```

仍无法运行¶

直接执行测试：

C:\Users\YourUser\npm-global\claude

剪贴板图片粘贴¶

当前限制¶

Windows+Shift+S 限制

截至 2025 年 7 月，多数用户反馈通过 Windows+Shift+S 截图后 Ctrl+V 粘贴无法正常工作。

替代方案¶

保存为文件后拖放
最可靠的方法
直接拖放到 Claude Code 窗口

指定文件路径

请查看此图：C:\Users\YourUser\Pictures\screenshot.png

VS Code 扩展「Claude Image Paste」
改善剪贴板集成
在 WSL 环境也可用

验证结果（2025年7月23日）¶

剪贴板图片粘贴暂不支持

原生 Windows 版同样无法用 Windows+Shift+S 截图后 Ctrl+V 粘贴，这似乎是 Claude Code 本身的限制，与 WSL 无关。

未来展望¶

随着原生 Windows 版发布，未来更新有望改进剪贴板功能。GitHub Issue（#1361、#834、#1929）正在热烈讨论。

与 WSL 版对比¶

原生 Windows 版优点¶

安装简单 — 无需安装配置 WSL
Windows 集成 — PowerShell / CMD 直接运行
轻量 — 无需启动 Linux 环境
Windows 权限 — 直接访问 Windows 文件系统

WSL 版优点¶

复用现有 Linux 环境 — 已有 WSL 则无需额外配置
包管理 — 可使用 apt / yum 等
容器集成 — 与 Docker 无缝协作
符号链接 — Linux 风格的文件系统功能

官方建议¶

Anthropic 官方推荐：Git Bash（原生 Windows）

官方文档推荐使用 Git Bash 的原生 Windows 版。WSL 定位为替代方案。

选择指南¶

适合原生 Windows 版（官方推荐）

通用用途（官方推荐）
Windows 开发场景
已有 Git Bash 环境
追求简洁

适合 WSL 版

已搭建好 WSL 环境
需要与 Docker 集成
依赖 Linux 工具链

总结¶

Claude Code 原生 Windows 版让用户无需配置 WSL 即可轻松上手。剪贴板图片粘贴仍有限制，但通过文件共享方式可正常工作。

根据实际需求在原生版与 WSL 版间选择，打造更高效的开发环境。

快速清单