跳到主要内容

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 镜像

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