进阶 📋 6 个步骤 第 544 / 545 篇

用 Codex Cloud 在云端跑长时编码任务:可复用环境 + 休眠续跑 + CLI 提交

OpenAI DevDay 2026 给 Codex 加了可复用云端环境:准备一次依赖,发布后每个任务从已装好的文件系统启动,电脑关机也能续跑。

2026.10.18· 4 分钟上手· 约 1300 字· ☁️ Codex Cloud / 🤖 云端编码

OpenAI 在 DevDay 2026 给 Codex 加了「可复用云端环境」:你准备一次项目依赖与工具,发布成环境,之后每个任务都从这份已装好的文件系统启动,电脑关机也能继续跑。这意味着你可以把「修 bug / 加功能」这类长时编码任务交给云端,自己下班,第二天回来审 diff、开 PR。本教程从连接 GitHub、发布环境、提交一个云端任务,到用 CLI 在终端提交与查状态,一步步跑通云端闭环。

☁️ 本教程适合:已经用 Codex(或 ChatGPT 里的 Codex)做编码、想让长任务在云端跑、电脑不用开着、且愿意把仓库接给 Codex Cloud 的开发者。需要 ChatGPT Plus 及以上套餐的 Codex Cloud 权限与一个 GitHub 仓库。

Step 1:看清哪些活儿该放云端

1 云端 vs 本地,按运行位置选

Codex Cloud 把任务跑在 OpenAI 托管的虚拟机里,每个任务独立工作区。判断标准很直接:能远程跑、要长时间、你不想守着电脑的,放云端;依赖本机文件、浏览器登录态、VPN 的,留本地。

放云端:GitHub 项目、依赖能远程装、要跑很久的重构或修 bug
留本地:依赖本机已登录的浏览器、需要本机 VPN、频繁在编辑器里改
💡 Codex Cloud 用 ChatGPT 登录即可,本流程不需要 OpenAI API Key。云端任务可能比本地消息更费额度,先用小任务试水。

Step 2:连接 GitHub 并创建云端环境

2 在 ChatGPT 桌面端 / Web 里操作

打开 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:审阅并发布环境

3 保存 install script 与 start skill

Codex 会记录两份配置:install script(装依赖、准备资源的命令)和 start skill(启动服务并确认就绪的指令)。审阅后保存、发布,状态变成 Environment published。

# 你审阅的两块内容示例
install script: npm ci && npm run build
start skill:   npm run dev(确认 3000 端口就绪)
# 点 Publish → 等 Environment published
🔑 不必自己手写长 install script——Codex 会从仓库自动准备并测试。你只做审阅。网络秘钥(network secret)走 443 HTTPS 占位替换,原始凭据不进本地文件,比环境变量更安全。

Step 4:提交一个云端任务并审 diff

4 描述目标,跑完审结果

选已发布环境,描述一个「小而完整、可验证」的改动,要求它跑项目检查、总结改动、准备好 PR。

"在这个仓库里做一个明确有用且能完成的小改动(例如补一段 README、
给现有页面加一行页脚署名)。按 AGENTS.md 跑 lint 与测试。
总结你改了什么,准备好一个 PR(标题简短、正文清楚)。"

成本提醒:云端任务按用量计费,可能比本地消息更费额度。新环境先用最小改动试通整条链路,确认 diff、测试、PR 都正常,再放大任务。

Step 5:从 CLI 在终端提交与查状态

5 codex cloud 实验命令

不想开桌面端时,可以用 Codex CLI 在终端提交云任务、列出近期云会话与状态。CLI 里 codex cloud 目前是实验命令。

# 打开云端会话选择器
codex cloud

# 向某个已发布环境提交一个任务(实验)
codex cloud exec "给 src/utils 补类型标注并跑 tsc" --env <env-id>
💡 已运行中的任务可以换设备继续:在手机或另一台电脑打开同一个 Codex Cloud 环境即可续上。新任务则从已发布环境全新启动。

Step 6:把项目规则放进 AGENTS.md

6 让环境自带规范

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 或按文档同步回本地仓库
担心费用先用小改动试通链路,再放大;云端用量与本地消息共享额度
← 返回教程中心