前言

最近在服务器上部署 OpenAI 的 Codex CLI（终端版 Codex 工具），按照官方文档使用 npm install -g @openai/codex 的方式安装，反复测试多次，成功率极低，经常卡在拉取二进制包阶段，大概率是网络、npm 源的问题，不知道官方后续会不会优化这个 npm 安装方式。

既然 npm 方案不好用，那我们换更稳定的方案：直接从 Github Release 下载预编译二进制包部署，不需要 Node 环境，部署简单、稳定性高，下面是完整实操流程。

?? 重要提醒：第三方 API 中转服务存在合规风险，同时存在 API Key 泄露、服务商跑路、扣费异常等风险，本文仅作技术学习交流，不推荐、不鼓励使用中转服务，请遵守国内相关法律法规。

环境说明

• 服务器系统：Linux（CentOS / Ubuntu / Debian 均可，x86_64 架构），其他Windows、mac按同步骤也适配
• 部署方式：Github Release 预编译二进制包
• 可选功能：自定义 API 中转配置

一、下载 Codex 二进制包

两种下载方式任选其一：

方式 1：curl 直接服务器下载（推荐，不用 FTP）

方式 2：本地下载后 FTP 上传服务器

本地浏览器打开上面的 release 链接，下载 codex-x86_64-unknown-linux-musl.tar.gz，通过 FTP 工具上传到服务器任意目录。

二、解压 + 测试运行

上传 / 下载完成后，执行解压命令：

执行上面命令，就能直接启动 codex。

但是现在有个缺点：只能在当前这个文件夹下执行 codex，切换其他目录就无法直接调用命令，接下来配置全局命令。

三、配置全局命令（任意目录都能直接使用 codex）

? 重点避坑：很多新手会犯的错误！不要把 tar 压缩包移动到 bin 目录，要移动解压出来的二进制程序！

输出版本号，代表全局配置成功！之后在服务器任意目录，直接输入 codex 即可启动。

不过但是我们现在仍有一个问题，那就是如何登录chatgpt账号或者如何选择登录方式，对于国内的大多数人来说，科学上网直接用账号登是困难的:

那么我们可以选择使用中转站来配置api

四、配置文件：对接中转 API（apikey 模式）

Codex CLI 默认读取配置路径：~/.codex/config.toml 和 ~/.codex/auth.json 建议统一放在家目录下的 .codex 文件夹，不要放在解压目录，避免切换用户找不到配置。

1. 创建配置目录

2. 编写 config.toml

3. 编写 auth.json，填入你的 APIKEY

两个文件都保存完成后，直接输入命令启动：

五、常见踩坑汇总

1. npm 安装失败原因 npm install -g @openai/codex 本质是 npm 脚本去 github 拉取二进制包，国内服务器网络不稳定、npm 源拦截，非常容易超时失败，二进制直下方案不需要 node 环境，规避这个问题。
2. 架构区分

• x86_64 普通云服务器：codex-x86_64-unknown-linux-musl.tar.gz（本文方案）
• ARM 架构服务器（甲骨文 arm、树莓派等）：下载 codex-aarch64-unknown-linux-musl.tar.gz

1. 权限问题 /usr/local/bin 属于系统目录，移动文件需要 sudo 权限；
2. 配置不生效 检查配置文件路径是否为 ~/.codex/，大小写、toml 语法不要写错，toml 格式错了会直接加载失败。

六、写在最后

官方 npm 安装方式对国内服务器非常不友好，二进制包直接部署是目前最稳的方案。 如果你不需要中转，想要对接 OpenAI 官方原生 API，我也可以提供官方版本的 config.toml 配置。