教程

Claude Code Windows 安装完全指南:原生安装、WSL2 和 PowerShell 三种方式

Claude Code Windows 完整安装教程:PowerShell 原生安装、WinGet 安装、WSL2 Ubuntu 安装三种方式详解,PATH 配置、Git 依赖、WSL2 OAuth 登录问题解决、JetBrains/VS Code 集成,附 Windows 特有问题解决方案。

2026/3/153分钟 阅读ClaudeEagle

Claude Code 现在完整支持 Windows,提供三种安装方式。本文详细讲解每种方式的步骤、优缺点,以及 Windows 特有问题的解决方案。

前置要求

所有方式都需要:

方式一:PowerShell 原生安装(推荐)

以管理员身份打开 PowerShell,运行:

powershell
irm https://claude.ai/install.ps1 | iex

或用 CMD:

cmd
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

安装完成后验证:

powershell
claude --version
claude /login

优点:原生 Windows,无需额外环境,自动后台更新。

方式二:WinGet 安装

Windows 11 内置包管理器,在 PowerShell 中运行:

powershell
winget install Anthropic.ClaudeCode

升级:

powershell
winget upgrade Anthropic.ClaudeCode

注意:WinGet 安装不自动更新,需要手动运行升级命令。

方式三:WSL2 + Ubuntu(高级用户推荐)

如果你的项目在 Linux 环境,或需要更好的 shell 集成,WSL2 方式体验最好。

Step 1:安装 WSL2

powershell
# 管理员 PowerShell
wsl --install
# 重启后会自动安装 Ubuntu
wsl --set-default-version 2

Step 2:在 Ubuntu 里安装 Claude Code

bash
# 打开 Ubuntu 终端
curl -fsSL https://claude.ai/install.sh | bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
claude --version

Step 3:解决 WSL2 OAuth 登录问题

WSL2 内浏览器无法自动打开,需要手动指定:

bash
# 方法 1:指定 Windows 浏览器
export BROWSER='/mnt/c/Program Files/Google/Chrome/Application/chrome.exe'
claude /login

# 方法 2:用 API Key 直接登录(更简单)
export ANTHROPIC_API_KEY=sk-ant-your-key-here
echo 'export ANTHROPIC_API_KEY=sk-ant-your-key-here' >> ~/.bashrc
claude  # 直接启动,无需 OAuth

API Key 从 console.anthropic.com 生成。

Step 4:WSL2 性能优化

最重要:把项目放在 Linux 文件系统,不要放在 /mnt/c/:

bash
# 慢(Windows 文件系统)
cd /mnt/c/Users/YourName/projects/myapp

# 快(Linux 文件系统)
cd ~/projects/myapp
git clone https://github.com/you/myapp ~/projects/myapp

VS Code 集成(三种方式通用)

bash
# 安装 Claude Code 扩展
# 1. VS Code 扩展市场搜索 "Claude Code"
# 2. 或命令行安装:
code --install-extension anthropic.claude-code

WSL2 用户在 VS Code 里用 Remote - WSL 扩展,体验和原生 Linux 一样。

Windows 常见问题排查

claude 命令找不到(command not found)

powershell
# 检查安装路径
$env:PATH -split ';' | Select-String 'claude'

# 手动添加到 PATH(PowerShell profile)
notepad $PROFILE
# 添加:$env:PATH += ";$env:LOCALAPPDATA\Programs\claude-code"

安装报错:TLS/SSL 问题

powershell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

WSL2 网络问题(无法连接 API)

bash
# /etc/wsl.conf 添加镜像网络模式
sudo tee /etc/wsl.conf << 'EOF'
[wsl2]
networkingMode=mirrored
EOF
# 重启
wsl --shutdown

Claude Desktop 和 Claude Code 命令冲突

Claude Desktop 应用也会注册 claude 命令,可能冲突。

powershell
# 查看哪个 claude 被调用
Get-Command claude | Select-Object Source

# 在 PATH 里把 Claude Code 目录排到 Claude Desktop 前面
# 系统属性 -> 高级 -> 环境变量 -> 编辑 Path

Windows Defender 误报

powershell
# 添加排除项
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\Programs\claude-code"

三种方式对比速查

原生(PowerShell)WinGetWSL2
安装难度简单简单中等
性能好(项目在 Linux 分区)
自动更新❌ 需手动
Linux 工具兼容有限有限完整
推荐场景日常使用企业管理后端/DevOps

来源:Claude Code Quickstart - Anthropic 官方文档

相关文章推荐

教程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/3教程OpenClaw Windows 安装完全指南:WSL2 配置、PowerShell 安装与常见问题OpenClaw 在 Windows 上的完整安装教程:为什么推荐 WSL2、WSL2 安装与配置步骤、PowerShell 一键安装脚本、Windows 防火墙与端口设置、Telegram/Discord 频道配置、开机自启动设置,以及 Windows 特有的常见问题排查(路径问题、权限问题、WSL 网络访问)。2026/3/17教程Hermes Agent 六种安装路径详解:VPS、Mac、WSL2、Docker、Pinokio、ServerlessHermes Agent 六种安装方式完整指南:VPS 一键部署(推荐)、Mac 本地 + Ollama、Windows WSL2、Docker Compose、Pinokio 无命令行、Modal/Daytona Serverless,含从 OpenClaw 迁移方法和常见报错解决。2026/4/15教程Claude Code 新手入门完整教程:安装、登录、第一个任务全流程(2026 最新)Claude Code 新手入门完整教程:从安装到第一个任务全流程,涵盖 macOS/Windows/Linux 安装、常见报错处理、核心命令速查和 5 个高频使用场景。2026/4/9教程Claude Code Linux 安装完整指南:Ubuntu/Debian/CentOS/Arch 全平台覆盖Claude Code 在 Linux 各发行版的完整安装教程:Ubuntu 22.04/24.04、Debian、CentOS/RHEL、Arch Linux 安装步骤,Node.js 版本要求,权限配置,WSL2 特殊处理,无 GUI 服务器部署,以及 Linux 下常见安装报错解决方案。2026/3/16教程Claude Code 常见错误解决大全:安装失败、认证问题、性能卡顿 22 个解法Claude Code 故障排查手册:command not found、OAuth 错误、403 Forbidden、Hooks 不触发、WSL2 问题等常见故障的直接可用解决命令,按安装/认证/性能/IDE/配置/WSL2/重置七类分组。2026/3/14