ai2saveai2save

Node.js 环境安装教程

Claude Code、Codex CLI、Gemini CLI 以及多数 API 脚本都依赖 Node.js。建议安装 LTS 版本,主版本号保持在 18 或更高。

Windows

方法一:官方安装包

访问 nodejs.org,下载 LTS .msi 安装包,一路按「下一步」完成安装,并保留自动加入 PATH 的选项。

方法二:Chocolatey

choco install nodejs-lts -y

方法三:Scoop

scoop install nodejs-lts

重新打开 PowerShell 后验证:

node --version
npm --version

macOS

方法一:Homebrew(推荐)

brew install node
node --version
npm --version

方法二:官方安装包

访问 nodejs.org 下载 macOS .pkg,双击安装后重新打开终端。

Linux

方法一:nvm(推荐,免 sudo、支持多版本)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc  # zsh 用户使用 source ~/.zshrc
nvm install --lts
nvm use --lts
node --version
npm --version

方法二:包管理器

# Debian / Ubuntu
sudo apt update
sudo apt install -y nodejs npm

# Fedora
sudo dnf install -y nodejs npm

安装 CLI 的通用方式

npm install -g <package-name>

如果出现权限错误,优先检查 nvm 或当前 Node 版本是否正确生效,不建议直接用管理员权限覆盖系统目录。安装后用 where node(Windows)或 which node(macOS/Linux)确认路径。