Node.js 安装教程

通过 npm 安装 Codex CLI、Claude Code、Gemini CLI 前，先安装 Node.js。ChatGPT 桌面端不需要 Node.js；已有 CLI 且能正常运行时，也不必为了配置连接重复安装。

Windows

1. 打开 Node.js 官方下载页，选择 **LTS（长期支持版）**和 Windows，下载 .msi 安装包。
2. 双击安装包，按默认选项完成安装，保留 npm 和添加到 PATH 的选项。
3. 关闭已有 PowerShell 窗口，再从开始菜单打开 PowerShell。

macOS

1. 打开 Node.js 官方下载页，选择 **LTS（长期支持版）**和 macOS，下载 .pkg 安装包。
2. 双击安装包，按提示完成安装。
3. 关闭已有终端，再打开 终端。

Linux / WSL

在 Linux 或 WSL 的 Bash 终端中依次运行，用 nvm 安装 Node.js LTS：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
nvm install --lts
nvm alias default 'lts/*'

WSL 需要在 WSL 内安装；只在 Windows 安装 Node.js 不能代替这一步。

确认安装

在新终端运行：

node --version
npm --version

两条命令都显示版本号，就可以回到对应工具教程继续：

ChatGPT / Codex CLI · Claude Code · Gemini CLI

提示找不到命令，或 PowerShell 禁止运行 npm.ps1？

找不到 node / npm 时，先关闭并重新打开终端；在编辑器里操作时，也要重新打开编辑器。仍找不到时，重新运行官方安装包，确认保留添加到 PATH 的选项。

PowerShell 提示禁止运行 npm.ps1 时，可将命令中的 npm 换成 npm.cmd，例如：

npm.cmd --version

安装方式参考 Node.js 官方下载说明。