2026-05-15 18:07:58 +08:00
|
|
|
|
# Linux 平台安装 Node.js
|
|
|
|
|
|
|
|
|
|
|
|
**三大 AI 编程工具的必备运行环境**
|
|
|
|
|
|
|
|
|
|
|
|
💡 重要说明
|
|
|
|
|
|
|
|
|
|
|
|
Claude Code、CodeX 和 Gemini CLI 都需要 Node.js 18+ 运行环境。 如果您已安装 Node.js 18 或更高版本，可跳过本章节。 验证命令：`node -v`
|
|
|
|
|
|
|
|
|
|
|
|
## Ubuntu/Debian 发行版
|
|
|
|
|
|
|
|
|
|
|
|
### 使用 NodeSource 仓库（推荐）
|
|
|
|
|
|
|
|
|
|
|
|
bash
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
|
|
|
|
|
|
sudo apt-get install -y nodejs
|
|
|
|
|
|
|
|
|
|
|
|
# 验证安装
|
|
|
|
|
|
node --version
|
|
|
|
|
|
npm --version
|
|
|
|
|
|
|
|
|
|
|
|
1
|
|
|
|
|
|
2
|
|
|
|
|
|
3
|
|
|
|
|
|
4
|
|
|
|
|
|
5
|
|
|
|
|
|
6
|
|
|
|
|
|
|
|
|
|
|
|
## CentOS/RHEL 发行版
|
|
|
|
|
|
|
|
|
|
|
|
bash
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
|
|
|
|
|
|
sudo yum install -y nodejs
|
|
|
|
|
|
|
|
|
|
|
|
# 验证安装
|
|
|
|
|
|
node --version
|
|
|
|
|
|
npm --version
|
|
|
|
|
|
|
|
|
|
|
|
1
|
|
|
|
|
|
2
|
|
|
|
|
|
3
|
|
|
|
|
|
4
|
|
|
|
|
|
5
|
|
|
|
|
|
6
|
|
|
|
|
|
|
|
|
|
|
|
## Fedora 发行版
|
|
|
|
|
|
|
|
|
|
|
|
bash
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
sudo dnf install -y nodejs npm
|
|
|
|
|
|
|
|
|
|
|
|
# 验证安装
|
|
|
|
|
|
node --version
|
|
|
|
|
|
npm --version
|
|
|
|
|
|
|
|
|
|
|
|
1
|
|
|
|
|
|
2
|
|
|
|
|
|
3
|
|
|
|
|
|
4
|
|
|
|
|
|
5
|
|
|
|
|
|
|
|
|
|
|
|
## Arch Linux
|
|
|
|
|
|
|
|
|
|
|
|
bash
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
sudo pacman -S nodejs npm
|
|
|
|
|
|
|
|
|
|
|
|
# 验证安装
|
|
|
|
|
|
node --version
|
|
|
|
|
|
npm --version
|
|
|
|
|
|
|
|
|
|
|
|
1
|
|
|
|
|
|
2
|
|
|
|
|
|
3
|
|
|
|
|
|
4
|
|
|
|
|
|
5
|
|
|
|
|
|
|
|
|
|
|
|
## 使用 nvm（推荐进阶用户）
|
|
|
|
|
|
|
|
|
|
|
|
nvm 允许您管理多个 Node.js 版本：
|
|
|
|
|
|
|
|
|
|
|
|
bash
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 安装 nvm
|
|
|
|
|
|
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
|
|
|
|
|
|
|
|
|
|
|
|
# 重新加载 shell 配置
|
|
|
|
|
|
source ~/.bashrc
|
|
|
|
|
|
|
|
|
|
|
|
# 安装 Node.js LTS
|
|
|
|
|
|
nvm install --lts
|
|
|
|
|
|
|
|
|
|
|
|
# 设置默认版本
|
|
|
|
|
|
nvm use --lts
|
|
|
|
|
|
nvm alias default node
|
|
|
|
|
|
|
|
|
|
|
|
1
|
|
|
|
|
|
2
|
|
|
|
|
|
3
|
|
|
|
|
|
4
|
|
|
|
|
|
5
|
|
|
|
|
|
6
|
|
|
|
|
|
7
|
|
|
|
|
|
8
|
|
|
|
|
|
9
|
|
|
|
|
|
10
|
|
|
|
|
|
11
|
|
|
|
|
|
12
|
|
|
|
|
|
|
|
|
|
|
|
## 常见问题
|
|
|
|
|
|
|
|
|
|
|
|
### 权限问题
|
|
|
|
|
|
|
|
|
|
|
|
如果遇到权限问题，可以配置 npm 使用用户目录：
|
|
|
|
|
|
|
|
|
|
|
|
bash
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
mkdir ~/.npm-global
|
|
|
|
|
|
npm config set prefix '~/.npm-global'
|
|
|
|
|
|
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
|
|
|
|
|
|
source ~/.bashrc
|
|
|
|
|
|
|
|
|
|
|
|
1
|
|
|
|
|
|
2
|
|
|
|
|
|
3
|
|
|
|
|
|
4
|
|
|
|
|
|
|
|
|
|
|
|
### 版本过旧
|
|
|
|
|
|
|
|
|
|
|
|
如果系统自带的 Node.js 版本过旧，建议使用 NodeSource 仓库或 nvm 安装最新 LTS 版本。
|
|
|
|
|
|
|
|
|
|
|
|
## 下一步
|
|
|
|
|
|
|
|
|
|
|
|
✅ 环境准备完成！
|
|
|
|
|
|
|
|
|
|
|
|
现在您可以继续安装 Claude Code、CodeX 或 Gemini CLI 了。
|
|
|
|
|
|
|
|
|
|
|
|
* [安装 Claude Code](</deploy/claude-code>)
|
|
|
|
|
|
* [安装 CodeX](</deploy/codex>)
|
|
|
|
|
|
* [安装 Gemini CLI](</deploy/gemini-cli>)
|
