Linux 安装 Node.js

Claude Code、CodeX 和 Gemini CLI 均需要 Node.js 18+ 版本。

方法一：nvm（推荐，支持多版本）

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

# 重新加载配置
source ~/.bashrc   # bash 用户
source ~/.zshrc    # zsh 用户

# 安装最新 LTS 版本
nvm install --lts
nvm use --lts

方法二：NodeSource（推荐生产环境）

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

# RHEL / CentOS / Fedora
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo yum install nodejs

方法三：发行版包管理器

# Ubuntu / Debian（版本可能较旧）
sudo apt update
sudo apt install nodejs npm

# Arch Linux
sudo pacman -S nodejs npm

# Fedora
sudo dnf install nodejs

验证安装

node -v
npm -v

配置 npm 国内镜像

npm config set registry https://registry.npmmirror.com

常见问题

版本太低？

使用 nvm 可以方便地切换版本：

nvm install 22
nvm use 22
nvm alias default 22

权限问题？

不要用 sudo 运行 npm，改用 nvm 管理安装的 Node.js 即可避免权限问题。