CentOS 7 中国服务器 Codex 中转 API 完整教程适用场景国内云服务器无法直连 OpenAI系统为 CentOS 7希望稳定使用 Codex CLI这篇文章把安装、配置、避坑和最终可用方案一次讲清楚适合直接照着操作。一、先说核心问题很多人在 CentOS 7 上安装 Codex第一步就会卡住。原因并不是你命令写错了而是系统环境本身比较老。CentOS 7 的默认环境通常有这几个限制glibc版本较低通常是2.17官方常见的 Node.js 18/20 二进制包不一定能直接运行国内服务器通常无法稳定直连 OpenAI API所以在 CentOS 7 上想跑通 Codex核心思路只有一句话使用兼容glibc 2.17的 Node.js通过中转 API 访问模型明确指定 Codex 使用的模型二、安装兼容 CentOS 7 的 Node.js1. 下载兼容版 Node.js进入opt目录下载适合glibc 2.17的构建版本cd/optwgethttps://unofficial-builds.nodejs.org/download/release/v18.20.8/node-v18.20.8-linux-x64-glibc-217.tar.gztar-zxvfnode-v18.20.8-linux-x64-glibc-217.tar.gzmvnode-v18.20.8-linux-x64-glibc-217 node18这里使用的是Node.js v18.20.8linux-x64-glibc-217版本这个版本的意义就是兼容 CentOS 7 的老环境。2. 配置环境变量执行下面命令echoexport NODE_HOME/opt/node18~/.bashrcechoexport PATH$NODE_HOME/bin:$PATH~/.bashrcsource~/.bashrc3. 验证 Node.js 是否安装成功node-vnpm-v如果能看到版本号说明 Node 环境已经正常。三、安装 Codex CLI国内服务器安装 npm 包时建议先切换到国内镜像源npmconfigsetregistry https://registry.npmmirror.comnpminstall-gopenai/codex安装完成后验证codex--version只要能正确输出版本号说明 Codex CLI 已经安装成功。四、配置中转 API因为很多国内服务器无法直接访问 OpenAI所以这里必须走中转。1. 设置环境变量先在当前会话中设置exportOPENAI_BASE_URLhttps://你的中转域名/v1exportOPENAI_API_KEY你的API_KEY如果你希望每次登录服务器自动生效写入~/.bashrcechoexport OPENAI_BASE_URLhttps://你的中转域名/v1~/.bashrcechoexport OPENAI_API_KEY你的API_KEY~/.bashrcsource~/.bashrc2. 验证中转 API 是否可用执行curlhttps://你的中转域名/v1/models\-HAuthorization: Bearer 你的API_KEY如果返回模型列表说明这条中转链路是通的后面 Codex 才有成功的基础。五、配置 Codex这一步很关键。建议直接创建 Codex 配置文件。mkdir-p~/.codexcat~/.codex/config.tomlEOF model gpt-5.4 openai_base_url https://你的中转域名/v1 approval_policy on-request sandbox_mode workspace-write EOF这里有几个重点参数model gpt-5.4尽量明确指定模型减少兼容问题openai_base_url指向你的中转地址approval_policy on-request需要时再授权sandbox_mode workspace-write允许在当前工作区写文件六、开始使用 Codex方式一直接执行一句命令这个方式最适合测试环境是否打通codexexec--skip-git-repo-check只回复 hello注意参数顺序必须这样写codexexec--skip-git-repo-check只回复 hello不要写成codex --skip-git-repo-checkexec后者通常是错误写法。方式二进入项目模式如果你要在项目目录中使用mkdirtestcdtestgitinit codexexec帮我分析这个项目这种方式更适合日常开发、读代码、改脚本、生成文件。七、常见问题与解决办法1. 报错GLIBC_2.28 not found原因CentOS 7 太老系统默认库版本不够高。解决方法必须使用glibc-217兼容版 Node.js不要直接用普通官方构建。2. GitHub 下载超时原因国内服务器访问海外资源不稳定。解决方法优先使用镜像源手动下载后上传到服务器必要时通过代理机器转存3. Codex 卡住或长时间无响应优先检查中转 API 是否正常curlhttps://你的中转域名/v1/models\-HAuthorization: Bearer 你的API_KEY如果这一步不通Codex 基本不可能正常工作。4. 报错model xxx is not supported via Responses API原因你配置的模型名称和当前中转接口或 Codex 所使用的接口能力不匹配。解决方法优先改成model gpt-5.45. 报错wss://.../responses 404原因部分中转服务并不支持 WebSocket 路径。结论如果 Codex 仍然能正常返回结果这类报错很多时候可以先忽略。6. 参数顺序错误错误示例codex --skip-git-repo-checkexec正确示例codexexec--skip-git-repo-check只回复 hello八、推荐的稳定配置环境变量建议如下exportOPENAI_BASE_URLhttps://你的中转域名/v1exportOPENAI_API_KEY你的API_KEYexportNODE_TLS_REJECT_UNAUTHORIZED0Codex 配置建议如下model gpt-5.4 openai_base_url https://你的中转域名/v1 approval_policy on-request sandbox_mode workspace-write如果你使用的是证书不完整、链路兼容性一般的中转服务NODE_TLS_REJECT_UNAUTHORIZED0有时确实能解决问题。但要注意这个配置会降低 TLS 校验强度只建议在你明确了解风险、且只是为了解决兼容性问题时使用。九、一句话总结在 CentOS 7 上跑 Codex本质就是三件事兼容版 Node.js可用的中转 API明确指定模型比如gpt-5.4只要这三件事同时满足Codex 基本就能稳定跑起来。十、安全提醒这一段非常建议你写进博客正文里。请务必注意不要公开你的 API Key不要把 Key 直接截图发出来如果怀疑泄露立即删除并重建另外中转服务本身也存在服务质量和安全差异选择时一定要谨慎。十一、进阶建议如果你的服务器环境允许还是建议逐步升级系统比如Rocky Linux 8AlmaLinux 9升级后的好处很直接对新版本 Node.js 支持更好对现代开发工具兼容性更高能少踩很多 CentOS 7 的历史坑如果你是长期使用 Codex、Node.js、Python、Docker 这类工具升级系统通常比长期修补旧环境更省时间。十二、实战命令汇总为了方便直接复制这里整理一份最小可用流程。1. 安装 Node.jscd/optwgethttps://unofficial-builds.nodejs.org/download/release/v18.20.8/node-v18.20.8-linux-x64-glibc-217.tar.gztar-zxvfnode-v18.20.8-linux-x64-glibc-217.tar.gzmvnode-v18.20.8-linux-x64-glibc-217 node18echoexport NODE_HOME/opt/node18~/.bashrcechoexport PATH$NODE_HOME/bin:$PATH~/.bashrcsource~/.bashrcnode-vnpm-v2. 安装 Codexnpmconfigsetregistry https://registry.npmmirror.comnpminstall-gopenai/codex codex--version3. 设置中转exportOPENAI_BASE_URLhttps://你的中转域名/v1exportOPENAI_API_KEY你的API_KEY4. 验证中转curlhttps://你的中转域名/v1/models\-HAuthorization: Bearer 你的API_KEY5. 写入 Codex 配置mkdir-p~/.codexcat~/.codex/config.tomlEOF model gpt-5.4 openai_base_url https://你的中转域名/v1 approval_policy on-request sandbox_mode workspace-write EOF6. 运行测试命令codexexec--skip-git-repo-check只回复 hello结尾如果你之前在 CentOS 7 上一直装不好 Codex基本不是你不会而是系统老、网络环境特殊、兼容性要求更高。按这篇教程的思路处理后成功率会高很多。