Node.js 环境安装指南

Claude Code、Gemini CLI、Codex 等工具均依赖 Node.js 运行环境，请先完成此步骤。

Windows

• 方法一：官方下载（推荐） 前往 Node.js 官网 下载 LTS 版本，双击安装包按提示完成安装。

• 下载以后，一直下一步直到安装完成

• 方法二：使用 Chocolatey

  choco install nodejs-lts

• 方法三：使用 Scoop

  scoop install nodejs-lts

macOS

• 方法一：使用 Homebrew（推荐）

  brew install node

• 方法二：官方下载 前往 Node.js 官网 下载 macOS 安装包。

Linux

• Ubuntu / Debian

  curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
  sudo apt-get install -y nodejs

• CentOS / RHEL

  curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
  sudo yum install -y nodejs

验证安装

node --version
npm --version

两个命令均输出版本号即表示安装成功。

切换 npm 镜像源（无科学上网环境）

如果安装依赖时速度较慢或超时，执行以下命令切换到国内镜像源：

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

验证是否切换成功：

npm config get registry

输出 https://registry.npmmirror.com 即表示生效。