← 返回系统教程
系统教程CloudCloud进阶

配置 Codex Cloud 环境:让远程任务可重复

用固定依赖、setup 与 maintenance 脚本、环境变量和秘密边界,为 Cloud 任务建立可复现执行环境。

40 分钟阅读核验于 2026/07/16

理解 Cloud 任务生命周期

Cloud 会在隔离容器中检出指定分支或提交,运行 setup,应用网络设置,再由 agent 执行任务。完成后应检查回答和 diff,而不是假设远程任务已经满足本地环境全部条件。

把环境准备写成脚本

固定语言与包管理器版本,使用仓库锁文件安装依赖,并把必要工具安装放在 setup。缓存恢复时可用 maintenance 脚本同步依赖;修改脚本或变量会使缓存失效。

  • setup 脚本的 shell 导出不会自动延续到 agent 阶段。
  • 普通环境变量可贯穿任务;秘密只在 setup 阶段可用。
  • agent 阶段网络默认关闭,只有必要时才开启受限访问。

在 AGENTS.md 写出验证入口

让 Cloud 任务能够发现仓库的 lint、类型检查、测试和构建命令。命令应可在干净检出中运行,并避免依赖开发者机器上的未跟踪状态。

参考来源

优先使用 OpenAI 官方文档与官方仓库。外部来源会单独标识。

  1. OpenAI Codex Cloud

    官方来源 · https://learn.chatgpt.com/docs/cloud

  2. OpenAI Codex AGENTS.md

    官方来源 · https://learn.chatgpt.com/docs/agent-configuration/agents-md

  3. OpenAI Codex Agent Approvals & Security

    官方来源 · https://learn.chatgpt.com/docs/agent-approvals-security

codex.study 是独立运营的中文 Codex 学习与资料平台,与 OpenAI 不存在隶属、授权或官方认证关系。