安装 Node.js#

Node.js 是运行 npm/pnpm 和许多 AI CLI 工具的基础环境。DAMI TOKEN 文档站和前端构建也使用 Node.js 生态。

版本要求#

建议安装 Node.js 20 或更新的长期支持版本。版本过旧可能导致依赖安装失败或 CLI 工具无法启动。

检查版本：

node --version
npm --version

安装步骤#

方法一：官网下载安装包（推荐新手）#

1. 打开 Node.js 官方下载页。
2. 下载 LTS 版本安装包。
3. 按默认选项安装。
4. 重新打开终端。
5. 执行 node --version 验证。

方法二：使用 Homebrew 安装（推荐有经验的用户）#

macOS 用户可以使用 Homebrew：

brew install node
node --version

如果你使用 nvm、fnm 或 volta，也可以通过版本管理工具安装指定 Node.js 版本。

常见问题#

npm 安装全局包时提示权限不足（macOS/Linux）#

建议使用 Node 版本管理器，或调整 npm 全局目录。不要随意使用 sudo npm install -g，避免后续权限混乱。

如果项目使用 pnpm，可以启用 Corepack：

corepack enable
corepack prepare [email protected] --activate
pnpm --version

下一步#

Node.js 安装完成后，可以继续安装 Claude Code 或 Codex CLI。