适合谁，不适合谁
开始前准备
- Windows 10 1809+ 或 Windows Server 2019+，至少 4 GB RAM。
- PowerShell、CMD 或 WSL 终端，以及可访问官方安装地址的网络。
- Native Windows 可选安装 Git for Windows；没有 Git 时可使用 PowerShell 工具。
- 决定项目位于 Windows 文件系统还是 WSL Linux 文件系统。
claude.ai，WinGet 包名为 Anthropic.ClaudeCode。不要运行来源不明的下载器或修改版。完整步骤
选择 Native Windows 或 WSL 2
Windows 原生项目和工具使用 Native；依赖 Linux 工具链或需要沙箱时选择 WSL 2，并在 WSL 内安装和运行。
运行官方安装命令
PowerShell 使用官方 install.ps1；不想执行脚本时可以选择 WinGet。通常不需要以管理员身份运行原生安装。
重新打开终端检查版本
关闭并重新打开 PowerShell，运行 claude --version。如果找不到命令，检查 PATH 和安装方式。
运行 doctor 诊断
claude doctor 会检查安装健康、设置文件错误和相关警告，不启动完整会话。
进入测试目录完成首次启动
在无敏感信息的目录运行 claude，确认登录或网关配置，再发送一个只读测试任务。
官方 PowerShell 安装与验证命令
安装前确认当前终端提示符以 PS 开头，并检查命令域名。
irm https://claude.ai/install.ps1 | iex # 重新打开 PowerShell 后验证 claude --version claude doctor # WinGet 替代安装方式 winget install Anthropic.ClaudeCode
在 PowerShell 中照抄 CMD 的 && 安装命令。
先确认终端类型；PowerShell 使用 irm ... | iex，CMD 使用官方 CMD 安装命令。
怎样判断结果是否可用？
安装成功应能打印版本并通过 doctor 检查；只看到安装脚本结束不代表 PATH 和运行环境已经正常。
常见问题与报错
PowerShell 提示 && 不是有效分隔符
你复制了 CMD 命令。改用官方 PowerShell 安装命令。
claude 命令找不到
重新打开终端，检查安装是否成功和 PATH；运行 Get-Command claude -ErrorAction SilentlyContinue 定位。
WinGet 安装后版本未更新
WinGet 不自动更新；按官方说明运行 winget upgrade Anthropic.ClaudeCode。
Native Windows 与 WSL 项目路径混乱
在项目实际所在环境中安装和启动，不要在 PowerShell 中操作 WSL 内项目后再混用路径。
完成后的检查方法
- 安装来源为官方
claude.ai或 WinGet 包。 claude --version能打印版本。claude doctor没有阻断性安装或设置错误。- Native 或 WSL 选择与项目位置一致。
- Git for Windows、PowerShell 或 WSL 工具链符合项目需要。
- 首次测试目录不包含敏感数据。
FAQ
Claude Code Windows 必须安装 Node.js 吗？
官方原生安装和 WinGet 方式不以 Node.js 为前提；npm 是另一种安装方式。
Native Windows 还是 WSL 2 更好？
取决于项目。Windows 原生工具链用 Native；Linux 工具链或沙箱需求优先 WSL 2。
需要管理员权限吗？
官方说明 Native Windows 安装通常不需要管理员身份；具体仍受设备策略影响。
安装成功后下一步是什么？
先完成认证或网关配置，再在安全测试目录发送只读任务并检查 /status。
资料来源与版本说明
- Claude Code official: Setup
包含 Windows 要求、PowerShell、WinGet、Native/WSL、版本和 doctor 检查。
- Claude Code official: Settings
安装后配置文件、环境变量和 Windows 路径说明。
安装检查通过后，再配置当前 API 服务。
先在控制台确认是否提供 Claude Code 专用网关、Base URL 和凭证请求头。 模型、价格、额度与规则以对应业务站当前展示为准。
进入小贺API查看配置