1. 常见误区：切勿使用 PowerShell 直连下载脚本

在安装许多开源工具（如 Homebrew 或 Chocolatey）时，我们习惯了使用一行命令直接拉取并运行网络脚本。因此，部分开发者在寻找 Claude Code 安装方法时，可能会尝试运行类似下面的命令：

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

千万不要这么做！这会导致直接报错：

Invoke-RestMethod : 远程服务器返回错误: (403) 已禁止 或抛出包含大量乱码的 WebException。

原理解析：
Anthropic 的官方网站启用了严格的 Cloudflare 盾（反爬虫保护）。当 PowerShell 的 irm 命令尝试访问该地址时，Cloudflare 识别出这不是正常的浏览器请求，于是返回了一个 JavaScript 人机验证页面。由于 PowerShell 无法执行这段 JS 代码，请求直接崩溃。更重要的是，官方并未在该路径提供任何 .ps1 脚本。

安全提醒：
作为开发者，永远不要将未知的网络 URL 直接通过管道符传递给 iex (Invoke-Expression)。这种“盲目执行”的操作极其危险，容易导致恶意代码注入。

2. 前置准备：配置 Node.js 环境

Claude Code 的本质是一个基于 Node.js 运行的命令行程序（CLI），它通过 npm 包管理器进行分发。因此，在安装之前，你必须确保系统中已经正确安装了 Node.js。

1. 前往 Node.js 官网 下载并安装长期支持版（LTS）。
2. 安装完成后，打开 PowerShell 或 CMD，验证是否安装成功：

node -v
npm -v

如果上述命令输出了版本号（建议 Node.js 18 及以上），则说明前置环境准备就绪。

3. 正确安装与“假死”报错排查

在终端中执行以下命令，将 Claude Code 全局安装到你的系统中：

npm install -g @anthropic-ai/claude-code

等待进度条走完后，很多 Windows 用户兴冲冲地输入 claude 回车，却迎来了经典的满屏红字报错：

claude : 无法将“claude”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确，然后再试一次。
ErrorId : CommandNotFoundException

排查方法：
先不要急着卸载重装。你可以尝试运行下面这行命令：

npx @anthropic-ai/claude-code

如果这个命令成功唤起了 Claude，那就说明软件已经完美安装在你的电脑里了。直接输入 claude 会报错，仅仅是因为 Windows 系统的“环境变量”迷路了——它不知道去哪个文件夹里找这个刚刚装好的程序。

4. 终极解法：配置系统环境变量 (PATH)

为了让系统能在任何目录下直接识别 claude 命令，我们需要把 npm 的全局安装路径告诉 Windows。请严格按照以下步骤操作：

第一步：获取 npm 全局路径
在 PowerShell 中运行以下命令：

npm config get prefix

控制台会输出一行绝对路径，通常类似于：C:\Users\你的用户名\AppData\Roaming\npm。用鼠标选中并复制这行路径。

第二步：将路径写入 Windows 系统变量

1. 按下键盘上的 Win 键，搜索 “环境变量”（或“编辑系统环境变量”）并打开。
2. 在弹出的系统属性窗口中，点击右下角的 “环境变量…” 按钮。
3. 在上方“用户变量”或下方“系统变量”的列表中，找到名为 Path 的变量，双击打开编辑界面。
4. 点击右侧的 “新建” 按钮。
5. 将刚刚复制的 npm 路径粘贴进去。
6. 一路点击 “确定”，保存并关闭所有设置窗口。

第三步：重启终端（极其关键）
当前正在运行的 PowerShell 窗口仍然使用的是旧的环境变量缓存。你必须彻底关闭当前终端，重新打开一个新的 PowerShell 或 CMD 窗口。

5. 首次运行与授权登录

现在，在全新的终端窗口中输入：

claude

你将看到清爽的命令行界面成功启动！

首次运行时，Claude Code 会要求你进行 OAuth 身份验证。系统会自动在你的默认浏览器中打开一个 Anthropic 的授权页面，登录你的账号并确认授权后，回到终端，你就可以开始享受 AI 辅助编码的乐趣了。

总结：
Windows 系统下全局安装 npm 包经常会遇到环境变量未配置的问题。只要掌握了 npm config get prefix 和配置 Path 的技巧，以后遇到类似的 CLI 工具报错（比如安装 Vue CLI、React 脚本等），你都可以用同样的思路轻松秒杀。

祝你编码愉快！