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

运行项目并下载源码powershell

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

    安装完成后验证

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

    claude --version
claude doctor

    运行项目并下载源码powershell
      • claude --version：确认 Claude Code 命令已经可用
      • claude doctor：检查安装和环境配置是否正常

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

      四、首次启动 Claude Code

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

      cd 你的项目目录
claude

      运行项目并下载源码powershell

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

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

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

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

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

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

        运行项目并下载源码powershell

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

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

          运行项目并下载源码text

            原因很简单：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

            运行项目并下载源码powershell

              报错可能类似这样：

              Invoke-Expression: Missing argument in parameter list.

              运行项目并下载源码text

                或者输出中出现：

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

                运行项目并下载源码text

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

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

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

                  六、为什么我最终改用 WinGet

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

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

                  因此最终改用：

                  winget install Anthropic.ClaudeCode

                  运行项目并下载源码powershell

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

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

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

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

                    运行项目并下载源码text

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

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

                      运行项目并下载源码text

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

                        claude --version

                        运行项目并下载源码powershell

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

                          八、后续更新怎么做

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

                          winget upgrade Anthropic.ClaudeCode

                          运行项目并下载源码powershell

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

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

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

                            Step 1：安装 Git for Windows

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

                            Step 2：打开 PowerShell，执行安装
                            winget install Anthropic.ClaudeCode

                            运行项目并下载源码powershell
                              Step 3：验证安装
                              claude --version
claude doctor

                              运行项目并下载源码powershell
                                Step 4：进入项目目录启动
                                cd 你的项目目录
claude

                                运行项目并下载源码powershell

                                  十、总结

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

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

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

                                              </div>
                                  # java
                                  Logo
                                  https://edu.csdn.net/learn/39067/627173?utm_source=2019755004

                                  汇聚全球AI编程工具，助力开发者即刻编程。

                                  更多推荐

                                  cover

                                  程序员如何用 Gemini 3.5 辅助理解陌生代码？实战避坑与选型攻略

                                  avatar AI编程社区

                                  2026企业级AI API中转站选型指南：六大API聚合平台混合路由与调度能力深度解析

                                  步入2026年，AI工程化落地已进入深水区。随着GPT-5.5、Claude Fable 5.0、Gemini 3.5 Flash以及国内智谱GLM 5.2、Kimi K2.7、DeepSeek-V4等千亿级参数模型的相继发布，单一模型架构已难以满足复杂的业务需求。当前的技术趋势正朝着多模型协同（Multi-Model Orchestration）与智能路由编排演进。在此背景下，API聚合平台不再

                                  avatar AI编程社区

                                  十大GEO优化平台对比测评：从普惠到企业级工具推荐，精准好用高性价比

                                  对于企业品牌而言，如何在AI大模型的“黑盒”中通过优化获得可见性，已成为2026年数字营销的核心命题。当用户在ChatGPT、Perplexity或国内的豆包、DeepSeek中提问时，AI生成的回答中如果包含了你的品牌或观点，这就是GEO的胜利。其核心优势在于“数据可视化”与“归因分析”，能清晰展示内容被AI引用的路径，帮助企业快速调整策略，是追求高性价比与精准数据的企业首选。智推时代提供了一套

                                  avatar AI编程社区