---
title: "使用网页版 Codex"
description: "介绍 Codex web 入口如何读取代码、修改代码和运行验证，适合不想先配置本地环境的新手。"
verifiedAt: "2026-05-07"
---

> [!NOTE]
> **这一篇用 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](https://chatgpt.com/codex)

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

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

[https://developers.openai.com/codex/pricing](https://developers.openai.com/codex/pricing)

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

[https://developers.openai.com/codex/enterprise/admin-setup](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](https://developers.openai.com/codex/prompting#prompts)

### Common workflows

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

[https://developers.openai.com/codex/workflows](https://developers.openai.com/codex/workflows)

### Configuring environments

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

[https://developers.openai.com/codex/cloud/environments](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](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](https://developers.openai.com/codex/integrations/github)

### Control internet access

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

[https://developers.openai.com/codex/cloud/internet-access](https://developers.openai.com/codex/cloud/internet-access)

## Web 任务的基本生命周期

```mermaid
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 更明确，因为它可能在后台跑较长时间。

推荐结构：

```text
Task:
具体要完成什么。

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

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

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

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

示例：

```text
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](https://developers.openai.com/codex/cloud)
- [Codex workflows](https://developers.openai.com/codex/workflows)
- [Codex cloud environments](https://developers.openai.com/codex/cloud/environments)
- [Delegate from IDE extension](https://developers.openai.com/codex/ide/features#cloud-delegation)
- [GitHub integration](https://developers.openai.com/codex/integrations/github)
- [Cloud internet access](https://developers.openai.com/codex/cloud/internet-access)

## 接下来去哪

<Cards>
  <Card title="Cloud 运行时" href="/docs/codex/official/05-cloud-remote/18-cloud-runtime" description="cloud environment 怎么配置 setup / dependency / secrets" />
  <Card title="网络权限" href="/docs/codex/official/05-cloud-remote/19-network-permissions" description="public internet 该不该开" />
  <Card title="远程开发" href="/docs/codex/official/05-cloud-remote/70-remote-dev" description="另一种非本机执行路径：SSH" />
  <Card title="Codex CLI" href="/docs/codex/official/01-products/03-cli" description="Web 不合适时回到 CLI" />
  <Card title="GitHub Action" href="/docs/codex/official/06-team-integration/45-github-action" description="@codex 触发的另一类入口" />
  <Card title="GitHub Code Review" href="/docs/codex/official/06-team-integration/60-github-code-review" description="把 PR review 也接上 Codex" />
</Cards>
