UnboxVPS · 搬瓦工指南

把 Codex 部署到 VPS 上 24 小时跑:从安装到 headless 挂机完整教程

2026-09-02 部署实战

先说清楚一件事,免得有人白折腾:Codex 的计算都在 OpenAI 云端,你的服务器只是跑一个客户端。所以它不吃配置、不吃流量,一台入门 VPS 就能挂;但相应的,它也不替你省订阅钱,账单还是走你的 ChatGPT 订阅或 API。搞清楚这点再往下看,这篇教程把从装机到 24 小时挂机的每一步都写全了。

先看结论,对号入座

你的情况 建议
只是偶尔本地写代码用 不用看这篇,本地装就行
想让它整夜跑长任务、改完自己提 PR 适合,VPS + tmux 挂机
想在服务器上同时跑本地大模型 看这篇的 Ollama 延伸链接,两台机器或大内存更合适
预算极只想尝鲜 入门款 49.99 美元/年的档位够用

一、为什么有人把 Codex 扔服务器上

我自己的用法很朴素:白天把一个重构任务用非交互模式丢给它,让它在一个独立仓库里慢慢改、跑测试、提交;我本地电脑照常用,晚上回来 review 它的提交。相比跑在自己电脑上,服务器上挂着有三个实际好处:

一是不占本地机器。长任务跑起来风扇起飞、IDE 卡顿的问题没了。二是环境稳定。服务器的 Node 版本、依赖不会因为你本机今天升级个什么就变。三是随时能看。手机开个 SSH 客户端就能看进度,不依赖家里电脑开机。

当然也说缺点:你得会一点 SSH 基础(不会的看站内那篇SSH 报错速查表,连接问题基本都覆盖了),另外代码要同步上去,多了一道 git 流程。

二、选什么配置:比你想象的省

Codex CLI 本体就是个 Node 程序,内存占用一两百 MB 级别。真实要求是:

我用的是搬瓦工,就把我在看的档位摆出来(2026 年 8 月数据,以官网实时价格为准):

档位 配置 年付价格 适合谁
入门款(SPECIAL 类) 2 核 1G / 20G SSD / 1TB 流量 49.99 美元 只跑 Codex + 轻量任务,够用
CN2 GIA-E 20G 2 核 1G / 20G SSD / 1TB 流量 169.99 美元 在意国内直连手感,操作多

纯挂机、人很少连上去看的话,入门款就行;你要是经常 SSH 上去盯着它干活,GIA 线路的钱花得不冤。本站就是做搬瓦工导购的,注册选购可以看这篇搬瓦工购买教程,支付宝付款,从注册到开机都有图。

三、装环境:Node 和 Codex

SSH 登录服务器,先装 Node。推荐用 nvm 装,别用系统包管理器——权限干净,以后升级也省心:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install 22
node -v

然后装 Codex CLI:

npm install -g @openai/codex
codex --version

能打印版本号就装好了。

四、认证:两种路子,服务器上推荐 API Key

Codex 支持两种认证:

  1. ChatGPT 账号登录:首次运行 codex 会引导你登录,额度走你的订阅(Plus/Pro)。适合个人用,但交互式登录流程在无图形界面的服务器上偶尔会卡,需要照着终端提示把链接复制到本地浏览器完成。
  2. API Key:设置环境变量即可,headless 场景更稳:
echo 'export OPENAI_API_KEY=你的key' >> ~/.bashrc
source ~/.bashrc

注意:API Key 走 API 账单,和订阅是两套计费,用哪个取决于你哪边有额度。另外 千万别把 key 写进代码仓库,放环境变量里。

顺带一提:Codex 这类客户端也支持把模型端点指向 OpenAI 兼容的第三方聚合渠道。如果你想先比比各家的模型调用价格再决定 key 从哪来,可以看看灵客 AI(baigonghe.com)——我们自己维护的另一个项目,收录上百个模型的实时价格表,同一个模型不同线路的价差能拉出好几倍,先比价再充值不吃亏。

五、跑起来:交互、非交互、挂机

交互模式,进到你的项目目录直接:

cd ~/your_project
codex

跟它对话式干活,和本地一样。

非交互模式(headless 的核心),一句话丢一个任务,跑完就退出,适合脚本化和挂机:

codex exec "把所有测试跑一遍,修复失败的用例,然后提交"

让它 24 小时挂着的正确姿势:用 tmux,别用 nohup 凑合。

tmux new -s codex
# 在 tmux 里跑你的任务,然后按 Ctrl+B 再按 D 脱离
# 回来看进度:
tmux attach -t codex

这样你 SSH 断了、电脑关了,任务照跑。

六、安全这几件事别省

Codex 是能动你文件、执行命令的东西,跑在公网上更要注意:

七、常见坑,我先替你踩了

现象 原因 解法
npm 全局安装报权限错 用了系统 Node + sudo 用 nvm 装 Node,不用 sudo
装完找不到 codex 命令 nvm 环境没生效 重新 source ~/.bashrc 或新开终端
跑大项目内存不够 1G 内存 + 构建吃内存 加 swap,或升 2G 档
tmux 里的任务看不到输出 脱离时没留意会话名 tmux ls 看所有会话

常见问题

问:跑 Codex 需要多好的服务器? 不需要。计算在云端,服务器只跑客户端,入门款 1G 内存就能挂,跑构建测试多的话选 2G。

问:Codex CLI 收费吗? CLI 本身开源免费。花钱的是背后的模型调用——要么走 ChatGPT 订阅,要么走 API 计费,服务器不产生额外费用。

问:服务器在国内还是国外有讲究吗? Codex 需要连接 OpenAI 的服务,海外服务器直连即可,省去中转配置的麻烦。这也是很多人选美西机房的实际原因之一。

问:同一台机器还能跑别的吗? 可以。想跑本地模型的看这篇搬瓦工部署 DeepSeek/Ollama 实战,不过本地模型吃内存,和 Codex 这种轻客户端不是一回事;跑容器化服务的话,Docker 部署教程也写过。

问:让 Codex 自动改代码、自动提交,放心吗? 看你怎么配权限。独立分支 + 沙箱模式 + 你最后人工 review 提交,是目前比较稳的组合。别在存着生产密钥的仓库里开全自动。

问:流量会用超吗? 基本不会。交互全是文本,1TB 月流量对单人来说几乎用不完。

延伸阅读

本站为搬瓦工导购站,文中含联盟链接,通过链接购买本站获得佣金,不影响你的价格。以上价格为 2026 年 8 月采集,实际以官网实时为准。