Node.js 环境安装指南

Codex、Claude Code、OpenClaw 等命令行工具和开发插件通常依赖 Node.js 和 npm (Node 包管理器)。在配置 AI 开发工具之前，请先确保安装了稳定的 Node.js 运行环境。

推荐版本

建议安装 Node.js 20 LTS 或更高版本。

1. 检查是否已安装

打开您的终端 (Terminal) 或命令提示符，执行以下命令检查系统中是否已存在 Node.js 和 npm：

node -v
npm -v

如果命令返回了版本号（例如 v20.11.0 和 10.2.4），说明您的 Node.js 环境已经就绪，可以直接开始配置您的 AI 客户端。

---

2. 操作系统安装步骤

macOS

如果您使用的是 Homebrew (macOS 开发者推荐使用)，可以直接在终端运行以下命令进行安装：

# 安装 Node.js
brew install node

# 验证安装
node -v
npm -v

如果您未使用 Homebrew，请前往 Node.js 官网 下载并运行 macOS 官方安装包 (.pkg)。

Windows

1. 前往 Node.js 官网 下载 LTS 版本的 Windows 安装包 (.msi)。
2. 运行安装包，保持所有默认选项（确保勾选安装 npm 并配置环境变量）。
3. 打开一个 全新的 PowerShell 或命令提示符窗口，执行验证命令：

   node -v
   npm -v

Linux (Ubuntu / Debian)

使用系统自带的包管理器安装：

sudo apt update
sudo apt install -y nodejs npm

# 验证安装
node -v
npm -v

版本管理工具 (推荐)

对于生产环境或多项目开发，建议使用 nvm 或 fnm 等版本管理工具来管理多个 Node.js 版本，避免因使用 sudo 导致全局包安装出现权限错误。

---

3. 常见问题排查

• npm: command not found： 说明安装未成功，或者需要重启终端窗口以应用最新的环境变量路径。
• permission denied (EACCES 权限错误)： 避免使用 sudo npm install -g 安装全局包。建议使用 nvm/fnm 进行版本管理，或者配置 npm 使用当前用户拥有的目录。
• 更新后版本仍旧未变： 重启您的终端，或检查系统的 PATH 环境变量，确保新安装的 Node.js 路径优先级高于旧路径。