Windows 用户第一次安装 Claude Code，最常见的问题不是“安装包坏了”，而是环境没分清：你到底是在 PowerShell、CMD 还是 WSL 里执行命令；项目是 Windows 原生路径还是 Linux 子系统路径；当前网络能不能访问下载服务器。把这些前提理顺，安装过程其实并不复杂。
安装前先确认 4 件事
- 系统版本是否满足官方要求：Windows 10 1809+ 或 Windows Server 2019+。
- 机器是否至少有 4GB 内存，处理器为 x64 或 ARM64。
- 你要在原生 Windows 终端里用，还是在 WSL 里用。
- 网络是否能访问官方下载安装地址，企业网络下是否需要代理。
先决定：原生 Windows 还是 WSL
官方文档给出的建议很清楚：如果你的项目和工具链都在 Windows 原生环境里，可以直接原生安装；如果你主要使用 Linux 工具链、希望结合沙箱化命令执行，WSL 2 更合适。简单说，项目在哪儿，就优先在哪儿运行 Claude Code，不要一边在 Windows 终端里启动，一边去改 WSL 里的仓库。
推荐安装方法
如果你在 PowerShell 中，直接运行：
irm https://claude.ai/install.ps1 | iex如果你在 CMD 中，运行：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd如果你更偏好包管理器，也可以用：
winget install Anthropic.ClaudeCode原生安装会自动后台更新；WinGet 安装则需要你之后手动执行升级命令。
Git for Windows 要不要装
官方写得很明确：原生 Windows 安装并不强制要求 Git for Windows，但推荐安装，因为这样 Claude Code 可以使用 Bash 工具；如果没有安装，它会退回使用 PowerShell 作为 shell 工具。对新手来说，这意味着“能装就装”，尤其是你本来就会在本机使用 Git Bash、Git CLI 或跨平台脚本。
完整安装步骤
- 打开 PowerShell，不需要管理员权限。
- 执行官方安装命令。
- 关闭并重新打开终端。
- 运行
claude --version确认命令可用。 - 进入项目目录后运行
claude。 - 首次启动时根据提示登录账号。
装完后命令找不到怎么办
这通常不是“没装上”，而是 PATH 没刷新。官方排障页指出，Windows 上 Claude 可执行文件位于用户目录下的 .local/bin。如果重新打开终端后仍找不到命令，就检查用户 PATH 中是否存在该目录，再重新启动终端测试。
企业网络和代理环境怎么处理
如果安装时出现无法获取版本、下载失败、TLS 相关错误，优先检查是否能访问 downloads.claude.ai。在代理环境下，要先设置 HTTP_PROXY 和 HTTPS_PROXY，再执行安装命令。很多企业内网并不是 Claude Code 不支持，而是下载域名、证书链或代理没有提前放通。
安装后的自检清单
建议你装完以后不要急着开始正式任务，而是先做一次小自检：确认 claude --version 能输出版本号；确认在 PowerShell、你常用的 IDE 终端里都能识别命令；确认进入一个测试仓库后可以启动 claude；如果你打算用 Bash 风格命令，再确认 Git for Windows 已经安装。把这些基础检查做完，后面很多“到底是工具坏了还是环境坏了”的疑问会直接消失。
如果你还准备长期维护多个仓库，建议顺手把终端、Git、代理和常用路径写成自己的环境笔记。以后机器重装或给同事复现时，会省掉很多重复确认。
适合长期保留的两个习惯
第一，固定一种你最熟悉的启动方式，例如始终用 PowerShell 打开仓库并启动 Claude Code；第二，把代理、证书和 PATH 相关检查命令留成一个小脚本。这样以后升级系统、换电脑或迁移到新项目时，你都能快速判断问题是不是出在环境层。
如果团队里有人负责环境模板，最好把这些做法沉淀成统一装机文档，让新人少走终端、代理和路径混用的弯路。多花十分钟把环境打磨顺，往往能省掉后面几小时的排障时间。
如果你在团队环境里安装，最好额外记录当前终端、安装来源、PATH 位置和代理设置。以后换机器、升级系统或帮同事复现问题时，这些信息通常比重复重装更有用。
常见坑位
- 把 CMD 命令粘到 PowerShell，导致出现
&&分隔符报错。 - 把 PowerShell 命令粘到 CMD，导致
irm无法识别。 - 安装完成后不重开终端，误以为命令不存在。
- 没区分原生 Windows 仓库和 WSL 仓库，结果路径、Git、依赖混在一起。
- 企业网络下没有处理代理或证书，反复重试同一命令。
总结
Windows 安装的关键不是背命令，而是确认运行环境、选择合适终端、让 PATH 和网络先通。装好后，你可以继续看 登录与模型访问，再把长期规则整理到 CLAUDE.md，这样后续使用会顺很多。
