Codex Cloud(Legacy)
维护旧版集成环境,理解 setup secrets、maintenance script、容器缓存与默认联网。
This page has not been translated into English yet. The original Chinese version is shown below.
Legacy 环境继续服务 Code Review、Linear 和 GitHub 等集成。新网页、手机和桌面云任务优先参照新云环境,不要混用两个环境模型。
旧版任务生命周期
- 创建容器,checkout 选定分支或提交。
- 运行 setup script;恢复缓存容器时可运行 maintenance script。
- 应用 agent 阶段联网设置。
- 根据任务和 AGENTS.md 中的项目要求编辑、执行和验证。
- 返回结果与 diff,再由用户决定后续任务或 PR。
默认 universal 镜像预装常用语言和工具。可以在环境的 Set package versions 固定运行时版本,其他依赖使用自动或手动 setup。
环境变量与秘密
普通环境变量贯穿 setup 与 agent 阶段。Legacy secrets 只供 setup 使用,在 agent 阶段开始前移除。这与新环境的 Network secrets 代理替换方式不同。
setup 在独立 Bash 会话执行,单次 export 不会自动持续到 agent 阶段。持久设置应通过环境设置或官方说明的 shell 配置完成。
缓存与 maintenance
容器缓存最长 12 小时。缓存准备时 clone 默认分支并运行 setup,恢复后 checkout 任务分支,再运行可选 maintenance;这适合更新旧缓存与当前提交之间变化的依赖。
修改 setup、maintenance、变量或 secrets 会失效缓存。仓库变化导致缓存不兼容时,可用环境页 Reset cache。Business/Enterprise 环境缓存对有访问权的用户共享,失效也影响其他使用者。
网络限制
setup 阶段可以联网安装依赖,agent 阶段默认关闭联网,可配置有限或不受限访问。出站流量经过 HTTP/HTTPS proxy。企业 command-network requirements 与环境联网开关分别生效,允许某层的域名不代表可以突破另一层限制;command 网络限制也不自动关闭搜索、应用或 MCP。