OpenAI Codex CLI

Codex 是 OpenAI 的开源 AI 编程代理。此模板将 Codex 部署为 Zeabur 上的持久化云端工作站，并提供浏览器可访问的 Web 终端（ttyd）。

开始使用

1. 部署模板并等待服务启动。请等待健康检查变为绿色后再继续。
2. 在浏览器中打开服务网址（绑定到服务的域名）。
3. 登录，用户名为 user，密码请在 Zeabur 仪表板的 Instructions 页签查看。
4. 登录 — 执行 codex，然后在浏览器打开 https://auth.openai.com/codex/device 并输入终端显示的一次性代码。参考 Codex 认证文档。

使用 API 密钥（可选）

除了设备代码登录外，也可以在 Zeabur 仪表板设置 OPENAI_API_KEY。可选择设置 OPENAI_BASE_URL 以使用 Zeabur AI Hub。

持久化存储

/home/node/ 下的所有数据在重启和重新部署后都会保留。

常用命令

命令	说明
codex	启动交互式 Codex 会话
codex "描述任务"	使用特定提示运行 Codex
codex exec "任务"	非交互式运行（用于自动化）
codex resume	恢复之前的会话
codex --version	检查已安装的 Codex 版本

建议资源配置

• 最低配置：1 vCPU / 2 GB RAM
• 建议配置：2 vCPU / 4 GB RAM

变更记录

2026-03-31 — 首次发布

• ttyd Web 终端（密码验证及设备代码登录）
• Homebrew 及 npm 全局包持久化于卷
• 资源需求及域名绑定

链接

• GitHub
• Codex CLI 文档