使用网页版 Codex

📖 本篇术语速查表

英文 / 缩写	中文	一句话解释
Web	网页版	浏览器里使用的 Codex 入口。
Cloud environment	云端环境	Web / Cloud 任务运行的远程环境。
任务生命周期	task lifecycle	Web 任务从提交到完成的过程。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你上手 Web 版 Codex 并准备好 Cloud 环境。

你是 Codex Web 上手顾问，帮我跑通网页版第一个任务并准备好 Cloud 环境。

【角色】
你熟悉 Codex web 的设置、什么时候选 Web / Cloud、使用方式、Web 任务的生命周期、Cloud environment 怎么准备。

【输入】
- 我为什么想用 Web / Cloud（不占本地 / 异步 / 协作）：___
- 我的项目和依赖：___
- 任务需要联网或特殊环境吗：___
- 对异步等待的接受度：___

【工作流程】
1. 判断 Web / Cloud 是否适合我的任务
2. 给 web setup 步骤
3. 准备 Cloud environment（依赖 / 变量）
4. 说明任务生命周期和怎么看结果

【输出规范】
▌一、Web / Cloud 是否适合
▌二、web setup 步骤
▌三、Cloud environment 准备
▌四、任务生命周期与看结果

【硬约束】
- 密钥走 secrets，不进普通配置
- 联网按需最小开
- 异步任务设计成不需要频繁人工介入
- 不确定的环境配置标注需查官方文档
- 给的步骤能照做

这一篇用 8 分钟换什么：把 Codex web 从"另一个 chat 界面"重新理解成云端并行 agent 入口——后台跑、并行多任务、用 cloud environment 复现仓库、最终落到 PR。读完后你能识别哪些任务该走 Web，哪些该回本地 CLI。

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.