Windows 安装 Claude Code 完整教程（含常见报错排查）

基于 Windows 环境实际安装过程整理，包含推荐安装方式、常见错误、验证步骤，以及首次启动方法。

Claude Code 是 Anthropic 推出的命令行编程助手，可以直接在终端中理解项目结构、解释代码、帮助修改文件并完成开发任务。根据 Claude Code 官方文档，Windows 现已支持原生安装，前置要求是 Windows 10 1809+ / Windows Server 2019+，并且 需要先安装 Git for Windows。另外，使用 Claude Code 需要可用的 Claude Code 访问权限账号。

在 Windows 上安装 Claude Code 之前，建议先确认以下几点：

1. 系统版本满足要求。
2. 已安装 Git for Windows。
3. 终端环境可正常使用 PowerShell、CMD 或 Git Bash。
4. 网络环境可正常访问 Claude Code 安装源。

官方文档明确指出，Windows 安装 Claude Code 前需要先安装 Git for Windows。同时，WinGet claude code 教程 安装是官方支持的正式方式之一。

如果你的 Windows 已经具备 ，最推荐直接使用这一种方式安装：

这条命令是目前官方文档提供的 Windows 正式安装方式之一。相比通过脚本安装，WinGet 在 Windows 上更稳定，尤其适合企业网络、代理环境或区域网络限制较多的机器。citeturnsearch0turnsearch3turnsearch4

安装完成后验证

安装成功后，建议立刻执行下面两条命令：

• ：确认 Claude Code 命令已经可用
• ：检查安装和环境配置是否正常

这也是官方文档推荐的验证方式。citeturnsearch0

安装并验证完成后，进入你的项目目录，执行：

首次运行时，Claude Code 会引导你完成登录流程。登录完成后，就可以在当前项目中直接使用它来分析代码、解释结构、修改文件和执行开发任务。官方文档说明，Windows 安装完成后可从 PowerShell、CMD 或 Git Bash 启动 Claude Code。citeturnsearch0turnsearch3

在 Windows 安装 Claude Code 时，最容易踩的坑不是安装本身，而是终端环境和脚本返回内容。

1）在 CMD 里执行 ，提示“不是内部或外部命令”

很多人会直接复制下面这条命令：

但如果你是在 CMD（命令提示符） 里执行，而不是在 PowerShell 里执行，就会看到类似报错：

原因很简单： 是 PowerShell 中 的别名，不是 CMD 命令。微软 PowerShell 文档确认 是 PowerShell 的命令，用于发送 HTTP/HTTPS 请求并获取响应内容。citeturnsearch2turnsearch5

这类问题本质上不是 Claude Code 安装失败，而是 在错误的终端里执行了 PowerShell 命令。

2）在 PowerShell 执行 ，结果报 、 或 错误

另一个常见情况是，明明已经进入 PowerShell，执行下面命令后仍然报错：

报错可能类似这样：

或者输出中出现：

根据 Claude Code 官方故障排除文档，这说明 安装 URL 返回的不是 PowerShell 脚本，而是一个 HTML 网页。也就是说， 实际执行的是网页源码，而不是安装脚本。常见原因包括：

• 区域限制
• 网络异常
• 企业代理或防火墙拦截
• 临时服务中断

官方在这种情况下给出的替代方案之一，就是在 Windows 上改用 WinGet 安装。citeturnsearch1turnsearch4

我的实际安装过程里，先后踩到了两个坑：

1. 在 CMD 中执行 PowerShell 命令，导致 无法识别。
2. 在 PowerShell 中执行安装脚本时，返回了 HTML 页面而不是 脚本。

因此最终改用：

安装成功后，Claude Code 可以正常使用。对于 Windows 用户来说，尤其是在公司网络、代理网络或者区域访问不太稳定的情况下，WinGet 往往是更省心的安装方式。这一点也与官方故障排除建议一致。citeturnsearch3turnsearch4

如果你已经安装成功，但执行 仍提示找不到命令，例如：

官方故障排除说明，这通常意味着 安装目录没有加入 PATH。Claude Code 在 Windows 上的可执行文件通常位于：

如果 PATH 没有包含这个目录，就会出现“已安装但命令不可用”的情况。可以先重开终端，再重新执行：

如果依旧不行，再检查 PATH 是否包含上述目录。citeturnsearch4

需要注意的是，WinGet 安装的 Claude Code 不会自动更新。后续如果想升级到最新版，需要手动执行：

这一点官方文档有明确说明。citeturnsearch0turnsearch3

如果你只想给读者一个最短可执行版本，可以直接写成下面这样：

Step 1：安装 Git for Windows

先安装 Git for Windows，这是 Claude Code 在 Windows 上的前置依赖。citeturnsearch0turnsearch3

Step 2：打开 PowerShell，执行安装

Step 3：验证安装

Step 4：进入项目目录启动

如果你准备在 Windows 上安装 Claude Code，我的建议很直接：

• 优先用 WinGet 安装
• 先装好 Git for Windows
• 不要在 CMD 里执行 PowerShell 的 命令
• 如果安装脚本返回 HTML 页面，直接改用 WinGet

对于大多数 Windows 用户来说，这条路径最稳，也最不容易踩坑。