why01 API 文档

主题

Linux 安装 Node.js

Claude Code / Codex CLI / Gemini CLI 都依赖 Node.js 18+。已装过的跑 node -v 看版本，≥ v18 直接跳过本页。

推荐：nvm（适用所有发行版） ​

最简单 + 跨发行版通用 + 多版本切换。

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

# 2. 让 shell 加载 nvm（脚本会写到 ~/.bashrc 或 ~/.zshrc）
source ~/.bashrc       # bash 用户
# 或
source ~/.zshrc        # zsh 用户

# 3. 装 LTS
nvm install --lts
nvm use --lts
nvm alias default lts/*

# 4. 验证
node -v && npm -v

Ubuntu / Debian ​

用 NodeSource 官方源（推荐） ​

Ubuntu 24.04 / 22.04 / 20.04 / Debian 12 / 11 通用。

bash
# 装 Node 22 LTS（NodeSource 官方安装脚本）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 验证
node -v && npm -v

TIP

如果你想要 Node 20 LTS，把 setup_22.x 换成 setup_20.x。

系统自带 apt（版本可能旧） ​

bash
sudo apt update && sudo apt install -y nodejs npm

WARNING

Ubuntu 22.04 默认源里的 nodejs 是 v12（已过时，跑 Claude Code 会报版本不够）。请优先用上面的 nvm 或 NodeSource，不要直接 apt install nodejs。

CentOS / RHEL / Rocky / Alma ​

bash
# Node 22 LTS（NodeSource 官方安装脚本）
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo dnf install -y nodejs

# 验证
node -v && npm -v

Arch / Manjaro ​

bash
sudo pacman -S nodejs npm

Arch 主仓滚动更新，nodejs 通常是 latest。需要 LTS 用 nodejs-lts-iron（Node 20）或 nodejs-lts-jod（Node 22）。

Alpine（容器环境） ​

bash
apk add --no-cache nodejs npm

验证安装 ​

bash
node -v
npm -v

期望：

v22.11.0     (≥ v18.0.0)
10.9.0

常见问题 ​

npm install -g xxx 报 EACCES 权限错 ​

Linux 上不要用 sudo npm install -g——会留 root 权限文件污染你的家目录配置。正确做法：

  • 方法 A（推荐）：用 nvm（顶部第一节），nvm 装的 Node 全局包在 ~/.nvm/，无权限问题
  • 方法 B：改 npm 全局前缀到家目录：
    bash
    mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

npm install 慢 ​

国内服务器 / 国内访问，换镜像：

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

恢复官方：

bash
npm config set registry https://registry.npmjs.org

node: command not found ​

PATH 没生效。常见原因：

  • 用 nvm 但没 source 配置文件 → source ~/.bashrc
  • 装 NodeSource 后没开新 shell → 关掉重开
  • which node 输出空说明真的没装上 → 重跑安装步骤

下一步 ​