理解 Cloud 任务生命周期
Cloud 会在隔离容器中检出指定分支或提交,运行 setup,应用网络设置,再由 agent 执行任务。完成后应检查回答和 diff,而不是假设远程任务已经满足本地环境全部条件。
把环境准备写成脚本
固定语言与包管理器版本,使用仓库锁文件安装依赖,并把必要工具安装放在 setup。缓存恢复时可用 maintenance 脚本同步依赖;修改脚本或变量会使缓存失效。
- setup 脚本的 shell 导出不会自动延续到 agent 阶段。
- 普通环境变量可贯穿任务;秘密只在 setup 阶段可用。
- agent 阶段网络默认关闭,只有必要时才开启受限访问。
在 AGENTS.md 写出验证入口
让 Cloud 任务能够发现仓库的 lint、类型检查、测试和构建命令。命令应可在干净检出中运行,并避免依赖开发者机器上的未跟踪状态。
参考来源
优先使用 OpenAI 官方文档与官方仓库。外部来源会单独标识。
- OpenAI Codex Cloud
官方来源 · https://learn.chatgpt.com/docs/cloud
- OpenAI Codex AGENTS.md
官方来源 · https://learn.chatgpt.com/docs/agent-configuration/agents-md
- OpenAI Codex Agent Approvals & Security
官方来源 · https://learn.chatgpt.com/docs/agent-approvals-security
codex.study 是独立运营的中文 Codex 学习与资料平台,与 OpenAI 不存在隶属、授权或官方认证关系。