Node.js 环境安装教程
Claude Code、Codex、Gemini CLI 等命令行工具都依赖 Node.js，请先完成本节再进行后续配置。
💡
先决条件：建议安装 Node.js LTS（长期支持版，≥ 18）。安装完成后请记得新开一个终端窗口，使环境变量生效。
Windows
方法一 · 官方安装包（最简单）
访问 nodejs.org，下载 LTS 版 .msi 安装包，一路「下一步」完成即可（默认会勾选自动配置环境变量）。
方法二 · Chocolatey
PowerShell
choco install nodejs-lts
方法三 · Scoop
PowerShell
scoop install nodejs-lts
macOS
方法一 · Homebrew（推荐）
BASH
brew install node
方法二 · 官方安装包
访问 nodejs.org 下载 macOS 版 .pkg，双击安装。
Linux
方法一 · nvm（推荐，免 sudo、可多版本）
BASH
# 安装 nvm（版本号以官方为准）curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash# 重开终端后安装并启用 LTSnvm install --ltsnvm use --lts
方法二 · 包管理器
BASH
# Debian / Ubuntu（系统源版本可能较旧，建议优先用 nvm）sudo apt update && sudo apt install -y nodejs npm
验证安装
BASH
node -vnpm -v
能正常输出版本号（如 v20.x.x）即表示安装成功，请确认主版本号 ≥ 18（若包管理器装出的版本偏旧，请改用 nvm）。