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

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

一、什么是 Claude Code

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

二、Windows 安装 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 安装是官方支持的正式方式之一。

三、推荐安装方式：使用 WinGet 安装

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

winget install Anthropic.ClaudeCode

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

安装完成后验证

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

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

这也是官方文档推荐的验证方式。

四、首次启动 Claude Code

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

cd 你的项目目录
claude

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

五、我实际遇到的两个典型报错

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

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

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

irm https://claude.ai/install.ps1 | iex

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

'irm' 不是内部或外部命令，也不是可运行的程序或批处理文件。

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

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

2）在 PowerShell 执行 irm ... | iex，结果报 var、<script> 或 Invoke-Expression 错误

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

irm https://claude.ai/install.ps1 | iex

报错可能类似这样：

Invoke-Expression: Missing argument in parameter list.

或者输出中出现：

<script>
var ...
<!DOCTYPE html>

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

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

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

六、为什么我最终改用 WinGet

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

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

因此最终改用：

winget install Anthropic.ClaudeCode

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

七、如果安装成功但 claude 还是不能运行怎么办

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

'claude' is not recognized as an internal or external command

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

%USERPROFILE%\.local\bin\claude.exe

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

claude --version

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

八、后续更新怎么做

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

winget upgrade Anthropic.ClaudeCode

这一点官方文档有明确说明。

九、适合直接复制给读者的最短安装流程

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

Step 1：安装 Git for Windows

先安装 Git for Windows，这是 Claude Code 在 Windows 上的前置依赖。

Step 2：打开 PowerShell，执行安装

winget install Anthropic.ClaudeCode

Step 3：验证安装

claude --version
claude doctor

Step 4：进入项目目录启动

cd 你的项目目录
claude

十、总结

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

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

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

# windows # 人工智能
Logo
DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

cover

只要13个单词，就能给ChatGPT“下毒”？「美版贴吧」Reddit，正沦为AI“投毒基地”

avatar DeepSeek技术社区

Gemini API 支持语音流式生成：AI 应用正在从聊天框走向实时工作流

Google 在 2026-06-17 的 Gemini API 更新中加入语音生成流式支持。这个小更新背后，是 AI 应用从“生成一段回答”走向“实时交互、Agent 编排、可观测工作流”的架构变化。

avatar DeepSeek技术社区
cover

通用大模型崛起，企业自研模型还有必要吗？

avatar DeepSeek技术社区