Codex 云端版本

Codex Web 是云端版本，让你从任何设备访问 Codex，在隔离环境中运行任务。

访问 Codex Web

访问云端 Codex：

https://chatgpt.com/codex

使用前提

  • ChatGPT Plus / Pro / Business / Enterprise 计划
  • 或使用 OpenAI API Key

使用 API Key 时，部分云端功能可能不可用。

云端环境（Environments）

Environment 是 Codex Web 的核心概念，每个环境是一个隔离的工作空间。

创建环境

  1. 连接 GitHub 账号
  2. 选择一个仓库
  3. 配置设置脚本和环境变量
  4. 选择网络访问策略

任务执行流程

云端任务按以下流程执行：

  1. 创建容器，克隆仓库到选定分支
  2. 运行设置脚本安装依赖
  3. 应用网络访问设置
  4. Agent 执行任务（编辑代码、运行命令、验证结果）
  5. 显示结果和文件变更

默认镜像

云端使用名为 universal 的默认容器镜像：

  • 预装常见语言：Python、Node.js、Go、Rust
  • 包含常用工具：npm、pip、cargo、git
  • 可固定运行时版本

版本固定

固定版本

# Environment 设置

# 固定 Python 版本
python_version = "3.11"

# 固定 Node.js 版本
node_version = "20"

设置脚本

设置脚本在容器创建时自动运行：

自动检测

Codex 自动识别项目类型并执行相应安装：

  • Node.js：自动运行 npm install / yarn / pnpm
  • Python：自动运行 pip install / poetry install

手动脚本

自定义设置脚本

# Setup Script
# 在环境设置中配置

npm install
npm run build
pip install -r requirements.txt

维护脚本

维护脚本在缓存容器启动时运行：

  • 用于更新依赖或重新构建
  • 比完整设置更快

设置脚本与 Agent 在不同的 Bash 会话中运行，export 命令不会持久化。

环境变量与 Secrets

环境变量

环境变量在整个任务期间可用：

设置环境变量

# Environment Variables
NODE_ENV=production
DEBUG=false
API_ENDPOINT=https://api.example.com

Secrets

Secrets 用于存储敏感信息：

  • 额外加密存储
  • 仅在任务执行时解密
  • 只在设置脚本中可用
  • Agent 阶段自动移除
类型可见范围用途
Environment Variables设置脚本 + Agent常规配置
Secrets仅设置脚本API Key、密码

网络访问控制

云端环境的网络访问默认受限：

默认设置

阶段网络访问
设置脚本允许（安装依赖需要）
Agent禁止（默认）

Agent 网络访问选项

设置说明
Off完全禁止网络访问
On允许网络访问（可限制域名）

域名白名单

域名配置

# 网络配置

# 白名单预设
domain_allowlist = "common-dependencies"
# 包含：github.com, npmjs.com, pypi.org 等

# 自定义域名
domain_allowlist = [
    "github.com",
    "api.mycompany.com"
]

# 限制 HTTP 方法
allowed_methods = ["GET", "HEAD", "OPTIONS"]

安全风险

启用 Agent 网络访问会增加风险：

  • 提示注入（从恶意网页获取指令）
  • 数据泄露（向外部发送代码或密钥）
  • 下载恶意依赖

仅在必要时启用 Agent 网络访问，并使用域名白名单限制。

容器缓存

云端缓存容器状态以加速后续任务：

  • 缓存最多 12 小时
  • 设置脚本或环境变量变化时自动失效
  • 新任务启动更快

云端任务管理

创建任务

  1. 选择环境
  2. 输入任务描述
  3. 选择模型和配置
  4. 启动任务

任务监控

  • 实时查看进度
  • 查看文件变更
  • 检查命令输出

结果处理

  • 查看变更 Diff
  • 创建 Pull Request
  • 下载变更文件

并行任务

云端支持并行运行多个任务：

  • 同时处理不同功能
  • 多个环境独立工作
  • 提高整体效率

避免多个任务同时修改同一文件，否则会产生冲突。

常见问题

Q: Cloud 和本地有什么区别？

Cloud 在远程服务器运行，适合并行任务和远程访问；本地直接操作你的文件。

Q: 如何收费？

云端任务消耗额度，费用根据模型和使用量计算。

Q: 可以访问本地文件吗？

云端无法访问本地文件，但可以通过 Git 同步。

Q: 网络访问何时需要？

仅当 Agent 需要实时数据或外部 API 时才需要，设置脚本通常足够。