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

---

访问 Codex Web

访问云端 Codex：

https://chatgpt.com/codex

使用前提

1. ChatGPT Plus / Pro / Business / Enterprise 计划
2. 或使用 OpenAI API Key

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

---

云端环境（Environments）

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

创建环境

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

任务执行流程

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

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

---

默认镜像

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

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

版本固定

固定版本

# Environment 设置

# 固定 Python 版本

python_version = "3.11"

# 固定 Node.js 版本

node_version = "20"

---

设置脚本

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

自动检测

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

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

手动脚本

自定义设置脚本

# Setup Script

# 在环境设置中配置

npm install

npm run build

pip install-r requirements.txt

维护脚本

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

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

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

---

环境变量与 Secrets

环境变量

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

设置环境变量

# Environment Variables

NODE_ENV=production

DEBUG=false

API_ENDPOINT=https://api.example.com

Secrets

Secrets 用于存储敏感信息：

1. 额外加密存储
2. 仅在任务执行时解密
3. 只在设置脚本中可用
4. 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 网络访问会增加风险：

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

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

---

容器缓存

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

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

---

云端任务管理

创建任务

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

任务监控

1. 实时查看进度
2. 查看文件变更
3. 检查命令输出

结果处理

1. 查看变更 Diff
2. 创建 Pull Request
3. 下载变更文件

---

并行任务

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

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

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

---

常见问题

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

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

Q: 如何收费？

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

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

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

Q: 网络访问何时需要？

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