Codex CLI Cloud Tasks：从终端启动云端任务

适用场景

如果你在终端里工作，但希望把一个长任务交给 Codex Cloud 后台执行，可以使用 codex cloud。

适合场景：

• 任务耗时较长。
• 希望云端并行尝试多个方案。
• 需要在终端里查看云端任务状态。
• 想把云端生成的 diff 应用回本地。

前置条件

开始前确认：

• CLI 已登录。
• 你的计划和工作区支持 Codex Cloud。
• 已配置可用 cloud environment。
• 当前本地项目和云端仓库对应关系清楚。
• 任务不依赖本地未同步文件。

Cloud 任务运行在远端环境，不会自动拥有你本机的所有文件和工具。

打开 Cloud 任务选择器

运行：

codex cloud

不带参数时会打开交互式 picker。你可以浏览 active 或 finished tasks，并把结果应用到本地项目。

如果你不确定 environment ID，可以在这个界面中选择环境，或到 Web dashboard 确认。

直接启动云端任务

官方示例：

codex cloud exec --env ENV_ID "Summarize open bugs"

更实际的例子：

codex cloud exec --env frontend-prod "修复登录页移动端布局溢出问题，完成后运行 npm run lint 和 npm run build"

任务 prompt 仍然要包含范围、限制和验证命令。

使用 best-of-N attempts

如果你想让云端生成多个方案，可以加：

codex cloud exec --env ENV_ID --attempts 3 "提出三种降低首页首屏 JS 体积的方案，并各自给出 patch"

--attempts 支持 1 到 4。适合探索性任务，但会增加成本和审查负担。

应用结果到本地

云端任务完成后，通过 codex cloud 浏览结果，并选择应用 diff。应用前检查：

• 云端基于哪个分支或 commit。
• diff 是否和本地未提交改动冲突。
• 是否修改了依赖、配置或环境文件。
• 是否运行了验证命令。

应用后在本地再跑一次验证，避免云端环境和本地环境差异。

常见错误

不要把本地未保存或未提交的上下文当成云端已知。Cloud 看不到你的桌面临时状态。

不要滥用 --attempts。多个方案会增加审查成本。

不要跳过本地验证。云端通过不代表你的本地环境完全一致。

小结

codex cloud 让终端用户不离开 CLI 就能发起和管理云端任务。正确流程是：确认环境、写清任务、必要时使用 attempts、审查结果、应用 diff、回到本地验证。