Codex 本地安装指南
以Ubuntu 24.04 LTS实例

修改为阿里云源
备份源
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
编辑:
sudo vim /etc/apt/sources.list
替换:
deb https://mirrors.aliyun.com/ubuntu/ noble main restricted universe multiverse
deb https://mirrors.aliyun.com/ubuntu/ noble-updates main restricted universe multiverse
deb https://mirrors.aliyun.com/ubuntu/ noble-backports main restricted universe multiverse
deb https://mirrors.aliyun.com/ubuntu/ noble-security main restricted universe multiverse
保存:
:wq

更新:
sudo apt update
sudo apt upgrade -y
安装基础工具
sudo apt install -y \ curl \ wget \ git \ vim \ build-essential \ ca-certificates \ jq \ tmux \ tree
检查:
git --version

国内安装 Node.js
Codex CLI 依赖 Node.js。
1. 安装 nvm(国内优化)
执行:
curl -fsSL -o- https://gitee.com/mirrors/nvm/raw/v0.40.1/install.sh | bash

加载:
source ~/.bashrc
检查:
nvm -v

设置国内 Node 镜像
- 写入镜像配置
echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.bashrc
- 生效
source ~/.bashrc
- 加载 nvm(如果还没加载)
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
- 安装 Node.js(会走国内镜像)
nvm install 22
- 验证
node -v
npm -v

配置 npm 国内源
查看:
npm config get registry
修改:
npm config set registry https://registry.npmmirror.com
验证:
npm config get registry
结果:
https://registry.npmmirror.com

安装 Codex CLI
npm安装:
官方支持:
npm install -g @openai/codex
安装完成:
codex --version

启动:
codex

Codex 官方文档: