Windows 安装 claude-code cli

在 Windows 上安装 Claude Code：完美解决 PowerShell 限制与 npm 国内镜像配置

让 AI 编码助手 Claude Code 顺畅运行在 Windows 系统上，避开 PowerShell 的执行策略“坑”

最近 Anthropic 推出的 claude-code 命令行工具备受关注，不少开发者想在 Windows 上体验一番。然而在安装过程中，PowerShell 的默认安全策略往往会拦截 npm 全局安装的命令，导致安装失败或无法运行。本文将手把手带你完成 Node.js 安装、国内镜像加速配置，并彻底解决 PowerShell 的限制问题。

---

第一步：下载并安装 Node.js

访问 Node.js 官方下载页面：
🔗 https://nodejs.org/en/download

推荐选择 LTS 版本（长期支持版），稳定性更好。根据你的系统位数选择：

• Windows 64位 → Windows Installer (.msi)
• Windows 32位 → 同样选择对应架构的 .msi

下载后双击安装包，一路 Next，建议保持默认安装路径（C:\Program Files\nodejs\），这样环境变量会自动配置好。

安装完成后，打开 PowerShell（无需管理员），输入以下命令验证是否成功：

node -v
npm -v

如果正常显示版本号（如 v20.18.0 和 10.8.2），说明 Node.js 已安装成功。

---

第二步：配置国内镜像源（解决 npm 下载慢的问题）

默认 npm 仓库在国外，下载 @anthropic-ai/claude-code 可能会很慢甚至超时。推荐使用淘宝 npm 镜像。

在 PowerShell 中执行：

npm config set registry https://registry.npmmirror.com

设置完成后，可以查看当前镜像源：

npm config get registry

输出应为 https://registry.npmmirror.com/。

💡 提示：如果以后需要恢复官方源，执行 npm config set registry https://registry.npmjs.org/ 即可。

---

第三步：解决 PowerShell 的执行策略限制（重点）

这是 Windows 上最容易踩的坑。当你试图全局安装或运行某些 npm 包提供的命令时（包括 claude-code），PowerShell 可能会抛出类似错误：

无法加载文件 C:\Users\xxx\AppData\Roaming\npm\claude.ps1，因为在此系统上禁止运行脚本。

原因：PowerShell 默认的执行策略是 Restricted，禁止执行任何脚本文件。而 npm 全局安装的包有时会生成 .ps1 脚本，导致被拦。

解决方案一（推荐）：更改当前用户的执行策略

以普通用户身份打开 PowerShell（不需要管理员），执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后根据提示输入 Y 确认。

• RemoteSigned 表示允许运行本地脚本和已签名的远程脚本，安全性适中。
• -Scope CurrentUser 只影响当前用户，无需管理员权限，也不会影响系统其他账户。

解决方案二（管理员方式）：修改全局策略

如果你习惯使用管理员终端，可以右键“以管理员身份运行” PowerShell，然后执行：

Set-ExecutionPolicy RemoteSigned

同样输入 Y 确认。这种修改会影响本机所有用户。

验证策略是否生效

Get-ExecutionPolicy

如果输出 RemoteSigned 或 Unrestricted，说明脚本执行已放行。

⚠️ 注意：PowerShell 的核心限制≠ npm 命令无法运行。实际上 npm 命令本身（如 npm install）并不受影响，受限制的是 npm 安装后生成的 .ps1 或 .cmd 包装脚本。设置好执行策略后，你就可以正常使用 claude 命令了。

---

第四步：安装 Claude Code

所有准备工作完成后，在 PowerShell 中执行全局安装命令：

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

npm 会自动从国内镜像源下载并安装。安装完成后，会提示 added xxx packages in xx s。

验证安装

在任意位置运行：

claude --version

如果能正常输出版本号（如 0.1.0），说明安装成功，可以开始使用了！

---

常见问题与解决

问题现象	可能原因	解决方法
npm install -g 卡住不动	国内网络访问官方源慢	按第二步配置淘宝镜像源
claude 命令找不到	环境变量未包含 npm 全局路径	检查 %AppData%\npm 是否在 PATH 中（安装 Node.js 时一般会自动添加）
仍提示禁止运行脚本	未正确设置执行策略	重新执行 Set-ExecutionPolicy -Scope CurrentUser，并确保没有拼写错误
安装过程中报 404 或 ETIMEDOUT	镜像源同步延迟	可以稍后再试，或临时改用官方源 npm config set registry https://registry.npmjs.org/

---

总结

通过以上四个步骤，你不仅成功安装了 claude-code，还顺手配置了国内 npm 镜像，解决了 PowerShell 的安全策略限制。现在你可以在终端里愉快地使用 claude 命令，让 AI 协助你完成编码任务了。

一句话回顾：
先装 Node.js，再配淘宝源，最后放行 PowerShell 执行策略 —— 三步搞定 Claude Code 在 Windows 上的落地。

如果本文对你有帮助，欢迎分享给同样在 Windows 上折腾 Claude Code 的朋友～