Skip to content

Linux 平台安装 Node.js

Claude Code、CodeX 和 Gemini CLI 都需要 Node.js 18+ 运行环境。

提示

如果已安装 Node.js 18 或更高版本,可跳过此章节。验证命令:node -v

Ubuntu / Debian

使用 NodeSource 仓库(推荐):

bash
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

验证:

bash
node --version
npm --version

CentOS / RHEL

bash
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs

验证:

bash
node --version
npm --version

Fedora

bash
sudo dnf install -y nodejs npm

验证:

bash
node --version
npm --version

Arch Linux

bash
sudo pacman -S nodejs npm

验证:

bash
node --version
npm --version

使用 NVM 管理多版本(进阶)

安装 NVM(Node Version Manager):

bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

安装并使用 LTS 版本:

bash
nvm install --lts
nvm use --lts
nvm alias default node

常见问题

权限问题

配置 npm 使用用户目录:

bash
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

系统自带版本过旧

如果系统自带的 Node.js 版本过低,使用 NodeSource 仓库或 NVM 安装最新 LTS 版本。

下一步

安装完成后,继续安装 AI 编程工具:

和谐、友善、互助、开心