Codex CLI 安装（Linux）

安装 Node.js 环境

使用 nvm安装：

## 1. 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
## 2. 重新加载 shell 配置
source ~/.bashrc
# 3. 安装最新 LTS 版本
nvm install --lts

如果 GitHub 443端口连接超时，可直接下载离线压缩包解压安装：

# 1. 下载nvm离线包（国内Gitee）
wget https://gitee.com/mirrors/nvm/repository/archive/v0.39.0.tar.gz -O nvm.tar.gz
# 2. 解压到指定目录
mkdir -p ~/.nvm && tar -zxvf nvm.tar.gz -C ~/.nvm --strip-components=1
# 3. 自动配置环境变量+Node镜像
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"' >> ~/.bashrc
echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.bashrc
# 4. 验证
source ~/.bashrc && nvm --version
# 5. 安装稳定版 Node
nvm install --lts

验证安装：显示版本号，说明安装成功

node --version
npm --version

安装 Codex CLI

npm 全局安装（全平台通用）：

npm install -g @openai/codex

如果等待一段时间后报错超时，原因是 npm 无法连接到官方的 npm 仓库服务器：

npm error code ETIMEDOUT
npm error errno ETIMEDOUT
npm error network request to https://registry.npmjs.org/@openai%2fcodex failed, reason: 
npm error network This is a problem related to network connectivity.
npm error network In most cases you are behind a proxy or have bad network settings.
npm error network
npm error network If you are behind a proxy, please make sure that the
npm error network 'proxy' config is set properly.  See: 'npm help config'
npm error A complete log of this run can be found in: /home/jy/.npm/_logs/2026-03-20T05_29_42_219Z-debug-0.log

可以通过切换到国内 npm 镜像源解决：

npm install @openai/codex --registry=https://registry.npmmirror.com

验证安装，成功则会显示版本号：

codex --version

Codex 登录授权

终端输入 codex：

codex

一路同意即可，登录选项选择第3个使用API Key登录，最后输入API Key即可进入Codex对话界面，然后退出Codex，修改配置文件连接中转站。

Codex 配置修改

配置 Codex 以连接到中转服务。
首先进入 .codex 目录，修改如下两个文件内容：

# config.toml参考配置
model_provider = "xxx"
model = "gpt-5.4"
model_context_window = 1000000
model_auto_compact_token_limit = 900000 #可以设置为400000等值，自动压缩token过长有时会导致注意力不佳
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"
approvals_reviewer = "user"
[model_providers.crs]
name = "OpenAI"
base_url = "http://IP:port/openai"
wire_api = "responses"
requires_openai_auth = true

如果刚刚第一次登录Codex已经配置了Key，则auth.json配置无需修改，默认如下：

# auth.json参考配置
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "cr_xxxxxx"
}