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)确认路径。