● 安装指南

Linux 安装 Codex 指南

在 Linux 上安装 OpenAI Codex CLI 的完整步骤教程

🐧
适用环境
  • 主流发行版:Ubuntu / Debian / CentOS / Fedora / Arch / openSUSE 等
  • x86_64 / ARM64 架构
  • Shell: bash 或 zsh,需要 curl、git 等基础工具

一、安装前置依赖

1

安装 Node.js(建议通过 nvm)

Codex CLI 通过 npm 分发,需要 Node.js 18 或以上。推荐用 nvm 管理 Node 版本,跨发行版通用、不需要 sudo。

方式 A:nvm(推荐)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 让 nvm 立即生效(或重开终端)
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

nvm install --lts
nvm use --lts

方式 B:发行版包管理器

# Ubuntu / Debian
sudo apt update && sudo apt install -y nodejs npm

# CentOS / RHEL / Fedora
sudo dnf install -y nodejs npm

# Arch / Manjaro
sudo pacman -S --noconfirm nodejs npm
⚠️ 部分发行版自带的 nodejs 版本偏老(< 18),如果验证步骤失败请改用 nvm 或 NodeSource。
✅ 验证: 执行下面两条命令,都能输出版本号即成功 
node -v
npm -v

二、安装 Codex CLI

2

通过 npm 全局安装官方包

npm install -g @openai/codex

如果用的是发行版自带的 Node,可能需要 sudo:

sudo npm install -g @openai/codex

验证安装是否成功:

codex --version
which codex
💡 常见安装位置
  • nvm 安装: ~/.nvm/versions/node/<version>/bin/codex
  • 系统级: /usr/bin/codex 或 /usr/local/bin/codex
  • 用户级 prefix: $(npm config get prefix)/bin/codex
3

命令找不到时的修复

如果执行 codex --version 提示 command not found,把 npm 的 bin 目录加入 PATH(下面用 bash 举例,zsh 用户把 ~/.bashrc 换成 ~/.zshrc):

echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

然后重新执行 codex --version 验证。

💡 不想用 sudo 全局装包:把 npm prefix 改到用户目录,从根本上避免权限问题。 
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

三、验证可用

4

生成你的专属启动脚本

在下面输入你的下游 Key(以 lbk_ 开头),点击 下载启动脚本,会生成一份内置你 Key 的 new_codex.sh。

💡 Key 只在你浏览器本地拼接进脚本,不会上传到任何服务器。
5

运行启动脚本

下载得到 new_codex.sh 后,打开终端进入下载目录(一般是 ~/Downloads):

cd ~/Downloads
💡 也可以先把 new_codex.sh 拷贝到自己的项目目录,后续直接在项目里 ./new_codex.sh 启动。

给脚本加可执行权限:

chmod +x new_codex.sh

启动 Codex:

./new_codex.sh
💡 如果脚本是从浏览器下载的,某些发行版会标记为「不受信任」,执行 chmod +x 后即可正常运行。

进入 TUI 后,输入一句话测试:

你好,你是谁?
✅ 模型正常返回回答即代表接入成功

四、常见问题

1. codex: command not found
  • 确认 npm install -g @openai/codex 没报错(权限问题加 sudo,或参考步骤 3 改 npm prefix)。
  • 检查 npm config get prefix 输出的目录下 bin/codex 是否存在。
  • 把该 bin 目录加到 PATH,source ~/.bashrc 或重开终端。
2. EACCES: permission denied / 安装时报权限错误
  • 用发行版自带的 Node 时,全局 npm 目录(/usr/lib/node_modules)需要 root,加 sudo。
  • 推荐根治方案:用 nvm,或把 npm prefix 改到 ~/.npm-global(见步骤 3 的 tip)。
3. 远程网关不可达
  • 检查能否访问 https://aitoolproxygateway.liuwanqin.com/health。
  • 如果用 Clash / V2Ray 等代理,需要把这个域名加入直连规则,或临时关闭代理。
  • 服务器/公司网络可能拦截 80 端口,换网络再试。
  • 检查 http_proxy / https_proxy 环境变量是否影响请求。
4. 当前不是交互式终端,Codex TUI 无法启动
  • 不要用 ./new_codex.sh < /dev/null 或通过 SSH 非交互方式启动。
  • 直接在 GNOME Terminal / Konsole / Alacritty / SSH 交互会话里运行即可。
  • tmux / screen 里运行也支持,但需要确保 TERM 变量正确(如 screen-256color)。
5. auth.json 一直被改回旧值
  • 启动脚本每次运行都会覆盖 ~/.codex/auth.json。
  • 如果同时用官方 Codex 登录态,建议另起一份 profile,或者只在需要时跑脚本。
6. 模型 gpt-5.4 不识别
  • 这个模型名由上游代理站定义,不是官方 OpenAI 公开模型。
  • 如需切换模型,改 new_codex.sh 里 -c 'model="..."' 那行。
7. 想退出 / 切回官方 Codex
  • 删除 ~/.codex/auth.json,然后 codex login 重新走官方登录。
  • 或者直接编辑 ~/.codex/auth.json 把 OPENAI_API_KEY 换回官方 sk-xxx。

五、卸载

6

卸载 Codex CLI

npm uninstall -g @openai/codex
rm -rf ~/.codex

如果不再使用 Node.js,根据安装方式选择卸载方法:

# nvm 安装的
nvm uninstall --lts

# Ubuntu / Debian
sudo apt remove --purge nodejs npm

# CentOS / RHEL / Fedora
sudo dnf remove nodejs npm

# Arch / Manjaro
sudo pacman -Rs nodejs npm

六、联系我们

有问题?联系管理员

扫码加我微信,有任何使用上的疑问都可以问。

管理员微信二维码

扫一扫上面的二维码图案,加我为朋友