在Linux上无sudo安装用户级Node.js、npm与Codex的操作步骤

适用场景

在 Linux 多用户环境中，普通用户通常没有系统目录写权限。当 npm 的全局安装目录指向 /usr/local 等系统目录时，直接执行 npm install -g 可能遇到 EACCES 权限错误。

本文适用于 Linux x86_64、Bash 环境。目标是在同一个 Bash 终端中，以普通用户身份完成以下操作：

• 将 Node.js 安装到 $HOME/.local/node，目录名不带版本号（个人喜好）；
• 将 npm 全局安装目录设置为 $HOME/.npm-global；
• 全程不使用 sudo；
• 基于该环境安装并启动 Codex。

本文使用 Node.js 24.22.2 LTS。

这里的“用户级安装”指安装位置和配置属于当前用户。

1. 创建 Node.js 安装目录

mkdir -p "$HOME/.local/node"

2. 下载 Node.js 安装包

该安装包包含 Node.js 和 npm：

curl -fL --retry 3 https://nodejs.org/dist/v24.22.2/node-v24.22.2-linux-x64.tar.gz -o "$HOME/.local/node.tar.gz"

下载成功后再继续解压。

3. 解压到安装目录

使用 --strip-components=1 去掉压缩包内带版本号的顶层目录，使文件直接进入 $HOME/.local/node：

tar -xzf "$HOME/.local/node.tar.gz" -C "$HOME/.local/node" --strip-components=1

4. 让当前终端找到 Node.js 和 npm

将用户安装的 Node.js 命令目录放在 PATH 前面：

export PATH="$HOME/.local/node/bin:$PATH"

这会让当前终端优先使用该目录下的 Node.js 和 npm，不会卸载或替换系统中的版本。

5. 检查 Node.js 版本

node --version

预期输出：v24.22.2

也可以检查实际使用的命令位置：

command -v node

预期指向当前用户的 .local/node/bin/node。

6. 检查 npm 版本

npm --version

该命令应正常输出安装包附带的 npm 版本号，npm 的版本号不需要与 Node.js 相同。

7. 创建 npm 全局安装目录

mkdir -p "$HOME/.npm-global"

8. 设置 npm 全局安装位置

显式将配置写入当前用户的 npm 配置文件：

npm config set prefix "$HOME/.npm-global"

在默认配置下，用户配置文件是 $HOME/.npmrc。后续 npm 全局包及其命令链接会分别安装到：

$HOME/.npm-global/lib/node_modules
$HOME/.npm-global/bin

这可以规避因全局安装目录位于系统路径而产生的权限错误。

需要注意：该配置属于当前用户的 npm 配置，会影响该用户使用其他 Node.js/npm 安装时的全局安装位置，并非仅对这一次安装生效。

9. 将命令路径写入 Bash 配置

下面这条命令只需追加一次，重复执行会产生重复配置：

echo 'export PATH="$HOME/.local/node/bin:$HOME/.npm-global/bin:$PATH"' >> "$HOME/.bashrc"

10. 让配置立即生效

source "$HOME/.bashrc"

11. 安装 Codex

npm install -g @openai/codex

这里的 -g 表示安装到 npm 配置的全局目录。由于前面已修改 prefix，安装目标是当前用户的 $HOME/.npm-global，不需要 sudo。

12. 查看 Codex 命令位置

command -v codex

正常情况下，应看到类似：

/home/user_name/.npm-global/bin/codex

实际路径取决于当前用户的 $HOME。

13. 检查 Codex 版本

codex --version

正常输出版本号，说明当前终端能够找到并启动 Codex。

14. 启动 Codex

建议先进入需要操作的项目目录，再执行：

codex

说明与注意事项

• 方案的核心是 用户级安装与用户级隔离：Node.js 安装在 $HOME/.local/node，npm 全局目录在 $HOME/.npm-global，不需要 sudo。
• 它不是系统级共享安装。每个普通用户需要在自己的 $HOME 下独立执行；不同用户之间互不影响。
• 将 npm 的 prefix 指向 $HOME/.npm-global，可以避免 npm install -g 向系统目录写入时出现权限错误，也避免污染系统环境。
• source "$HOME/.bashrc" 只影响当前 Bash 会话；以后新开的终端会通过 .bashrc 自动加载 PATH。如果使用 zsh，应改为写入 ~/.zshrc，再执行 source "$HOME/.zshrc"。
• 如果终端中仍找到旧版本 Node.js，可以重新打开终端，或执行 hash -r 清理命令缓存。
• 下载的压缩包 $HOME/.local/node.tar.gz 在安装完成后可以按需删除。
• 以上步骤均为个人实际使用记录

到此这篇关于在Linux上无sudo安装用户级Node.js、npm与Codex的操作步骤的文章就介绍到这了,更多相关Linux无sudo安装Node.js、npm与Codex内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论