Linux 平台安装 Node.js

CodeX、Gemini CLI 等工具均需要 Node.js 环境。请按以下步骤在 Linux 系统上安装。

方法一：NodeSource 官方源（推荐）

Ubuntu / Debian

# 安装 Node.js 20.x LTS
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -
sudo apt-get install -y nodejs

CentOS / RHEL / Fedora

# 安装 Node.js 20.x LTS
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs

方法二：包管理器安装

Ubuntu / Debian（系统源，版本较旧）

sudo apt update
sudo apt install nodejs npm

Arch Linux

sudo pacman -S nodejs npm

方法三：nvm（版本管理器，推荐用于开发环境）

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

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

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

验证安装

node --version
npm --version

如果显示版本号（如 v20.x.x），说明安装成功。

提示

常见问题

npm 权限问题

如果遇到 npm 全局安装权限问题，建议使用 nvm 管理 Node.js，无需 sudo：

# 使用 nvm 安装后，全局包无需 sudo

版本过低

若系统源中的 Node.js 版本过低，请使用 nvm 或 NodeSource 官方源安装较新版本。

下一步

✅ 环境准备完成！

• 安装 CodeX
• 使用 CC-Switch 工具