1. 安装环境
本次安装环境如下，大家可以先对照自己的服务器：
| 项目 | 配置 |
|---|---|
| 操作系统 | CentOS Linux release 7.9.2009 (Core) |
| 内核 | Linux 3.10.0-1160.el7.x86_64 |
| glibc | 2.17 |
| curl | 7.29.0 |
| git | 1.8.3.1 |
| OpenSSL | 1.0.2k-fips |
注意：CentOS 7 的系统组件较老，直接运行安装脚本时可能遇到兼容性或下载中断问题。因此采用“本地电脑下载 Linux 二进制包，再上传到服务器手动安装”的方式。
2. 安装前检查
先确认系统架构和基础工具：
cat /etc/centos-release
uname -a
uname -m
getconf LONG_BIT
for c in curl sh tar gzip unzip git openssl; do
printf "%-8s " "$c"
command -v "$c" || true
done
curl --version | head -n 1
git --version
openssl version
ldd --version 2>&1 | head -n 1
如果 uname -m 输出为：
x86_64
就下载 Linux 64 位版本。
3. 下载 Codex CLI Linux 包
打开 Codex 的 GitHub Releases 页面，下载 Linux 64 位包：
https://github.com/openai/codex/releases
优先选择类似下面这种文件：
codex-x86_64-unknown-linux-musl.tar.gz
x86_64对应服务器 CPU 架构。linux对应 Linux 系统。musl通常对旧系统更友好，适合 CentOS 7 这类 glibc 较老的环境。
4. 上传到服务器
假设本地下载的文件名是：
codex-x86_64-unknown-linux-musl.tar.gz
上传到服务器用户目录：
scp codex-x86_64-unknown-linux-musl.tar.gz <server-user>@<server-host>:/home/<server-user>/
请把 <server-user> 和 <server-host> 换成自己的服务器信息。
5. 解压并安装到用户目录
在服务器上执行：
mkdir -p ~/.local/bin ~/tmp/codex-install
tar -xzf ~/codex-x86_64-unknown-linux-musl.tar.gz -C ~/tmp/codex-install
查看压缩包内的文件：
tar -tzf ~/codex-x86_64-unknown-linux-musl.tar.gz | head
本次压缩包里只有一个可执行文件：
codex-x86_64-unknown-linux-musl
复制到 ~/.local/bin/codex：
cp ~/tmp/codex-install/codex-x86_64-unknown-linux-musl ~/.local/bin/codex
chmod +x ~/.local/bin/codex
让当前终端识别 codex 命令：
export PATH="$HOME/.local/bin:$PATH"
验证版本：
which codex
codex --version
正常会看到类似：
~/.local/bin/codex
codex-cli 0.142.5
6. 把 codex 命令加入环境
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
7. 配置中转服务 API
本文不使用 OAuth 授权方式，而是通过中转服务 API 接入，这样可以避免网络问题，也可以接入国产大模型使用。有条件的也可以使用 OAuth 授权方式使用。
先创建配置目录：
mkdir -p ~/.codex
chmod 700 ~/.codex
编辑配置文件：
nano ~/.codex/config.toml
示例配置：
model_provider = "relay"
model = "gpt-5.5"
[model_providers.relay]
name = "relay"
base_url = "https://YOUR_RELAY_DOMAIN/v1"
wire_api = "responses"
requires_openai_auth = true
需要替换的地方：
https://YOUR_RELAY_DOMAIN/v1
换成自己的中转服务地址。
保存后设置权限：
chmod 600 ~/.codex/config.toml
8. 设置 API Key
本文使用 auth.json 保存 API Key。创建文件：
nano ~/.codex/auth.json
写入以下示例内容：
{
"OPENAI_API_KEY": "YOUR_RELAY_API_KEY"
}
需要替换的地方：
YOUR_RELAY_API_KEY
换成自己的中转服务 API Key。
保存后设置权限：
chmod 600 ~/.codex/auth.json
9. 测试 Codex
确认配置文件存在：
ls -lh ~/.codex/config.toml ~/.codex/auth.json
运行一个最简单的测试：
codex "用一句话回复：你能正常运行吗？"
如果能得到模型回复，说明 Codex CLI 已经安装并接入成功。
10. 常见问题
10.1 codex: command not found
说明 ~/.local/bin 没在 PATH 里：
export PATH="$HOME/.local/bin:$PATH"
codex --version
永久生效：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
10.2 解压后找不到 codex
先查看压缩包内容：
tar -tzf ~/codex-x86_64-unknown-linux-musl.tar.gz | head -n 100
如果看到的是：
codex-x86_64-unknown-linux-musl
就复制并改名：
cp ~/tmp/codex-install/codex-x86_64-unknown-linux-musl ~/.local/bin/codex
chmod +x ~/.local/bin/codex