Nebula API
Documentation Node 安装 > Linux

Linux 平台安装 Node.js

在 Linux 上配置 Node.js 运行环境,为使用 Claude Code 等 AI 编程工具做准备。

Important Note

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

安装方法

Ubuntu / Debian

使用 NodeSource 仓库安装:

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

CentOS / RHEL

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

Fedora

sudo dnf install nodejs

Arch Linux

sudo pacman -S nodejs npm

使用 nvm(推荐)

nvm 可以管理多个 Node.js 版本:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 18
nvm use 18
nvm alias default 18

验证安装

node --version   # 应输出 v18.x.x
npm --version    # 应输出 9.x.x

常见问题

权限问题?

配置 npm 使用用户目录,避免使用 sudo:

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 版本。

下一步

安装完成后,您可以继续: