先说清楚一件事,免得有人白折腾:Codex 的计算都在 OpenAI 云端,你的服务器只是跑一个客户端。所以它不吃配置、不吃流量,一台入门 VPS 就能挂;但相应的,它也不替你省订阅钱,账单还是走你的 ChatGPT 订阅或 API。搞清楚这点再往下看,这篇教程把从装机到 24 小时挂机的每一步都写全了。
先看结论,对号入座
| 你的情况 | 建议 |
|---|---|
| 只是偶尔本地写代码用 | 不用看这篇,本地装就行 |
| 想让它整夜跑长任务、改完自己提 PR | 适合,VPS + tmux 挂机 |
| 想在服务器上同时跑本地大模型 | 看这篇的 Ollama 延伸链接,两台机器或大内存更合适 |
| 预算极只想尝鲜 | 入门款 49.99 美元/年的档位够用 |
一、为什么有人把 Codex 扔服务器上
我自己的用法很朴素:白天把一个重构任务用非交互模式丢给它,让它在一个独立仓库里慢慢改、跑测试、提交;我本地电脑照常用,晚上回来 review 它的提交。相比跑在自己电脑上,服务器上挂着有三个实际好处:
一是不占本地机器。长任务跑起来风扇起飞、IDE 卡顿的问题没了。二是环境稳定。服务器的 Node 版本、依赖不会因为你本机今天升级个什么就变。三是随时能看。手机开个 SSH 客户端就能看进度,不依赖家里电脑开机。
当然也说缺点:你得会一点 SSH 基础(不会的看站内那篇SSH 报错速查表,连接问题基本都覆盖了),另外代码要同步上去,多了一道 git 流程。
二、选什么配置:比你想象的省
Codex CLI 本体就是个 Node 程序,内存占用一两百 MB 级别。真实要求是:
- CPU/内存:1 核 1G 能跑,但如果你还想顺带跑构建、跑测试,2G 起步舒服
- 硬盘:20G SSD 足够,代码仓库都不大
- 流量:纯文本交互,一个月跑满也用不了几个 G
- 线路:如果你人从国内连服务器操作,CN2 GIA 这类直连线路敲命令不卡手,体验差别很明显
我用的是搬瓦工,就把我在看的档位摆出来(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 支持两种认证:
- ChatGPT 账号登录:首次运行
codex会引导你登录,额度走你的订阅(Plus/Pro)。适合个人用,但交互式登录流程在无图形界面的服务器上偶尔会卡,需要照着终端提示把链接复制到本地浏览器完成。 - 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 是能动你文件、执行命令的东西,跑在公网上更要注意:
- 沙箱模式分三档:read-only、workspace-write、danger-full-access。日常用默认的写工作区就够,
danger-full-access顾名思义,服务器上别随便开。 - 审批策略可以配成需要你确认才执行敏感命令,非交互任务则按任务可信度设置,别图省事全放开。
- 仓库里别放生产密钥,给它的代码库越”干净”越安全。
- 大改动前打个快照。搬瓦工后台自带免费快照,一分钟的事,翻车能整机回滚,教程在这:快照备份与跨机房迁移。
七、常见坑,我先替你踩了
| 现象 | 原因 | 解法 |
|---|---|---|
| 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 月流量对单人来说几乎用不完。
延伸阅读
- 自托管 AI Agent 的模型 API 怎么选:渠道类型、成本账与比价方法
- 2026 年跑 OpenClaw 选什么 VPS:方案对比与安全加固清单
- 搬瓦工选型与优惠码使用指南
- SSH 常见报错速查表
本站为搬瓦工导购站,文中含联盟链接,通过链接购买本站获得佣金,不影响你的价格。以上价格为 2026 年 8 月采集,实际以官网实时为准。