### [Windows安装Claude Code：环境准备与完整步骤](https://alyyhw.com/article/2007)

**Published:** 2026-07-13T04:25:01

**Author:** AI菜鸟网

**Excerpt:** Windows 安装 Claude Code 不只是复制一条命令，更要先分清你用的是 PowerShell、CMD 还是 WSL，以及是否需要 Git for Windows、PATH 和网络代理支持。

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 或跨平台脚本。

## 完整安装步骤

1.  打开 PowerShell，不需要管理员权限。
2.  执行官方安装命令。
3.  关闭并重新打开终端。
4.  运行 `claude --version` 确认命令可用。
5.  进入项目目录后运行 `claude`。
6.  首次启动时根据提示登录账号。

## 装完后命令找不到怎么办

这通常不是“没装上”，而是 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 和网络先通。装好后，你可以继续看 [登录与模型访问](/article/2013)，再把长期规则整理到 [CLAUDE.md](/article/2015)，这样后续使用会顺很多。

**Tags:** Claude Code, PowerShell, Windows, 安装教程

**Categories:** AI编程, Claude Code教程

---