使用网页版 Codex

Codex web 是 OpenAI 的 coding agent（编程 Agent）入口。它可以 read（读取）、edit（编辑）和 run code（运行代码），帮助你更快构建功能、修 bug，并理解不熟悉的代码。

和本地 CLI 不同，Codex cloud 可以在后台处理任务，也可以并行处理多个任务。它会使用自己的 cloud environment（云端环境），不依赖你本机当前打开的终端。

Codex web setup

打开 Codex：

https://chatgpt.com/codex

然后连接你的 GitHub account。连接后，Codex 才能访问你的 repositories（仓库）里的代码，并把它完成的工作创建成 pull requests。

Plus、Pro、Business、Edu 或 Enterprise 计划都包含 Codex。计划包含内容见：

https://developers.openai.com/codex/pricing

部分 Enterprise workspaces（企业工作区）可能需要先完成 admin setup（管理员设置），才能访问 Codex：

https://developers.openai.com/codex/enterprise/admin-setup

什么时候选 Web / Cloud

适合：

• 你希望任务在后台运行，不占用本机终端。
• 你要并行委托多个 repo task。
• 你想让 Codex 最终创建 PR。
• 你在 GitHub issue / PR 中用 @codex 触发任务。
• 你希望 IDE extension 发起 cloud delegation。

不适合：

• 任务依赖你本机未提交文件。
• 任务需要访问只存在本机的服务、设备或 GUI。
• 你还没配置 cloud environment。
• 你需要逐步确认每条 shell 命令。

使用 Codex web

Codex web 里最常见的工作方式有六类。

学习提示词写法

通过更清晰的 prompts（提示词）、明确 constraints（约束）和合适的 detail level（细节层级），让 Codex 输出更稳定。

提示词指南见：

https://developers.openai.com/codex/prompting#prompts

Common workflows

从官方整理的 workflows（工作流）开始：委托任务、review changes（审查改动）、把结果变成 PR。

https://developers.openai.com/codex/workflows

Configuring environments

配置 cloud environments，决定 Codex 在云端运行任务时使用哪个 repo、执行哪些 setup steps（初始化步骤）、可用哪些 tools（工具）。

https://developers.openai.com/codex/cloud/environments

Delegate work from the IDE extension

你可以直接从 editor（编辑器）里发起 cloud task（云端任务），然后在本地监控进度，并把 Codex 生成的 diffs（差异改动）应用回来。

https://developers.openai.com/codex/ide/features#cloud-delegation

Delegating from GitHub

你可以在 GitHub issues 或 pull requests 里 tag @codex，让 Codex 启动任务并直接提出修改。

https://developers.openai.com/codex/integrations/github

Control internet access

你可以决定 cloud environments 里的 Codex 是否能访问 public internet（公网），以及什么时候应该打开。

https://developers.openai.com/codex/cloud/internet-access

Web 任务的基本生命周期

flowchart LR
    Prompt["写清任务"] --> Env["选择 cloud environment"]
    Env --> Run["后台执行"]
    Run --> Logs["查看 logs 和 progress"]
    Logs --> Diff["review diff"]
    Diff --> Iterate["继续追问或要求修改"]
    Iterate --> PR["创建 PR"]

每个阶段都要可审查。不要只看最终摘要，要看 Codex 用了哪个 environment、跑了哪些 setup steps、改了哪些文件、验证是否成功。

Cloud environment 怎么准备

一个可用的 cloud environment 至少要说明：

• repository
• branch 或默认 base
• setup steps
• dependency install
• test / lint / build commands
• secrets 是否需要以及何时可用
• internet access 是否开启

如果 setup steps 不完整，Codex 可能会写出看似合理但无法验证的代码。Web 入口的质量很大程度取决于 environment 是否能复现项目。

Prompt 写法

Web task 应比本地 CLI prompt 更明确，因为它可能在后台跑较长时间。

推荐结构：

Task:
具体要完成什么。

Scope:
允许修改哪些目录或模块，禁止改哪些东西。

Context:
相关 issue、PR、错误日志、截图、业务规则。

Validation:
必须运行哪些命令，哪些失败可以接受，哪些失败必须停止。

Output:
希望 Codex 给出 diff summary、test evidence、PR notes 或 follow-up list。

示例：

Fix the login redirect bug described in issue #123.
Only touch the auth callback route and related tests.
Do not refactor the auth provider.
Run the auth test suite and the route-level typecheck.
If the environment cannot reproduce the bug, stop and explain what is missing before changing code.

Review 和 PR 标准

在 Web 里看到结果后，按这个顺序审查：

1. 看 task summary，确认 Codex 是否理解目标。
2. 看 changed files，确认没有越界。
3. 看 diff，确认修复是最小必要改动。
4. 看 logs，确认验证命令真的运行。
5. 看 failing checks，判断是否和本任务相关。
6. 必要时继续让 Codex 修改，而不是直接开 PR。
7. 创建 PR 后再走正常 code review。

Codex web 可以帮助你更快进入 PR，但不应该跳过 review。

Internet access 边界

Cloud environments 可以控制 Codex 是否访问 public internet。默认要按最小权限思路处理：

• 不需要下载依赖时，不打开公网。
• 需要访问外部 API 时，优先使用 allow list。
• 遇到联网调研任务时，明确要求只引用官方或可信来源。
• secrets 不要暴露到 logs。

公网访问会提高能力，也会扩大 prompt injection 和供应链风险。

完成标准

一个 Web / Cloud task 完成时，至少应该有：

• environment 和 repo 明确。
• 任务范围没有越界。
• diff 可审查。
• logs 能证明验证过程。
• Codex 说明了未验证或失败项。
• PR 描述包含问题、改法、验证、风险。

官方资料

• Codex web
• Codex workflows
• Codex cloud environments
• Delegate from IDE extension
• GitHub integration
• Cloud internet access

接下来去哪