---
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="/zh-Hant/docs/codex/official/05-cloud-remote/18-cloud-runtime" description="cloud environment 怎麼配置 setup / dependency / secrets" />
  <Card title="網路許可權" href="/zh-Hant/docs/codex/official/05-cloud-remote/19-network-permissions" description="public internet 該不該開" />
  <Card title="遠端開發" href="/zh-Hant/docs/codex/official/05-cloud-remote/70-remote-dev" description="另一種非本機執行路徑：SSH" />
  <Card title="Codex CLI" href="/zh-Hant/docs/codex/official/01-products/03-cli" description="Web 不合適時回到 CLI" />
  <Card title="GitHub Action" href="/zh-Hant/docs/codex/official/06-team-integration/45-github-action" description="@codex 觸發的另一類入口" />
  <Card title="GitHub Code Review" href="/zh-Hant/docs/codex/official/06-team-integration/60-github-code-review" description="把 PR review 也接上 Codex" />
</Cards>
