在 AutoDL 国内服务器中安装 Codex CLI，常见问题并不是单独出现的，而是以下几项连续叠加：

• 容器默认没有 Node.js/npm，或 Node.js 版本过低；

• OpenAI 官方安装脚本所在域名在服务器内无法访问；

• network_turbo 代理导致 npm 出现证书校验错误；

• 安装成功后，新开终端又提示 codex: command not found。

本文记录一套实际验证成功的安装流程。

最终验证结果：

node -v
# v24.17.0

codex --version
# codex-cli 0.142.0

版本号会随安装时间变化，只要能正常输出即可。

一、常见踩坑

1. npm: command not found

初始容器可能没有安装 Node.js/npm，因此无法直接执行：

npm install -g @openai/codex

需要先准备 Node.js 环境。

2. 官方安装脚本无法访问

尝试执行：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

可能报错：

curl: (28) Failed to connect to chatgpt.com port 443: Connection timed out

AutoDL 的 network_turbo 对 GitHub、Hugging Face、npm 镜像等资源通常更友好，但并不保证能访问 chatgpt.com。因此这里改走 npm 安装路线。

3. Node.js 版本过低

即使系统自带 npm，若 Node.js 仍是旧版本，例如 Node 12，安装或运行过程中可能出现：

SyntaxError: Unexpected reserved word

本次环境中，升级到较新的 Node LTS 后问题解决。

4. npm 代理证书报错

启用 network_turbo 后，npm 可能报：

npm error code SELF_SIGNED_CERT_IN_CHAIN

这是代理 HTTPS 证书链未被当前 Node/npm 信任导致的。本文仅在安装 Codex 的那一次 npm 命令中临时关闭严格证书校验，不修改全局 npm 配置。

---

二、安装新版 Node.js

前提：当前环境已经可以执行 npm，例如 npm ping 能正常返回。

# 开启 AutoDL 网络加速
source /etc/network_turbo

# 安装 Node.js 版本管理工具 n
npm install -g n

# 将新版 Node 安装到当前用户目录，避免覆盖系统 Node
export N_PREFIX="$HOME/.local"
export PATH="$N_PREFIX/bin:$PATH"

# 使用国内镜像下载 Node.js
export N_NODE_MIRROR="https://npmmirror.com/mirrors/node"

# 安装当前 LTS 版本
n install lts

# 刷新 Shell 命令缓存
hash -r

# 验证 Node 和 npm
node -v
npm -v
which node
which npm

正常情况下，node 和 npm 应位于：

/root/.local/bin/

例如：

/root/.local/bin/node
/root/.local/bin/npm

---

三、安装 Codex CLI

确认 Node.js 已升级后，执行：

# 仅对本次安装临时关闭严格 SSL 校验
NPM_CONFIG_STRICT_SSL=false npm install -g @openai/codex

# 刷新命令缓存
hash -r

# 验证安装结果
which codex
codex --version

正常情况下：

which codex
# /root/.local/bin/codex

codex --version
# codex-cli 0.142.0

其中版本号可能不同，但能正常输出即表示安装成功。

---

四、永久配置 PATH：避免新开终端后找不到 Codex

这是最容易遗漏的一步。

如果当前终端能运行：

codex --version

但重新打开终端后出现：

bash: codex: command not found

说明 /root/.local/bin 没有被永久加入环境变量。

执行以下命令：

# 写入 ~/.bashrc：供普通新终端加载
grep -qxF 'export N_PREFIX="$HOME/.local"' ~/.bashrc || \
echo 'export N_PREFIX="$HOME/.local"' >> ~/.bashrc

grep -qxF 'export PATH="$N_PREFIX/bin:$PATH"' ~/.bashrc || \
echo 'export PATH="$N_PREFIX/bin:$PATH"' >> ~/.bashrc

# 写入 ~/.bash_profile：保证登录 shell 也会加载 ~/.bashrc
grep -qxF '[ -f ~/.bashrc ] && . ~/.bashrc' ~/.bash_profile 2>/dev/null || \
echo '[ -f ~/.bashrc ] && . ~/.bashrc' >> ~/.bash_profile

# 让当前终端立即生效
export N_PREFIX="$HOME/.local"
export PATH="$N_PREFIX/bin:$PATH"
hash -r

# 再次验证
which node
which npm
which codex

node -v
npm -v
codex --version

随后完全新开一个终端，再执行：

which codex
codex --version

若仍能看到：

/root/.local/bin/codex
codex-cli 0.142.0

则说明 PATH 已经永久配置完成。

---

五、注意事项

不要使用下面的方式永久关闭 npm 证书校验：

npm config set strict-ssl false

更稳妥的做法是仅在确实遇到代理证书报错时，对单次安装命令使用：

NPM_CONFIG_STRICT_SSL=false npm install -g @openai/codex

后续正常使用 codex 不需要继续关闭 SSL 校验。

---

总结

AutoDL 国内服务器可以成功安装 Codex CLI，核心流程是：

开启 network_turbo
→ 使用 n 升级 Node.js
→ 通过 npm 安装 Codex
→ 单次临时绕过代理证书校验
→ 将 /root/.local/bin 永久加入 PATH

最关键的命令是：

n install lts

NPM_CONFIG_STRICT_SSL=false npm install -g @openai/codex

以及避免新终端失效的 PATH 配置：

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

完成后即可在任意新终端中直接运行：

codex