OpenAI Codex 云环境用于控制云任务里安装什么、运行什么、能访问什么网络。你可以在 Codex settings 里配置依赖、工具、环境变量、secrets、setup script 和 cache；如果启用 package version pinning，还能固定 Python、Node.js 等运行时版本。

OpenAI Codex 云环境配置 #

OpenAI Codex 的云环境决定了云任务运行时会安装哪些依赖、执行哪些脚本，以及环境变量和网络访问的可用范围。适合需要在 Codex 里配置项目依赖、安装 lint/format 工具、设置环境变量，或排查云任务启动、缓存和联网限制的场景。

Cloud task 的运行流程 #

提交任务后，Codex 会按下面的顺序运行：

1. Codex 创建一个容器，并在选定的 branch 或 commit SHA 上检出代码库。
2. Codex 运行 setup script；如果命中缓存容器并恢复，还会运行可选的 maintenance script。
3. Codex 应用互联网访问设置。setup script 默认可以联网；agent 阶段默认关闭联网，但可以按需开启 limited 或 unrestricted access。更多说明见 agent internet access。
4. agent 在终端里循环执行命令，编辑代码、运行检查，并尝试验证结果。如果代码库里有 AGENTS.md，agent 会读取其中的项目级 lint 和 test 命令。
5. 任务完成后，Codex 会展示答案和修改文件的 diff。你可以打开 PR，或者继续追问。

默认 universal 容器镜像 #

Codex agent 默认运行在名为 universal 的容器镜像中，这个镜像已经预装了常见语言、包和工具。

在环境设置里选择 Set package versions，可以固定 Python、Node.js 和其他 runtime 的版本。

如果想查看已安装内容，可以参考 openai/codex-universal 的 Dockerfile 和可在本地拉取测试的镜像。

codex-universal 虽然已经预装了常用语言，仍然可以通过 setup scripts 继续安装额外包。

环境变量和 secrets #

Environment variables 会在整个任务期间保持有效，包括 setup scripts 和 agent 阶段。

Secrets 的作用类似环境变量，但有两点不同：

• 它们会用额外一层加密保存，只会在任务执行时解密。
• 它们只对 setup scripts 可用。出于安全原因，agent 阶段开始前会移除 secrets。

自动安装依赖 #

如果项目使用常见包管理器（npm、yarn、pnpm、pip、pipenv、poetry），Codex 可以自动安装依赖和工具。

手动 setup script #

如果开发环境更复杂，也可以提供自定义 setup script。例如：

# Install type checker
pip install pyright

# Install dependencies
poetry install --with test
pnpm install

setup scripts 和 agent 不在同一个 Bash session 里运行，所以像 export 这样的命令不会带到 agent 阶段。要让环境变量持续生效，可以写入 ~/.bashrc，或者在环境设置里配置。

Container caching #

Codex 会缓存容器状态，最长 12 小时，用来加快新任务和后续追问的启动速度。

环境被缓存时：

• Codex 会克隆代码库，并检出 default branch。
• Codex 会运行 setup script，并缓存此时的容器状态。

缓存容器恢复时：

• Codex 会检出任务指定的 branch。
• Codex 会运行 maintenance script（可选）。这适合 setup script 运行时还是旧 commit，而依赖需要更新的情况。

如果你修改了 setup script、maintenance script、环境变量或 secrets，Codex 会自动使缓存失效。若代码库变化导致缓存状态不兼容，可以在环境页面选择 Reset cache。

对于 Business 和 Enterprise 用户，缓存会在所有有权限访问该环境的用户之间共享。使缓存失效会影响工作区里所有使用该环境的人。

Internet access 和 network proxy #

setup script 阶段可以联网，用来安装依赖。agent 阶段默认关闭联网，但可以配置 limited 或 unrestricted access。更多细节见 agent internet access。

环境运行在 HTTP/HTTPS network proxy 后面，用于安全和滥用防护。所有出站互联网流量都会经过这个 proxy。

常见问题 #

OpenAI Codex 云任务怎么安装依赖 #

如果项目使用 npm、yarn、pnpm、pip、pipenv 或 poetry，Codex 可以自动安装依赖和工具。复杂项目则可以在 setup script 里手动执行安装命令，例如 poetry install --with test 或 pnpm install。

为什么 setup script 里设置的环境变量到 agent 阶段不生效 #

因为 setup scripts 和 agent 运行在不同的 Bash session 里，export 不会自动传过去。要持久化环境变量，可以写到 ~/.bashrc，或者直接在环境设置里配置。

Codex 缓存什么时候会失效 #

当你修改 setup script、maintenance script、环境变量或 secrets 时，Codex 会自动使缓存失效。如果代码库状态和缓存不兼容，可以在环境页面手动选择 Reset cache。