跳到主要内容

Windows 平台

部分 AI 编程工具和一键安装脚本需要 Node.js 环境。Windows 用户推荐使用本站的一键脚本安装 Node.js v22 LTS。

推荐：一键安装​

在 PowerShell 中执行：

irm https://docs.muskapi.cc/scripts/install-node.ps1 | iex

脚本只会安装或升级 Node.js 环境，并配置 npm registry，不会配置 Claude、Codex 或任何 API Key。

如果你在国内网络环境下安装较慢，脚本默认会提示是否使用国内镜像。也可以显式指定：

$env:INSTALL_MIRROR="cn"; irm https://docs.muskapi.cc/scripts/install-node.ps1 | iex

安装完成后关闭并重新打开 PowerShell，再检查版本：

node -v
npm -v
npx -v

node -v 显示 22 或更高版本即可。

备用：官方安装包​

  1. 打开 Node.js 官网。
  2. 下载 LTS 版本 Windows 安装包。
  3. 按默认选项安装。
  4. 安装完成后关闭并重新打开 PowerShell 或 Windows Terminal。
  5. 执行版本检查。
node -v
npm -v
npx -v

只要 node -v 显示 22 或更高版本，就可以继续安装客户端工具。

备用：winget 安装​

如果你的 Windows 已安装 winget，可以在 PowerShell 中执行：

winget install OpenJS.NodeJS.LTS

安装完成后重新打开终端，再检查版本：

node -v
npm -v

常见问题​

  • node 不是内部或外部命令：重启终端或电脑，仍失败则检查 Node.js 是否加入 PATH。
  • npx 执行很慢：检查网络代理、DNS 或 npm registry。
  • 版本低于 22：卸载旧版本后安装 LTS，或重新执行一键脚本。
  • PowerShell 禁止执行脚本：以管理员身份打开 PowerShell，或检查系统执行策略。