Windows系统安装Claude Code全攻略：从环境配置到避坑指南

8次阅读

共计 1812 个字符，预计需要花费 5 分钟才能阅读完成。

在开始安装 Claude Code 之前，确保你的 Windows 系统满足以下基本要求：

Windows 10 或更高版本（64 位）
至少 8GB 内存（推荐 16GB 以上）
20GB 可用磁盘空间
PowerShell 5.1 或更高版本

首先检查.NET Framework 版本，运行以下命令：

Get-ChildItem 'HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP' -Recurse | Get-ItemProperty -Name Version -EA 0 | Where {$_.PSChildName -match '^(?!S)\p{L}'} | Select PSChildName, Version

确保版本号为 4.7.2 或更高

验证 Python 环境（如果 Claude Code 有 Python 依赖）：
```
python --version
```
建议使用 Python 3.8+

从官方仓库获取最新版本：

Invoke-WebRequest -Uri "https://claude-code.example.com/latest.zip" -OutFile "$env:USERPROFILE\Downloads\claude-code.zip"

Expand-Archive -Path "$env:USERPROFILE\Downloads\claude-code.zip" -DestinationPath "C:\Program Files\ClaudeCode"

[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::Machine) + ";C:\Program Files\ClaudeCode", [EnvironmentVariableTarget]::Machine)

claude-code --version

如果遇到权限问题，可以尝试：

以管理员身份运行 PowerShell

执行以下命令修改目录权限：

icacls "C:\Program Files\ClaudeCode" /grant "Users:(OI)(CI)RX" /T

当出现依赖冲突时：

检查当前环境变量：
```
Get-ChildItem Env:
```

使用虚拟环境隔离依赖：

python -m venv claude-env
.\claude-env\Scripts\activate

在 config.ini 中添加：

[memory]
max_heap_size = 4G
initial_heap_size = 2G

Start-Process -FilePath "claude-code" -ArgumentList "--max-old-space-size=4096" -NoNewWindow

使用专用服务账户运行：

New-LocalUser -Name "claude-svc" -Description "Claude Code Service Account" -NoPassword

配置防火墙规则：

New-NetFirewallRule -DisplayName "Claude Code" -Direction Inbound -Program "C:\Program Files\ClaudeCode\claude-code.exe" -Action Allow

创建启动脚本start-claude.ps1：

$ErrorActionPreference = "Stop"

try {
    $env:CLAUDE_HOME="C:\Program Files\ClaudeCode"
    & "$env:CLAUDE_HOME\claude-code.exe" --daemon --log-level=info
} catch {
    Write-Host "启动失败: $_" -ForegroundColor Red
    exit 1
}

建议进一步探索：