Skip to content

Linux 平台安装 Node.js

需要什么版本

Node.js 18 或更高版本,推荐当前 LTS。

方法一:nvm(推荐,不污染系统)

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

# 重新加载 shell 配置
source ~/.bashrc

# 安装并使用 LTS
nvm install --lts
nvm use --lts
node -v

nvm 的好处是不需要 sudo,也不会和系统包管理器打架。

方法二:NodeSource 官方源

Debian / Ubuntu:

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

RHEL / CentOS / Fedora:

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

方法三:系统包管理器

bash
# Debian / Ubuntu
sudo apt update && sudo apt install -y nodejs npm

# Arch
sudo pacman -S nodejs npm

# Alpine
sudo apk add nodejs npm

版本可能偏旧

系统源里的 Node.js 往往落后好几个大版本。如果安装后发现 node -v 低于 18,请改用 nvm 或 NodeSource。

安装客户端工具

bash
npm install -g @anthropic-ai/claude-code
npm install -g @openai/codex
npm install -g @google/gemini-cli

服务器上的注意事项

如果你在无图形界面的服务器上使用:

  • Claude Code 首次运行需要浏览器授权。可以先用 claude setup-token 在本地生成令牌,再把令牌带到服务器使用。
  • 某些工具会尝试打开浏览器,无头环境下请查阅对应工具的文档使用设备码授权流程。

常见问题

npm install -g 报 EACCES

不要用 sudo。改用用户级全局目录:

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

内存不足导致安装失败

小内存机器(1G 以下)编译依赖时可能 OOM,临时加交换分区:

bash
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

下一步

Aivisx Link · AI API 网关平台