OpenAI Codex 怎麼用？App、Cloud Tasks、CLI、AGENTS.md 與 Sandbox

OpenAI Codex 怎麼用？App、Cloud Tasks、CLI、AGENTS.md 與 Sandbox

<

p class=”wp-block-paragraph”>OpenAI Codex是一套跨App、CLI、IDE、Cloud Tasks與SDK的Coding Agent系統。開發者可以在本機即時協作，也能把可獨立描述的Issue交給Cloud Sandbox長時間執行，再從App、IDE、Web、Slack或行動端查看結果、批准命令和繼續工作。

Codex的價值不只在模型生成程式，而在任務、Repository、Worktree、AGENTS.md、Skills、Sandbox、Hooks、Terminal Logs與Tests被放進同一個交付流程。Agent可以產生PR和證據，正式合併與部署仍由分支保護、CI、Code Owner和具名負責人決定。

• Codex App是管理多個Agent Thread和專案的控制中心。
• CLI適合本機Terminal、即時修改與SSH環境。
• Cloud Task在獨立Sandbox中Clone Repository、修改和測試。
• Codex App內建Worktree支援，降低平行Agent互相覆蓋。
• AGENTS.md保存目錄範圍內的專案規則與驗收。
• Skills把重複工程方法封裝成可按需使用的程序。
• Hooks可掃描Secrets、執行Validator、記錄事件或自訂行為。
• SDK讓團隊把同一Agent Loop嵌入CI、工具和內部平台。
• Sandbox和Permission降低風險，不能取代Tests與Review。

文章實體化：OpenAI Codex 的使用邊界

OpenAI Codex 的工作方式，可以從 App、Cloud Tasks、CLI、AGENTS.md 與 Sandbox 五個實體理解：介面負責對話與協作，雲端任務負責可追蹤執行，CLI 連接本地專案，AGENTS.md 提供專案規則，Sandbox 則限制檔案、網路與命令的作用範圍。真正可靠的使用，關鍵在驗證、權限與交付邊界。

• App／Cloud Tasks／CLI：比較互動協作、遠端任務、批次執行與本地操作。
• AGENTS.md：理解如何寫專案慣例、測試命令、目錄規則與不可觸碰的邊界。
• Sandbox：聚焦檔案、網路、秘密、命令、審查與人工批准如何共同保護專案。

本文以「OpenAI Codex、App、Cloud Tasks、CLI、AGENTS.md、Sandbox、程式協作與權限」為主線，補回人物、組織、作品、技術節點、產業場景與它們之間的因果關係，讓讀者能從具名實體一路追到實際流程、文化語境與影響。

Codex有哪些入口？

Codex App怎麼使用？

Codex App讓多個Agent在不同Thread和Project中平行工作。每個Agent可以使用獨立Worktree，使用者能查看Diff、留言、手動修改或把變更開進Editor。

• 把不同Issue建立成獨立Thread。
• 每個Thread只承擔一個清楚Milestone。
• 避免兩個Agent同時修改同一核心模組。
• 查看Diff、Tests和Artifacts後再接受。
• 使用Worktree保留本機主工作樹。
• 完成後透過CI和Code Review整合。

App適合監督平行工作，不會自動解決介面衝突。多代理平行開發仍需要模組所有權與Merge Gate。

Codex CLI的權限模式

Codex CLI在本機讀寫檔案和執行命令，適合即時協作與遠端主機。官方CLI將Approval簡化為不同權限層級，從唯讀與明確批准，到Workspace內自動操作，再到可讀取更廣範圍並使用網路的高權限模式。

• 陌生Repository先使用Read-only。
• 一般Coding只開放目前Workspace。
• Network採Allowlist和短效Credential。
• 家目錄、SSH和Cloud Credential不進Scope。
• 部署、Migration和外部發布要求人工核准。
• 高權限模式只在可丟棄Sandbox使用。

完整Permission、Sandbox、Egress和Secrets設計可閱讀Coding Agent高權限模式怎麼設計？。

Cloud Task如何運作？

1. 使用者選擇Repository、Branch和Task。
2. Codex建立獨立Cloud Environment。
3. 掃描Setup Script和依賴。
4. 讀取AGENTS.md、程式與測試。
5. 修改檔案並執行命令。
6. 需要時使用Browser驗證UI。
7. 保存Commit、Terminal Log、Test和Screenshot。
8. 使用者Review、追問或建立Pull Request。

Cloud環境需要接近真實開發環境。若依賴、資料、Feature Flag和外部服務差異過大，Sandbox通過也可能在CI失敗。

AGENTS.md怎麼寫？

• Repository架構和重要模組。
• 安裝、啟動、Test、Lint、Type Check和Build命令。
• Coding Convention和錯誤處理。
• 不可修改檔案、生成檔和敏感路徑。
• Dependency、Migration和文件規則。
• 完成前必須通過的Acceptance Criteria。

AGENTS.md可以分層放在根目錄和子目錄，越接近目標檔案的規則越具體。內容應短、穩定、可執行；能轉成Lint、Tests和CI的規則不要只留在文字。

完整目錄作用域和寫法可閱讀AGENTS.md怎麼寫？。

Skills與Automations

Skills把重複方法封裝成可按需使用的程序，例如Figma實作、Release、Bug Triage、CI失敗分析和部署。Automations則把指令與Skill放到排程中，完成後進入Review Queue。

• Skill內容和腳本需要版本控制。
• 動態事實放在文件或API，不寫死在Skill。
• Automation輸出先進草稿或PR。
• 排程任務設定時間、Token和外部Action上限。
• 失敗後保存Handoff，不自動無限重跑。
• 發布、合併和部署保留人工Gate。

Hooks能做什麼？

• Prompt進入前掃描Secrets和敏感資料。
• Tool執行前檢查命令與路徑。
• 執行Validator、Lint和Policy。
• 記錄Session、Conversation與Audit。
• 把有效結果整理為Memory或Artifact。
• 依Repository和Directory自訂行為。

Hook本身也能執行程式，必須固定來源、版本與權限。阻擋安全事件時採Fail Closed，不在Hook故障後靜默放行。

Codex SDK

Codex SDK把CLI背後的Agent Loop帶進TypeScript應用，提供Thread、Structured Output與Context Resume，適合CI、自動化和內部工程平台。

import { Codex } from "@openai/codex-sdk";
const codex = new Codex({});
const thread = await codex.startThread();
const result = await thread.run(
  "Inspect this repository and propose a small patch."
);
const followup = await thread.run(
  "Implement the approved patch and run tests."
);

SDK應用需要保存Thread ID、Run結果、Cancellation、Timeout與外部Resource。Headless Agent不能因沒有人在場就自動允許所有Tools。

Programmatic Access Tokens與企業控制

Business與Enterprise可使用Workspace管理的Programmatic Access Token連接CI、Release和內部自動化。服務身份應和個人登入分開，Scope、期限、Owner與撤銷都要可管理。

• 不同Environment使用不同Token。
• 限制Repository、Tools和Network。
• 定期輪替並保存最近使用。
• 離職或事故時立即撤銷。
• 不把Token放進AGENTS.md、Log和Artifact。

多Agent平行任務

每個Agent使用Worktree和固定Base Commit，完成後由Integration Task執行完整測試。平行Agent數量不是成功指標，Wall-clock、衝突和人工整合才是。

驗收流程

1. 確認Task範圍和Acceptance Criteria。
2. 閱讀實際Diff和Changed Files。
3. 檢查Terminal Log和Tests是否真的執行。
4. 在本機或CI重跑測試。
5. 檢查Secrets、Permissions、Network和依賴。
6. 查看Browser Screenshot和後端外部狀態。
7. 由Code Owner決定Merge。
8. 保留Rollback和Post-merge監控。

AI Coding Agent通用工作流可閱讀AI Coding Agent工作流怎麼設計？。

適合哪些工作？

• 有明確Issue和測試的Bug修復。
• 小型功能和跨檔案修改。
• 文件、Changelog和Migration Guide。
• CI失敗分析和重複維護工作。
• Code Review與技術債盤點。
• 可由程式、Schema或Artifact驗證的知識工作。

需求仍模糊、無法安全重現、涉及法律責任或不可逆Production操作時，Codex更適合產生分析、Plan和草稿，而不是自行完成最後動作。

常見問題

Codex App和CLI可以共用工作嗎？

可以。App、CLI和IDE會共享相關Session和設定，工作可以在本機、Cloud和不同裝置間接續。

Cloud Task會自動合併嗎？

Codex可以建立Commit或PR，但正式Merge應由分支保護、CI和Code Review決定。

Codex只適合寫程式嗎？

它也能用程式和工具處理資料、文件與技術工作。輸出仍要具備可驗證成果和清楚責任。

若要從 OpenAI Codex App、Cloud Tasks 與 CLI 的工作分工，延伸細看 CLI 的 Permissions、Sandbox、AGENTS.md、Review 與非互動模式如何落地，可延伸閱讀 Codex CLI怎麼用？Permissions、Sandbox、AGENTS.md、Review與非互動模式，補上同一實體脈絡的延伸閱讀。

2026 年的 Codex 讀法：產品、執行面與文件不能混為一談

前面的入口、權限與驗收說明，回答的是「一個任務怎麼被執行」。但產品在持續更新時，讀者還需要一個穩定的分類方法：先確認這段文字是在描述產品表面、執行環境、模型能力，還是團隊自己的流程建議。這四層若混在一起，任何一次版本更新都可能讓舊文章看起來像是錯誤的產品承諾。

截至 2026 年 8 月 24 日重新核對 OpenAI 的公開 Codex 產品頁，它把 Codex 定位成 ChatGPT 裡的 coding agent，並同時放在 ChatGPT、editor 與 terminal 等工作表面。這能支持「Codex 不只是一個聊天視窗」的產品層判讀，但不能直接推出每個帳戶、地區、方案或工作區都具備相同功能。實際可用入口仍要以帳戶介面、工作區政策與官方文件的當日說明為準。

先把四層問題分開

• 產品層：讀者在哪裡找到 Codex，例如 ChatGPT、桌面應用程式、IDE、CLI 或 cloud；這回答的是入口，不是模型品質保證。
• 執行層：任務在哪個 repository、branch、worktree 或隔離環境中跑；這決定檔案、網路、憑證與工具能否被讀取。
• 協作層：Skills、AGENTS.md、hooks、review、scheduled work 與多 Agent 分工；這回答的是規則和責任如何被重複套用。
• 驗收層：測試、diff、artifact、人工批准與 rollback；這才是「完成」能否被第三方重新檢查的依據。

這個分層也能處理常見的內容更新：產品頁改了入口時，只更新產品層的連結；執行環境或權限規則改變時，才需要重新核對 CLI、sandbox 與工作區政策；若只是某個模型或方案更新，則應在模型與資格欄位標示核對日期。把變動範圍寫清楚，讀者才知道哪些段落可以沿用，哪些必須在今天重新確認。

官方產品頁提到平行 Agent、worktrees、cloud environments、Skills 與背景工作，適合當作產品方向的原始資料；本文把它們轉成操作上的檢查問題，而不是把宣傳用語改寫成效率、可靠性或投資報酬的保證。若某個團隊只需要一次性補丁，單一 Agent 加上清楚的 diff 與測試，可能比多 Agent 更容易審查；只有當責任、上下文或權限真的需要分離，才值得增加並行角色。

把模型名稱留在正確的位置

Codex 是 coding agent 產品與工作流，不等同於某一個固定模型名稱。模型負責理解與生成，Agent loop 負責決定下一步，工具與 sandbox 決定它能做什麼，repository 規則決定哪些變更被允許，測試與人類 review 則決定結果能否交付。同一個模型放進不同工具、權限和上下文，會產生不同風險與可觀察性；因此文章不應用「模型更強」取代對執行環境的說明。

實務上可以用一張四欄表檢查每個 Codex 任務：目標寫出要改變的行為；允許面列出檔案、命令、網路和外部服務；證據列出測試、diff、來源與 read-back；停止條件說明何時交回人、回滾或要求新批准。這張表比記住某個版本號更耐用，也能避免把產品更新誤讀成自動取得更高權限。

本段官方核對日：2026 年 8 月 24 日。產品定位與工作表面以 OpenAI Codex 為主；文件入口另以 OpenAI／ChatGPT 官方文件 重新核對。官方資料會更新；本文的分層、驗收表與風險邊界是 YOLO LAB 的編輯分析，不是 OpenAI 對任何團隊的交付保證。

官方資料與延伸閱讀

• Introducing the Codex App
• Codex正式可用與SDK
• Codex Mobile、Hooks與Programmatic Tokens
• AI Coding Agent怎麼選？

OpenAI Codex把Coding Agent延伸到App、Cloud、CLI、IDE、SDK與行動端。真正產生工程價值的部分，仍是Task Scope、Environment、Sandbox、Tests、Artifacts和人類Review共同形成的交付系統。