Claude Code 现在完整支持 Windows,提供三种安装方式。本文详细讲解每种方式的步骤、优缺点,以及 Windows 特有问题的解决方案。
前置要求
所有方式都需要:
- Git for Windows:git-scm.com/downloads/win
- Claude 账号:claude.ai 注册(免费或 Pro/Max 订阅)
方式一: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 2Step 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 --versionStep 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 # 直接启动,无需 OAuthAPI 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/myappVS Code 集成(三种方式通用)
bash
# 安装 Claude Code 扩展
# 1. VS Code 扩展市场搜索 "Claude Code"
# 2. 或命令行安装:
code --install-extension anthropic.claude-codeWSL2 用户在 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 | iexWSL2 网络问题(无法连接 API)
bash
# /etc/wsl.conf 添加镜像网络模式
sudo tee /etc/wsl.conf << 'EOF'
[wsl2]
networkingMode=mirrored
EOF
# 重启
wsl --shutdownClaude Desktop 和 Claude Code 命令冲突
Claude Desktop 应用也会注册 claude 命令,可能冲突。
powershell
# 查看哪个 claude 被调用
Get-Command claude | Select-Object Source
# 在 PATH 里把 Claude Code 目录排到 Claude Desktop 前面
# 系统属性 -> 高级 -> 环境变量 -> 编辑 PathWindows Defender 误报
powershell
# 添加排除项
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\Programs\claude-code"三种方式对比速查
| 原生(PowerShell) | WinGet | WSL2 | |
|---|---|---|---|
| 安装难度 | 简单 | 简单 | 中等 |
| 性能 | 中 | 中 | 好(项目在 Linux 分区) |
| 自动更新 | ✅ | ❌ 需手动 | ✅ |
| Linux 工具兼容 | 有限 | 有限 | 完整 |
| 推荐场景 | 日常使用 | 企业管理 | 后端/DevOps |
来源:Claude Code Quickstart - Anthropic 官方文档