終極 Agent 設計：喚醒 Claude × Codex [最新版本]

即使被要求「請給出更具體的指示」，我也希望從那個「具體的部分」開始就能得到協助。

你心裡有想做的東西，但在向 AI 提問前做前置調查時，手卻停了下來。這感覺很不划算。

舉例來說，假設你想要一個可以登錄案件、並依截止日期排序的 App。這種程度你還說得出來。但如果被問到資料儲存方式或如何檢查 bug，需要調查的量就會突然暴增。

在調查的過程中，你會開始刪減原本想加入的功能，心想「這次沒有這些應該也還好」。這不是因為覺得做出來很困難，而是你想把範圍控制在萬一出錯時自己也能處理的程度。

其實我並不想在提問前把每個細微的指示都準備好。我希望你能察覺我可能漏掉的地方。如果你能用清楚的方式讓我在兩個選項中做決定，然後根據這些決定繼續推進工作，那就太有幫助了。

本文要組建的開發團隊，就是為了更貼近這類需求而設計的，使用的是 Claude Code 與 Codex。

• Claude Code：需求的聯絡窗口。負責整理必要的確認事項與分工。
• Codex：負責實作與檢查。

以案件管理 App 為例，除了建立畫面，你還要準備驗證任務。如果欄位空白就送出會怎樣？重新載入後紀錄還會存在嗎？如果 bug 修不好，就把嘗試過的修復方式與殘留的症狀整理起來，交接給另一個 agent。

人類要做的是在過程中做出必要判斷，並在最後驗證實際運作。為了讓這件事更順暢，要建立一套機制，讓規格、變更與驗證結果都能確實回到你手上。讓我們一步一步來，從連線方式、任務交接到停止條件都建起來。

保持 Claude 開啟的同時把工作指派給 Codex

有一種方法可以把需求從 Claude Code 傳給 Codex，而不需要把之前的回答貼到另一個 AI 裡。那就是 OpenAI 發布的「Codex plugin for Claude Code」。

根據官方文件，它支援以下用途：

• 檢查目前變更的 Review

• 委派調查或修復工作

• 對話交接

本文將依照 2026 年 10 月 16 日驗證過的官方文件，介紹從本機環境的 Claude Code 使用它的流程。

先決條件

• 可使用 Claude Code 的環境

• Git

• Node.js（官方要求：18.18 以上）

• 已通過 Codex 驗證的 ChatGPT 帳號，或 OpenAI API 金鑰

這個外掛會呼叫你本機的 Codex。連線並不表示 Codex 會消耗 Claude 的使用額度；Codex 的使用量會扣 Codex 自己的額度。

另外，雖然這個設定是處理本機檔案，但 AI 推論不一定完全在你的電腦內完成。請先用一個不含機密資訊的練習資料夾開始。

安裝外掛

在 Claude Code 的輸入框中，由上到下逐一執行以下指令。這些是在 Claude Code 內新增外掛的操作，不是要貼到一般終端機的指令。

1/plugin marketplace add openai/codex-plugin-cc
2/plugin install codex@openai-codex
3/reload-plugins
4/codex:setup

最後的 /codex:setup 可以讓你檢查 Codex 的安裝與驗證狀態。如果找不到 Codex 但有 npm，就會出現安裝指引；請確認內容後照著做。

如果尚未驗證，請在終端機執行 codex login 並依照提示操作。

在 Windows 上，請確保執行 Claude 的環境與安裝 Codex 的環境不是分開的。不要只因為顯示「找不到」就不斷重複安裝。

先試試 Review

先從不會改寫程式碼的 review 開始。在一個用 Git 管理的練習專案中準備一個小變更，然後執行：

1/codex:review --background

• 查看進度：/codex:status

• 查看完成的結果：/codex:result

當有多個請求同時進行時，請指定畫面上顯示的 Job ID，以免搞混結果。

Amazon 的公開範例對任務分工很有幫助

若要參考角色分工，可以看看 Amazon 雲端事業部 AWS 發布的開發範例。在 GitHub 的 aws-samples 上有兩個相關的 repository：

• sample-codex-agent-team（給 Codex 用）

• sample-claude-code-agent-team（給 Claude Code 用）

Codex 版本有六種角色：

決定怎麼做註冊畫面，跟思考擴展性、維護成本等，是完全不同的工作。把功能實作與營運諮詢分開，能讓對特定 agent 的提問更具體。

輕量級 review 不是用來隨便處理高風險變更的。它是一種分工方式，避免每次遇到文件編輯或機械式替換這類低風險任務時，都要跑一遍沉重的檢查。

兩個範例的任務交接方式不同：

• Claude Code 版本：Agent 從共享的任務清單取得任務（使用實驗性的 agent teams，需額外設定）

• Codex 版本：依照劃分好責任檔案的工作計畫進行

這是兩個獨立的範例。就算兩個都安裝了，它們也不會自動合併成一個團隊。

另外，Codex 版本包含了假設尚未發布之連線設定的模型指定。範例本身也說明這些無法直接在所有人的帳號上使用。與其整個複製到公司的重要專案裡，不如只採用其中的角色分工邏輯，再調整成你可用環境的樣貌。

本文會從一個小型架構開始：由 Claude Code 擔任介面，把有限的實作與檢查任務交給 Codex。

注意：這是參考公開範例的獨特操作示例。它不是保證 AWS 整合了 Claude 與 Codex 的產品，也不是實測行為的報告。

動手之前先統一「可儲存」的定義

當你無法詳細描述想做的東西時，不要馬上開始實作。先讓 Claude 整理確認事項。你不需要懂所有技術名詞；只要把它們轉換成你能回答的問題就好。

我想做一個個人用的案件管理 App。請先整理必要的規格，然後一次問我一個需要決定的問題。對於技術選擇，請簡短說明對使用者的影響以及推薦的理由。在我同意之前不要開始實作。

舉例來說，關於儲存：只要紀錄在同一個瀏覽器裡能保留就好，還是你希望手機和電腦之間可以共享？這兩者需要完全不同的機制。默默幫你選一種，之後只會造成重工。

在這個練習中，我們縮小範圍：

• 包含範圍：在同一台電腦／瀏覽器上使用，重新載入後紀錄仍保留

• 不包含範圍：多裝置同步、登入、對外發布、客戶真實資料

用操作結果來定義完成標準，而不是「好不好用」：

• 可以登錄案件

• 依截止日期排序

• 可以變更狀態

• 空白登錄時會顯示原因

• 重新載入後內容仍保留

把規格與任務需求存成檔案

把決定的內容存到 docs/spec.md，作為所有人都參考的規格書。這裡的檔名只是範例；它們不會自動分發給所有 AI，所以每次提問時都要指定「讀這個」。

把決定的規格、完成標準和不包含的功能存到 docs/spec.md。不要把未決定的事項寫成已確認。把需要暫停實作的項目，與先用暫時設定繼續進行的項目分開。

接著，把給實作者的任務需求整理到 docs/tasks.md。只寫任務名稱是不夠的。要包含閱讀材料、可編輯的檔案、不可編輯的部分、驗證方法以及預期產出。

把規格拆解成可實作的單位。在 docs/tasks.md 中寫下指派的檔案、前置任務和驗證方法。事先決定 UI 與儲存邏輯之間的共用項目。不要規劃讓兩個 agent 同時編輯同一個檔案。

讓兩個 AI 看同一份規格

持續性的指示可以寫在給 Claude 的 CLAUDE.md 和給 Codex 的 AGENTS.md 裡。這些是有文件說明的機制。不過，不要以為一份檔案對另一方也會有相同作用。請讓兩者都參照同一個規格檔。

指示要保持簡短：

• 規格檔的位置

• 不要在需求之外做任何變更

複製規格會有其中一邊過期的風險。這樣做可以避免這個問題。

平行作業前先分隔工作區

多個 AI 一起工作看起來比較快，但如果用不同方針改寫同一個檔案，只會製造出人類的善後工作。

初次平行作業時，把「UI 建立者」和「測試規劃者」配成一組。在格式定案前就把 UI 和儲存分開實作，會增加格式不一致的問題。

用 Git Worktree 分隔資料夾

這時 Git worktree 就很好用。它是 Git 的官方功能，可以為同一個專案建立不同的工作資料夾，各自有不同的變更。

建立之前，請確保規格和基礎程式碼已經 commit 到 Git。未 commit 的草稿檔案可能不會帶到新位置。也要確認分支名稱和目標資料夾都還沒被使用。

1git worktree add -b feature/ui ../case-app-ui
2git worktree add -b feature/storage ../case-app-storage
3git worktree list

三個注意事項：

1. 建立資料夾不會改變 AI 的工作區。 要在每個目錄開啟獨立的 session，並在開始前確認位置與分支。

1. 外掛使用的是呼叫者的環境。 連接 Claude/Codex 不會自動隔離。初期請遵守「一個位置一個編輯器」的原則。

1. Worktree 主要隔離的是檔案。 共用的資料庫或 port 會造成衝突。請分開測試用的儲存空間/port，或是排定啟動順序。

限制 Codex 的並行任務數

若要在 Codex 中增加 sub-agent，請限制並行執行緒數量。Sub-agent 會從父 AI 接收有限的任務。目前的設定在 .codex/config.toml：

1[agents]
2enabled = true
3max_concurrent_threads_per_session = 2

• 不要重複寫入相同的項目

• 只在信任的專案中使用（專案設定只會在受信任的情境中載入）

• 此限制適用於「該 session 中不含主 agent 的並行執行緒」，而不是跨 Claude/session 的總數。

AWS 範例中的 14 個執行緒只是他們的選擇，不是強制規定。他們的 max_threads 是舊版的別名；請使用現在的名稱。

不要每次都從頭向實作者解釋

在 Codex 中，可以透過 .codex/agents 裡的 TOML 檔案定義自訂 agent。建立 task-builder.toml 並寫入必要條件：

1name = "task-builder"
2description = "Implement only assigned scope from confirmed specs"
3developer_instructions = """
4Read docs/spec.md and docs/tasks.md first.
5Implement only assigned scope; stop and report if spec changes needed.
6Do not revert other agents' changes, read secrets, or publish externally.
7Return changed files, executed tests, results, and unconfirmed items.
8"""

避免在這裡固定模型名稱。預設會繼承父層設定。公開範例中的模型在你的合約上不一定能用；硬寫入無法使用的名稱，會在讀到角色說明之前就導致啟動失敗。

放好檔案後，在新的 Codex session 中確認是否有被識別，並委派一個小任務。如果是從 Claude 提出請求，請指定在 Codex 中使用 task-builder。

請 Codex 把 docs/tasks.md 中只有儲存邏輯的部分委派給 task-builder。開始前先確認 agent 是否被識別以及實際的資料夾。如果無法使用，請回報，不要默默切換做法。

注意：寫「不要修改」跟移除寫入權限是兩回事。官方文件指出 Codex 的子 agent 會繼承父層的權限（sandbox 設定）。角色名稱叫「reviewer」並不會自動建立安全的唯讀環境。

如果修復不斷重覆就換 Agent

如果 AI 說「找到原因了」，但同樣的操作又失敗，不要急著做下一次修復，而是記錄哪些改了、哪些沒改。這樣交接會更容易。

官方外掛有個 rescue 入口，用來把調查／修復委派給 Codex。雖然名字這樣取，但它適用於限定範圍的任務，不只是 bug。

明確標示調查為唯讀

如果只是分析原因，要清楚說明不做寫入。內部程序預設 rescue 是可寫入的，除非你特別指定。請把調查與修復分開。

1/codex:rescue --fresh Investigate why registration disappears on reload, read-only. Compare docs/spec.md and code. Return reproduction steps, evidence-based causes, needed checks. Do not modify files.

--fresh 會啟動新請求；--resume 會接續上一個（省略時會詢問）。接續時請指定權限。如果要進入修復階段，請定義範圍。

1/codex:rescue --resume Fix only storage logic with minimal changes based on confirmed cause. Do not change UI/specs. Show failing test before and result after.

用 Transfer 轉移整段對話

• 只傳遞任務 → rescue

• 把對話移到 Codex → transfer

1/codex:transfer

官方文件說明：它會建立一個 Codex 執行緒來延續目前的 Claude Code 對話，並顯示接續指令。如果不支援，請更新 Codex。

轉移對話 ≠ 轉移電腦狀態。未儲存的變更、驗證狀態、正在執行的應用程式都不會跟著過去。請在目的地確認檔案與狀態。

「完成了」之後用另一個 AI 驗證

實作者自己測試很有幫助，但如果他們誤解了規格，通過的測試就不會符合你想要的行為。

給檢查者的是經過人工驗證的規格與實際變更，而不是實作者的說明。不要分享「完美修好了」的評價；讓他們獨立檢查是否符合規格。

獨立比對 docs/spec.md 與實際變更。用證據找出未達成的完成標準。不要假設實作者的自我評估是正確的。把可重現的問題、潛在疑慮和未驗證的項目分開。現在不要修復。

把相反的角色配對：

• Claude 實作 → 加入 Codex 的一般 review 作為獨立檢查

• Codex 實作 → 請 Claude 檢查，也可以選擇加入新的 Codex review

一般 Review 與對抗式 Review

用 /codex:review 呼叫一般 review。將分支與 main 比對：

1/codex:review --base main

如果沒有 main，就用實際的基底分支。Review 期間不要動到變更。

注意：一般 review 不接受像「只檢查儲存部分」這樣的自由文字焦點指示。官方規格禁止優先順序指令。若要挑戰設計假設或特定風險，請使用 adversarial-review。

1/codex:adversarial-review --background Check if save failures display as success, if editing from two tabs loses records, verify current design assumptions.

這不是語氣嚴厲的意思；它會挑戰你所選的做法與假設。兩種 review 都是找出問題，不會修改程式碼。確認結果後，再另外委派修復工作。

把發現整理出來，附上適用的完成標準、使用者影響與驗證方法。需要變更規格的問題不要自動修復；要把選項與差異呈現給人類。

初期先跳過 Review Gate

自動化選項：「Review gate」會在 Claude 每次完成回應時插入 Codex review。用 /codex:setup --enable-review-gate 啟用。

警告：官方文件提醒，長時間的修復循環可能會在 Claude 與 Codex 之間快速消耗額度。

先用手動 review 來理解發現的內容。離開時請停用。用 /codex:setup --disable-review-gate 停止，並檢查待處理的請求。

把成功的請求保留下來給下次任務用

與其反覆貼上長長的指示，不如把成功的工作流程存下來。Skills 可以讓你把任務流程存在檔案中重複使用。

Anthropic 文件說明：把流程放在 .claude/skills。建立 team-brief 資料夾，裡面放一個 SKILL.md，寫入交接前的檢查項目。

1---
2name: team-brief
3description: Organize scope and verification from specs
4disable-model-invocation: true
5---
6Read docs/spec.md and docs/tasks.md, targeting only current changes.
7Organize scope, forbidden changes, prerequisites, completion criteria, verification.
8Create request texts for agents, leaving undecided items for human confirmation.
9Do not change code, publish externally, or launch Codex in this procedure.

在 Claude Code 中呼叫：

1/team-brief Want to add sorting by deadline

這是自訂指令，不是標準功能。disable-model-invocation: true 可確保由人類決定觸發時機。Claude 不會自動啟動。這些流程不會強迫 AI 啟動或檢查；先試試「只重複使用準備工作」。

大型任務的 Dynamic Workflows

對於更大範圍的工作，Claude Code 提供了 Dynamic workflows（2026 年 5 月宣布），可以用腳本控制多個 agent。付費方案/API 可用。

• 一般聊天：Claude 每次都自己決定下一個任務

• Dynamic workflows：用腳本處理分支與結果收集，可重複執行

範例：分別在多個畫面上調查儲存失敗、輸入檢查、版面破損，然後交叉比對發現。不要為了小 App 啟動龐大的 agent；當你要大範圍套用相同檢查時再考慮。

建立一個 Dynamic workflow，調查分割的畫面，並用獨立的 agent 驗證發現。先提出目標、agent 數量與退出條件。不要改程式碼；批准後再執行小範圍。

小提示：

• 在 Pro 方案中透過 /config 啟用

• 用 /workflows 監控進度與用量，隨時可停止

• 在 /config 中選擇規模（small 等）；官方文件稱這些是估計值，不是嚴格限制。不要假設 agent 數量有保障。

這是執行 Claude 端的 agent。Codex 不會自動加入。先用在 Claude 內部的調查與驗證；把委派給 Codex 當作另一個階段。

從頭到尾跑一次案件管理 App

把各元件串成一個完整的 App。以下是說明用的開發範例，不是完成的體驗報告；請在你自己的環境中驗證。

建置目標

• 欄位：案件名稱、截止日期、狀態、備註

• 狀態：未開始 / 進行中 / 已完成

• 依案件名稱搜尋

• 檢視未完成案件並依截止日期排序

初始請求

交給 Claude。目標是新的練習資料夾，不是現有的重要專案。

在練習資料夾中建置個人案件管理 App。先確認環境與規格。包含名稱、截止日期、狀態、備註的登錄/編輯/搜尋/排序/持久化。排除登入、同步、對外發布。

候選儲存方式：localStorage。沒有多裝置同步或備份；清除瀏覽器資料就會刪除紀錄。不要放有價值的正式資料。

建立基礎、定義共用部分

由單一 agent 建立基礎。確認 App 能啟動、空白畫面能顯示。如果需要分隔工作區，先把規格與基礎 commit 到 Git。

• 給 UI agent：顯示欄位、操作對應

• 給 Storage agent：紀錄格式、讀取/新增/更新方法、失敗處理

不要讓任一方自己發明欄位名稱。如果狀態欄位是 status，兩邊都要用它。不要為了方便把其中一邊改成 state；共用部分的變更要送回 Claude 調整。

向 Codex 提出實作請求

指定可寫入的位置，以及必須輸出的證據。

1/codex:rescue --fresh Read docs/spec.md and docs/tasks.md. Implement only assigned storage logic and tests. Return changed files, commands, test results, unconfirmed items. Stop and report if spec changes or other agent edits needed.

同時，Claude 不要從旁邊修改同一批檔案。專注在完成檢查與測試資料準備；等結果回來再決定下一步。

準備驗證資料

• 昨天截止，「未開始」

• 今天截止，「進行中」

• 下週截止，「已完成」

• 多個相同截止日期的案件

• 很長的案件名稱

這樣才能具體檢查排序與顯示。

把詳細規則寫進規格：

• 排序：截止日期相同時依登錄順序

• 空白欄位：名稱/截止日期必填；備註選填。顯示缺少的欄位。

• 日期：定義日期切換的假設。如果時區/時間處理會造成日期偏移，App 就算外觀漂亮也不能用。

事先定義規則，可以避免實作後的檢查標準不一致。

整合與測試

實作準備好後，讓 Claude 讀取變更清單與測試結果，確認整合。如果使用 worktree，把變更集中到單一的驗證分支。整合後要重新跑個別通過的測試。

用 Playwright 做 UI 自動化。目前的指南提供給 AI agent 用的 CLI/Skills；MCP 不是唯一的方法。

把「AI 瀏覽器控制機制」和「可重複的測試」分開。用 Playwright Test 來做可重複執行的登錄到重新載入流程。

建立 Playwright Tests 驗證登錄、拒絕空白、搜尋、狀態變更、截止日期排序、持久化。分開啟動設定與測試資料。不要為了讓測試通過而改變 App 行為或完成標準。

新練習專案的設定：

1npm init playwright@latest

如果已經安裝，新增前請先確認現有的啟動與測試設定。

確保瀏覽器已安裝、設定好 App 啟動方式，然後執行：

1npx playwright test
2npx playwright show-report

關鍵：不要把找不到測試或全部跳過當成「通過」。

失敗時，隔離原因：是儲存的 bug，還是測試在找不存在的按鈕？不要為了讓結果變綠燈就刪掉測試；要對照原始規格決定修復目標。

最終的人工驗證

手動檢查視覺效果。有隱藏的文字嗎？快到期的案件容易找到嗎？測試報告全過不代表 UX 沒問題。

從 Claude 拿到四項東西，而不是長長的 log：

• 啟動方式

• 已驗證的行為

• 殘留的限制

• 下一步修復候選

自己登錄一筆資料，重新載入，確認是否保留。然後標記為完成。

什麼時候該停止不斷修復

隨著團隊規模擴大，要定義結束點。我們是在同一個 bug 上打轉，還是在依序解決問題？狀態不清楚會妨礙後續指示。

設定停止條件

把「每個問題最多修兩次」當作準則。這不是官方建議，而是卡住時把判斷權交還人類的操作規則。

如果同一個 bug 嘗試兩次仍未修復，就停止進一步變更。整理試過的做法、做過的變更、殘留的症狀與需要的決定。不要擴散到無關的功能。

光靠指示不能保證會停下來。要監控用量，用 /codex:cancel 取消不必要的背景請求。確認 agent 真的停了。

分開追蹤成本

用 ChatGPT 驗證的 Codex 額度與 API 金鑰計價不同。平行運作的 agent 會消耗推論與工具資源。

不要把小小的文字修改丟給兩個 AI 或大型 review 處理。

分類：

• 一個人就能完成的任務

• 需要第二個視角的任務

• 可獨立平行處理的任務

這有助於決定投入多少精力與額度分配。

留意過時的模型指定

舊的模型指定會導致失敗。OpenAI 更新：ChatGPT 驗證的 Codex 已在 2026 年 10 月 15 日（JST）停止 GPT-5.5。API 金鑰驗證不受影響。

把舊的規格與角色檔案更新成目前可用的模型。要確認可選的模型與接受的 reasoning 設定，不只是改名。

檢查權限與 Hooks

Claude 的權限不一定會傳遞給 Codex。兩邊的執行權限都要確認。不要用正式環境的憑證練習。刪除、對外發布、計費相關操作都需要單獨核准。

使用前，請先檢查公開範例中的 hooks。Hooks 會在設定的時間自動執行；要看清楚實際跑了什麼，而不只是那些看似方便的附加功能。

衡量「快速完成」

不要只比較生成時間。

• 你重新說明的次數

• 整合／修復所花的時間

• 剩餘缺陷與完成標準的差距

把這些因素一併納入考量，才能判斷下次是否還能用同樣的分工方式。

從每週的小型工具開始

非工程師最容易在「自己能判斷對錯」的地方取得成果。

• 詢問追蹤

• 訂單截止日檢查

• 排序規則一致的 CSV 格式化

從描述得出來的使用情境開始。

想優先處理快到期項目？移除已完成項目？缺少輸入時發出提醒？日常需求就是 AI 的完成標準。

不需要先精通寫程式；根據條件做出原型，邊用邊修。注意：客戶資料系統或對外服務不能只靠原型成功，還需要專業驗證。

初期團隊這樣就夠了：

1. Claude 整理規格

1. Codex 執行單一任務

1. 用不同角度驗證回傳結果

把有用的提示詞和驗證方法存下來，做下一個應用時就不用全部重新說明。

感謝你的閱讀。

LINE Open Chat「Niku 的 AI 速度戰略」免費提供 8 項組合包。

• Codex／Claude Code 入門指南

• 複製貼上操作說明

• 快速參考表

• 50 個迷你應用

• 50 組圖片提示詞

• yomiyasu 安裝教學

• 標題產生器

• X 變現流程與金額

在這裡領取 👇 https://x.gd/VtPmw