使用網頁版 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

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 裡看到結果後，按這個順序審查：

看 task summary，確認 Codex 是否理解目標。
看 changed files，確認沒有越界。
看 diff，確認修復是最小必要改動。
看 logs，確認驗證命令真的執行。
看 failing checks，判斷是否和本任務相關。
必要時繼續讓 Codex 修改，而不是直接開 PR。
建立 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

Codex web setup

什麼時候選 Web / Cloud

使用 Codex web

學習提示詞寫法

Common workflows

Configuring environments

Delegate work from the IDE extension

Delegating from GitHub

Control internet access

Web 任務的基本生命週期

Cloud environment 怎麼準備

Prompt 寫法

Review 和 PR 標準

Internet access 邊界

完成標準

官方資料

接下來去哪

Cloud 執行時

網路許可權

遠端開發

Codex CLI

GitHub Action

GitHub Code Review

本頁目錄