快速开始

Node.js 环境安装教程

在 macOS、Windows、Linux 准备 Node.js 运行环境,并验证 npm / pnpm 是否可用。

先把本地运行环境准备好,后面的 Codex、Claude Code 与脚本配置才有稳定落点。

第一步:安装 Node.js

建议优先安装 Node.js 当前维护中的 LTS 版本。这样与 Next.js、CLI 工具和大多数生态包的兼容性会更稳。

brew install node@22
node -v
npm -v

第二步:准备常用包管理器

如果你后面要运行甜酒官网前端或其他 Node 项目,建议顺手安装 pnpm。它在 monorepo 里更省空间,也更快。

npm install -g pnpm
pnpm -v

第三步:验证终端环境

  • 确认 `node -v`、`npm -v`、`pnpm -v` 都能返回版本号。
  • 确认你的终端有读写家目录权限,后面 CLI 会在家目录下写配置文件。
  • 如果你在公司电脑或云开发环境中操作,先确认代理和证书策略不会阻断 npm 下载。
如果这一步没有先跑通,后面的 CLI 安装、配置文件写入和模型调用都容易卡在最基础的环境问题上。