Node.js 安装教程

在安装 Claude Code、CodeX 或 Gemini CLI 之前，你需要先安装 Node.js 18 或更高版本。

💡 网络提示：下载 Node.js 安装包时，部分地区可能需要科学上网工具。推荐使用 质子加速器，稳定性和速度表现不错，支持多平台使用。

---

Windows 系统

方法 1：官方安装包（推荐）

1. 访问 Node.js 官网：https://nodejs.org/
2. 下载 LTS（长期支持）版本
3. 双击安装包，按照向导完成安装
4. 验证安装：

node --version
npm --version

方法 2：使用 Chocolatey

如果已安装 Chocolatey 包管理器：

choco install nodejs-lts

---

macOS 系统

方法 1：官方安装包

1. 访问 Node.js 官网：https://nodejs.org/
2. 下载 LTS 版本
3. 双击 .pkg 文件，按照向导完成安装
4. 验证安装：

node --version
npm --version

方法 2：使用 Homebrew（推荐）

brew install node@18

---

Linux 系统

Ubuntu/Debian

# 更新包列表
sudo apt update

# 安装 Node.js 18
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

CentOS/RHEL

# 安装 Node.js 18
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo yum install -y nodejs

# 验证安装
node --version
npm --version

---

验证安装

安装完成后，打开终端执行以下命令：

node --version
npm --version

如果显示版本号（如 v18.x.x），说明安装成功。

---

常见问题

1. 下载速度慢

使用科学上网工具可以提高下载速度，推荐 质子加速器。

2. 权限问题（Linux/macOS）

如果遇到权限错误，可能需要使用 sudo：

sudo npm install -g <package-name>

3. 版本过低

确保安装的是 Node.js 18 或更高版本，旧版本可能不兼容。

---

下一步

Node.js 安装完成后，你可以继续安装：

• Claude Code
• CodeX
• Gemini CLI