OpenAI Codex 简介
Codex CLI 是 OpenAI 推出的编程智能体,直接在终端中运行。它会读取你启动它时所在的代码仓库,提出修改建议,执行命令和测试,并按你选定的审批模式在关键操作前征求确认。项目开源,代码托管在 GitHub 上。
把它装在 VPS 而不是本地电脑上,好处很实际:智能体运行在一台始终在线、网络稳定的机器上,你可以从任何一台电脑通过 SSH 操控它。重构、迁移、修复测试这类耗时较长的任务,不会再占住你的笔记本。
服务器交付时,系统中已有一个名为 codex 的用户,使用 bash,拥有免密码的 sudo 权限,同时安装了 git、curl 和 ca-certificates。Codex CLI 通过官方安装脚本为该用户安装,不依赖 Node.js。root 已授权的 SSH 公钥会复制给 codex,因此你可以直接用这个用户登录。登录认证不会代你完成:它是交互式的,需要你连接服务器后自行发起。
用 OpenAI Codex 可以做什么
终端里的代码智能体
Codex 会读取你的代码仓库,提出文件修改建议,并在当前目录中执行命令。涉及敏感操作时会先请求确认,控制权始终在你手上。
官方安装脚本,无需 Node.js
OpenAI 在 GitHub releases 上发布的安装脚本会为 codex 用户执行。你不需要安装或维护 Node.js 运行时。
专用用户与 SSH 直连
系统会创建 codex 账户并锁定其密码。root 的 SSH 公钥会同步复制过去,交付后即可用密钥直接登录。
设备码认证
执行 codex login --device-auth 后会显示一个代码,你在自己电脑的浏览器中输入即可。对没有图形界面的服务器来说很方便。
预装 Git 与基础工具
服务器已安装 git、curl 和 ca-certificates。首次登录后就可以克隆仓库,让智能体开始工作。
OpenAI Codex 快速上手
从下单到上线，只需几分钟。
- 1
下单时勾选 Codex 并订购 VPS
选择位于巴黎或法兰克福的 Linux VPS(Debian 12、Debian 13、Ubuntu 20.04、22.04 或 24.04)。在订购表单的“应用”标签页中勾选 OpenAI Codex;如果表单提供 SSH 公钥选项,请一并添加你的公钥。
- 2
用 codex 用户通过 SSH 登录
服务器交付后,用 codex 账户建立 SSH 连接。该账户沿用 root 的授权公钥:如果下单时没有填写公钥,请先用交付时提供的访问方式登录,再把公钥添加到 /home/codex/.ssh/authorized_keys。
Bashssh codex@SERVER_IP - 3
完成 Codex 认证并在仓库中启动
运行设备码登录命令,在浏览器中打开终端显示的地址并输入代码。随后进入某个 git 仓库,启动智能体。
Bashcodex login --device-auth git clone https://github.com/YOUR_ORG/YOUR_REPO.git && cd YOUR_REPO codex - 4
日常使用前先加固服务器
将 SSH 改为仅允许密钥登录,并让防火墙只放行 22 端口。如果有多人访问这台服务器,建议同时收紧 codex 账户的免密码 sudo。
Bashsudo apt install -y ufw sudo ufw allow 22/tcp sudo ufw enable sudo sed -i 's/^#\?PasswordAuthentication.*/PasswordAuthentication no/' /etc/ssh/sshd_config sudo systemctl reload ssh
OpenAI Codex 的使用场景
随时在线的代码智能体
启动一次大规模重构或依赖升级后直接断开连接,之后可以在另一台电脑上接着查看这次会话。
为敏感仓库准备隔离环境
把代码和部署密钥放在专门给智能体使用的服务器上,而不是自己的个人电脑里,并使用独立的系统账户。
自动化维护类任务
让 Codex 在仓库的克隆副本上编写修复补丁、测试或迁移脚本,你审阅 diff 之后再推送。
团队共用的远程工作机
小团队连接同一台服务器,把重复性工作交给 Codex 处理,每个人使用各自的 SSH 密钥。
OpenAI Codex 常见问题
不需要。安装方案使用项目官方的安装脚本,它不依赖 Node.js。安装完成后,同名用户 codex 下就可以直接使用 codex 命令。
深入了解 OpenAI Codex
认证方式
Codex 支持使用 ChatGPT 账户或 OpenAI API 密钥登录。安装脚本本身不会替你登录,需要你以 codex 用户身份运行 codex login --device-auth。设备码流程不必在服务器上打开浏览器,在你自己的电脑上确认即可。
保持会话不中断
SSH 连接一旦断开,正在执行任务的智能体就会中断。建议安装终端复用工具,例如 sudo apt install -y tmux,先运行 tmux,再在其中启动 codex。之后可以随时分离会话,并用 tmux attach 恢复。
权限与安全
codex 账户拥有免密码 sudo,安装依赖很方便,但这也意味着任何持有该账户 SSH 密钥的人都能完全控制这台机器。请妥善保管密钥,并且只在这台服务器上处理你愿意让智能体执行命令的仓库。在你对工作流程有把握之前,请使用较为谨慎的审批模式。
更新
Codex CLI 迭代很快。要获取最新版本,请以 codex 用户重新运行交付时使用的官方安装脚本:curl -fsSL https://github.com/openai/codex/releases/latest/download/install.sh | sh。如果服务器用于生产环境,更新前请先阅读项目的版本说明。
