外观
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 -vnvm 的好处是不需要 sudo,也不会和系统包管理器打架。
方法二:NodeSource 官方源
Debian / Ubuntu:
bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejsRHEL / 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