教程

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 官方文档

相关文章推荐

教程OpenClaw Windows 安装完全指南:WSL2 配置、PowerShell 安装与常见问题OpenClaw 在 Windows 上的完整安装教程:为什么推荐 WSL2、WSL2 安装与配置步骤、PowerShell 一键安装脚本、Windows 防火墙与端口设置、Telegram/Discord 频道配置、开机自启动设置,以及 Windows 特有的常见问题排查(路径问题、权限问题、WSL 网络访问)。2026/3/17教程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教程Claude Code 安装故障排查:15 种常见报错的逐一修复方法Claude Code 安装故障排查完整指南:15 种常见报错症状对照表(command not found/TLS错误/HTML返回/Killed/musl不匹配/架构不匹配/Git Bash未配置等)、安装前诊断(Google Cloud Storage 连通性/代理配置/目录权限)、六大详细问题(PATH 修复/HTML 脚本返回/TLS CA 证书/Alpine musl/多版本冲突/低内存 Killed)各平台命令,以及 claude doctor 运行时诊断和认证问题修复。2026/3/7教程Claude Code 高级安装指南:系统要求、Windows/Alpine 配置、版本管理与完整卸载Claude Code 高级安装完整指南:五大操作系统支持(macOS 13+/Win10/Ubuntu 20.04+/Debian 10+/Alpine 3.19+)、三种安装方式(Native 脚本自动更新/Homebrew/WinGet)、Windows 两种配置(原生 Git Bash 路径/WSL 1 vs 2 沙箱区别)、Alpine Linux musl 依赖安装(libgcc/libstdc++/ripgrep)、版本管理(latest/stable 两频道/禁用自动更新/手动更新/特定版本)、二进制签名(macOS Gatekeeper/Windows Authenticode/Linux SHA-256),以及 Native/Homebrew/WinGet/npm 完整卸载和配置文件彻底清理方法。2026/3/7教程Claude Code MCP 完整使用指南:安装配置主流 MCP 服务器扩展 AI 能力Claude Code MCP(Model Context Protocol)完整使用指南:MCP 是什么(AI 工具扩展标准)、claude mcp 命令管理服务器(add/remove/list)、主流 MCP 服务器安装配置(文件系统/GitHub/PostgreSQL/Brave Search/Slack)、本地 stdio 与远程 SSE 两种连接方式、MCP 服务器安全配置、在 CLAUDE.md 中声明 MCP 工具使用规范,以及自定义 MCP 服务器的快速开发入门。2026/3/18