OpenAI 在 DevDay 2026 给 Codex 加了「可复用云端环境」:你准备一次项目依赖与工具,发布成环境,之后每个任务都从这份已装好的文件系统启动,电脑关机也能继续跑。这意味着你可以把「修 bug / 加功能」这类长时编码任务交给云端,自己下班,第二天回来审 diff、开 PR。本教程从连接 GitHub、发布环境、提交一个云端任务,到用 CLI 在终端提交与查状态,一步步跑通云端闭环。
Step 1:看清哪些活儿该放云端
Codex Cloud 把任务跑在 OpenAI 托管的虚拟机里,每个任务独立工作区。判断标准很直接:能远程跑、要长时间、你不想守着电脑的,放云端;依赖本机文件、浏览器登录态、VPN 的,留本地。
放云端:GitHub 项目、依赖能远程装、要跑很久的重构或修 bug
留本地:依赖本机已登录的浏览器、需要本机 VPN、频繁在编辑器里改
Step 2:连接 GitHub 并创建云端环境
打开 ChatGPT 桌面端或 Web,新任务里选 Work in > Cloud,打开 Select environment,选 Create environment,连上 GitHub 并勾选要接的仓库,Codex 会自动装依赖、测流程。
路径:ChatGPT → 新任务 → Work in ▸ Cloud → Select environment
→ Create environment → 选 GitHub 仓库 → Get started
Codex 会自动:克隆仓库、装依赖、跑通工作流、提出环境配置
访问边界:首次只给仓库「访问」权限即可,网络访问和密钥等敏感项等环境真的跑不起来再加。不要一上来就开「全部域名」或无限制网络。
Step 3:审阅并发布环境
Codex 会记录两份配置:install script(装依赖、准备资源的命令)和 start skill(启动服务并确认就绪的指令)。审阅后保存、发布,状态变成 Environment published。
# 你审阅的两块内容示例
install script: npm ci && npm run build
start skill: npm run dev(确认 3000 端口就绪)
# 点 Publish → 等 Environment published
Step 4:提交一个云端任务并审 diff
选已发布环境,描述一个「小而完整、可验证」的改动,要求它跑项目检查、总结改动、准备好 PR。
"在这个仓库里做一个明确有用且能完成的小改动(例如补一段 README、
给现有页面加一行页脚署名)。按 AGENTS.md 跑 lint 与测试。
总结你改了什么,准备好一个 PR(标题简短、正文清楚)。"
成本提醒:云端任务按用量计费,可能比本地消息更费额度。新环境先用最小改动试通整条链路,确认 diff、测试、PR 都正常,再放大任务。
Step 5:从 CLI 在终端提交与查状态
不想开桌面端时,可以用 Codex CLI 在终端提交云任务、列出近期云会话与状态。CLI 里 codex cloud 目前是实验命令。
# 打开云端会话选择器
codex cloud
# 向某个已发布环境提交一个任务(实验)
codex cloud exec "给 src/utils 补类型标注并跑 tsc" --env <env-id>
Step 6:把项目规则放进 AGENTS.md
AGENTS.md 会随每次仓库检出一起带走,是给云端 Codex 的「项目规则」载体:lint 命令、测试命令、目录约定都写这里,云端任务自动遵守。
# AGENTS.md(仓库根目录)
- 运行检查:npm run lint && npm test
- 目录约定:组件放 src/components,接口放 src/server/routes
- 提交前必须跑通测试,禁止跳过
个人技能不跟随:放在你笔记本上的个人 skills 不会同步到云端任务,只有仓库里的 skills 才随检出生效。需要云端用的规则,务必写进仓库的 AGENTS.md 或 .claude/。
常见问题速查
| 现象 | 原因与处理 |
|---|---|
| 环境一直 unpublished | 新任务需要先发布环境;改了 setup 后 republish 再开新任务 |
| 本地看不到云端改动 | 云端改动在云端工作区,pull 或按文档同步回本地仓库 |
| 担心费用 | 先用小改动试通链路,再放大;云端用量与本地消息共享额度 |