本页内容
Node.js 环境
安装 Node.js 和 npm。Claude Code、Codex CLI、Pi、DeepSeek Harness 等命令行工具都要先装好它。
Claude Code、Codex CLI、Pi、DeepSeek Harness 都用 npm 安装,OpenCode 也可以用 npm 安装,所以要先装 Node.js。下面以 Mac 为例,Windows 单独说明。已有 LTS、22.19 或以上版本 的可以跳过。
1. 下载 Node.js
- 打开 Node.js 官方下载页,选择 LTS、22.19 或以上版本。
- Mac 点 苹果菜单 → 关于本机 查看芯片:M 系列选 ARM64,Intel 选 x64。在下载页找到 Or get a prebuilt Node.js,系统选 macOS,点 macOS Installer (.pkg),不要选 Source Code。

①系统选 macOS;②按本机芯片选 ARM64 或 x64;③点 macOS Installer (.pkg)。
2. 安装 Node.js
在 Finder → 下载 里双击 .pkg,按 继续 → 安装 完成,再点 关闭。
Windows:下载页选 Windows 和对应架构,下载 .msi,按向导安装。
3. 验证安装
Mac 按 ⌘ 空格 搜索「终端」并打开(安装前已开的终端要关掉重开);Windows 新开 PowerShell。逐行运行:
node --version
npm --version
能看到 Node.js 和 npm 的版本号即可。
Windows 的 PowerShell 里,后面教程中的 npm / npx 命令写成 npm.cmd / npx.cmd,不用改执行策略。
装好后回到要接入的工具教程继续,例如 Codex CLI、Pi、DeepSeek Harness。