Claude Code 與 Codex 在 Orca 共用一位協調者

截至 2026 年 10 月 16 日，Orca 讓一個協調者把工作派給多個程式代理，分開追蹤任務與每次執行，直到交付驗收。Stably 的官方文件把 Run、Task、Dispatch 分成不同紀錄。開出兩個代理只是起點；兩份報告都能對上程式碼，才算完成這輪審查。

多開視窗很容易。麻煩往往發生在第二個代理卡住，而第一個已經回報完成的時候：誰回答問題、誰檢查報告、失敗後要沿用哪張任務？Orca 的編排功能值得花時間理解的，就是這段工作。

一、Orca 把代理放進同一個開發工作台

Orca 是 Agent Development Environment（ADE），也就是代理開發環境。它整合 Git worktree、終端機、瀏覽器與變更審查，讓 Claude Code、Codex 等程式代理在同一個介面裡工作。Worktree 是同一個 Git 儲存庫衍生的獨立工作目錄，各自保留檔案狀態。

依 Stably 官方專案資料，儲存庫建立於 2026 年 3 月 17 日，採 MIT 授權。10 月 16 日查核時有 93,954 顆星；這是當日快照，不是使用者數。桌面版支援 macOS、Windows 與 Linux。

Orca 本身免費開源，模型用量仍走各代理原本的訂閱或 API 帳單。遠端機器也由使用者自行管理。省下工作台授權費，不會讓同時執行的模型免費。

二、多開以後，環境與驗收開始搶時間

新 worktree 只拿到版本控制裡的內容，常缺少 .env 或已安裝的依賴。接著是監看問題：哪個代理在執行，哪個在等待輸入？等程式都寫出來，開發者又得讀完數份差異，把意見送回正確的地方。

Orca 分別用工作目錄設定、狀態通知與逐行批註處理這些事，也支援不同代理之間的交接。找視窗、搬內容花的時間會少一些。程式是否正確，仍得由驗收證據回答。

我會把導入門檻放在可分開驗收的工作上。只有一個會話、持續需要人判斷下一步的任務，通常沒有必要再加協調層。

三、一個假設工作日，串起整套操作

以下是示範情境，不是實測成果：一名開發者維護採用 Stripe 訂閱的 SaaS。上午 9 點，排程先檢查工作目錄，有未提交變更才啟動晨檢。10 點，開發者發現重複訂閱，讓三個代理在獨立 worktree 比較修法。

中午把冗長會話交給另一個代理。下午 2 點用 Design Mode 調整定價卡片；4 點讓協調者帶兩個代理審查結帳；6 點把逐行批註送回修改。需要隔夜執行時，工作則留在持續開機的遠端主機。

這個情境沒有保證第一次就改對，也沒有估算節省幾小時。情境裡每項操作，都有不同的執行位置與驗收條件。

四、第一輪只完成一個小任務

依 2026 年 10 月查核的 Orca 安裝文件，macOS 可用官方 Homebrew cask：

brew install --cask stablyai/orca/orca

Windows、Linux 與不使用 Homebrew 的讀者，可從官方下載頁選擇安裝包。這是讀者的安裝選項，以下教學不要求先開編排。

在 Orca 加入本機儲存庫，建立一個有明確名稱的 workspace，再選擇已在執行主機登入的代理。先派一個能核對結果的小任務，例如修正一段顯示文字。把代理與終端機分屏，完成後開啟差異，確認變更範圍，再提交或建立 PR。

左側管理專案與 workspace，中間是可分割的標籤頁。檔案與變更檢視、底部額度資訊都能協助判斷下一步。第一輪先確認自己看得懂代理改了什麼，也知道怎麼回復。

五、新 worktree 先分清複製與共用

Orca 的 Worktree Shared Paths 在 macOS 可用時採 APFS clone-copy，否則使用符號連結。worktree.sharedDirectories 以連結共用既有的忽略目錄；.worktreeinclude 則複製忽略內容，讓各 worktree 保有自己的副本。

.worktreeinclude 目前接受實際路徑，不能把萬用字元當成已支援的規則。已追蹤、遺失或未被 Git 忽略的路徑不會照這個機制複製。複製密鑰設定也表示新工作目錄會取得那些權限，應只帶入該任務需要的設定。

規則檔則交給代理自身載入。Codex 使用 AGENTS.md；Claude Code 現在也支援這個精確檔名。Anthropic 的記憶與指令文件載明，直接讀取須為 v2.1.277 以上，且有會話例外。

Claude Code 預設只有在工作目錄及上層沒有適用的 CLAUDE.md 或 CLAUDE.local.md 時，才選擇 AGENTS.md。若要同時載入，可在 /config 的 Project instructions 設定。小寫單數 agent.md 不能視為同一個檔名。

規則保留技術棧、禁止操作、完成條件即可。要讓新 worktree 自動取得共同規則，先把規則檔提交進 Git。寫上不得碰正式環境是必要的任務限制，實際權限仍由執行環境與代理的權限設定決定。

六、高代價修正才值得開三份比較

重複訂閱適合拿來說明平行比較。Stripe 的 webhook 文件說明，正式環境事件會自動重試最長三天，同一事件也可能多次送達。接收端需要辨識已處理的事件 ID。這支持檢查冪等性，但不能直接斷定每次重複訂閱都由 webhook 重送造成。

從相同提交建立三個 worktree，交給不同代理同一份重現步驟與驗收條件。分別比較事件去重、資料寫入及錯誤路徑，選出證據最完整的修法。代理意見一致，只能增加一個檢查線索，不能取代測試。

成本也會疊加。三個代理各自消耗模型用量，實際 token 數受上下文與重試影響，不能一律寫成精確三倍費用。我的取捨是把這筆成本留給支付、權限等改錯代價大的問題；單純改文案，一份結果就足夠驗收。

其他 worktree 的好改動不會自動合併。先保留有用的差異或提交，再清理不要的 workspace，避免把尚未整合的成果一起刪掉。

七、通知提醒回來，終端機提供證據

Orca 能以通知與 workspace 狀態提示代理需要注意。通知適合決定何時回到工作台，完成與否仍要讀結果。代理暫時閒置，可能代表等待確認。

macOS 可用 Cmd+D 向右分屏、Cmd+Shift+D 向下分屏。讓一邊跑代理，另一邊保留測試輸出。複製日誌窗格的 ID 給代理，它便能針對那個窗格檢查輸出；不必每次手動搬整段錯誤。常用測試也可存成快捷命令。

八、分支探索與交接保留不同責任

Orca 的衍生會話適合試另一個方案：開出另一個工作區，把整理過的脈絡交給新代理。原會話保留原本進度，兩條路可以各自判斷。

Hand Off to Another Agent 則讓新會話接續目前工作。聚焦交接只帶當前進度，需要時再讀歷史；完整記錄會用掉更多上下文。交接草稿應包含未完成事項、已跑的檢查與禁止操作，也要確認確實出現在新會話裡。

跨代理交接仍會產生新會話用量。歷史搜尋能協助找回過去處理方式，但交接完成後是否持續監督，要在任務裡說清楚。需要原協調者等到驗收，就使用受監督編排。

九、Design Mode 把元素脈絡送進任務

Orca 的內建 Chromium 瀏覽器有 Design Mode。點選元素後，代理可收到 DOM、計算後的 CSS 與元素截圖；只有開發環境提供對應資訊時，才會附上原始碼檔案與行號。

以 Free、Pro、Team 三張定價卡片為例，選取元素後送出：

讓三張定價卡片底部按鈕對齊，保留按鈕現有的點擊行為，電腦和手機寬度都要檢查。

改完要重新檢查同一個元素，再實際點擊按鈕。任意線上網頁不會自動對應到本機原始碼。若交給另一個代理操作瀏覽器，任務也要列出測試帳號、允許操作及成功條件。

十、批註連到程式行，關卡連到決定

Orca 的差異檢視可在程式行旁加批註，再用 Send to agent 一次送回。比起要求重新檢查，具體的觸發條件比較容易驗收：

請求逾時後這裡恢復了按鈕，但前一個請求可能已經成功。先查有沒有已存在的訂閱，再決定是否允許重新提交。

AI 歸屬標記可協助辨識代理寫入的程式行；人手修改後，歸屬會跟著變動。這是 Orca 本機中繼資料，沒有自動寫入 Git，需要留存時另行匯出。標記指出產生來源，沒有證明正確性。

Orca 的 Gate 是附在任務上的決策問題。它能讓任務等待一個有紀錄的選擇，但協調者本身也能呼叫 gate-resolve。只在提示裡寫只能由人批准，不會把關卡變成強制的人類授權機制。

若資料庫遷移必須由人執行，就把真正的執行憑證或部署核准留在人可控制的環境。關卡負責記錄決定，權限系統負責限制誰能動手。這兩件事應各自驗證。

十一、Run 不派工，協調者才派工

Orca 的 Run 是持續保存的協作命名空間與收件匣。Task 記錄要完成的工作；Dispatch 記錄其中一次執行。同一張 Task 可以因重試產生不同 Dispatch，完成回報必須帶目前的 taskId 與 dispatchId，避免舊執行的遲到訊息被當成新結果。

依官方編排與復原文件，Run 本身不會排程或選擇工作位置。協調者建立 Task 後，用 worker-start 明確指定代理與 worktree。派發成功只表示派工流程到了某個階段，能否證明模型開始工作，要看執行回執。

啟動失敗的停止條件也有範圍：同一 Task 連續三次 worker-start 失敗會觸發中止，計數跨越 --retry-of。工作代理自行回報 failed 不計入這個啟動失敗計數。不能把它簡化成任何任務失敗三次都會停。

協調者收到的是 Delivery 訊息批次，可能同時有 A 的報告與 B 的問題。整批處理完才確認收件；未確認的批次會重播。只回答最後一個問題就確認整批，很容易漏掉已經交付的成果。

我會優先檢查 Task 與 Dispatch 能否分開追蹤。修復啟動問題時，可以保留原任務與失敗脈絡，無須假裝重新開一件毫不相干的工作。重試要依失敗證據進行，遇到中止條件就查原因，不能另開任務繞過。

十二、兩個代理審查結帳，協調者負責驗收

Orca 的編排需先啟用；依目前文件，可在 Settings → Experimental 開啟。初次使用也可能出現 Enable orchestration 提示。選一個代理當協調者，交給它這份完整任務：

請用 Orca 編排做一輪受監督的平行審查。你是協調者，負責回答另外兩個代理的提問、核對證據，等兩項任務都有明確結果再收尾。

目標：本專案的訂閱結帳流程。

A：只讀檢查支付回呼處理、訂閱狀態寫入資料庫與失敗重試，結果寫進 api-review.md。
B：只讀檢查定價頁、結帳跳轉與支付失敗後的頁面提示，結果寫進 ui-review.md。

兩人都不改程式碼、不提交、不碰正式環境資料、不對外發訊息。只允許寫入各自指定的審查報告。每條發現寫清楚檔案、重現步驟、證據與嚴重程度；沒發現問題，也要寫明檢查範圍。

兩份報告都收到後，你回到程式碼核對關鍵發現，再彙整確認的問題、排除的問題、仍缺的證據，以及建議優先修正的問題。

這裡的只讀限制指產品程式與資料；兩個指定報告是明確允許的輸出。工作代理看不到協調者全部對話，因此每份派工說明仍須自足，不能只寫照剛才討論。

兩個代理可以共用目前 checkout，前提是都遵守程式唯讀與不同報告路徑。協調者要確認檔案存在，抽查最重要的發現能否重現，再接收完成回報。兩份空白或泛泛而談的報告，不算兩項工作完成。

若增加 C 來交叉複核，可設定 C 等待 A、B 完成。依賴關係只讓 Task 達到可派發狀態，是否啟動仍由協調者決定。修改型任務則給各自獨立 worktree，事前指定由誰整合。

執行中縮小範圍，可以傳訊給工作代理。訊息通常在自然工作節點被讀取，不等於立刻中斷。重大變更等到對方確認後再往下走。工作完成後先保留可查輸出，再用正常釋放流程關閉受管理的終端機。

十三、遠端主機擁有工作，手機只是連回去

Orca 的本機 workspace 由本機執行。SSH workspace 把執行環境放到遠端，桌面端仍負責部分操作介面。Remote Orca Server 則由伺服器擁有專案、worktree、終端機與代理，筆電或手機連過去操作。Cloud VM 是另一種實驗性工作位置，不應與持續開機的自管伺服器混為一談。

Remote Orca Server 仍有 beta／實驗性限制。要讓筆電斷線後工作繼續，先在主機建立可持續執行的環境，再完成四個步驟。

1. 以 Tailscale 或自管私有路由連通伺服器、筆電與手機。
2. 在伺服器安裝並登入所需代理；筆電上的登入不會自動搬過去。
3. 桌面主機在 Remote Orca Servers 設定開啟分享並產生配對連結；無桌面的 Linux 使用 orca-ide serve，配對地址填可連線的私有主機位址。
4. 客戶端用 Add Server 加入連結，手機則依官方手機配對流程連線。

Linux 的命令是 orca-ide，避免與 GNOME 螢幕報讀工具的 orca 衝突。配對連結會授予執行環境存取權，只交給要授權的裝置；伺服器可撤銷個別客戶端權限。

目前新專案的預設位置在 Advanced → Default host for new projects。單純加入伺服器，不會強制把所有專案移過去。瀏覽器若也要在主機端執行，確認使用 Server (streamed)；留在筆電上的瀏覽器流程，仍受筆電狀態影響。

手機可查看狀態與終端機，回覆提問，也能執行會改變工作狀態的操作。遠端主機關閉，手機不會替它執行代理。複雜合併與長篇驗收，我仍會留在大螢幕上處理。

十四、晨檢先檢查變更，再啟動模型

Orca Automations 可在排程前執行 shell precheck。檢查以非零狀態結束，該次記為跳過，不啟動模型任務。檢查本身與主機仍有運算成本，省下的是不必要的模型執行。

幫我建立定時任務：每個工作日台北時間早上 09:00，時區明確設為 Asia/Taipei，在目前工作區先檢查是否有未提交變更，沒有就跳過。

有變更才只讀檢查，彙整卡住的地方與需要我決定的事。不改檔案、不提交、不對外發訊息。先建立為停用狀態，我手動執行確認沒問題後，再由我啟用。

這個任務要看未提交檔案，因此必須鎖定既有工作區，CLI 對應 --workspace。若改成每次從儲存庫建立乾淨副本，檢查對象就變了。時區使用 IANA 名稱，避免主機時區替你決定早上幾點。

Automations 的 Host 欄位顯示排程存在哪裡，建立時由 Create on 選擇。筆電睡眠時不能期待本機排程準時執行；持續服務需安排在持續開機的主機。每個任務可有自己的模型設定，但額外模型與推理參數需要新會話，不能一面要求重用會話、一面假定新參數會套用。

晨檢報告若要用 Artifacts 分享到公開連結，先人工檢查內容。對外發布權限預設關閉，必須由桌面設定開啟；這不是本輪只讀任務自帶的授權。

十五、版本與帳單都不會替你固定

Orca 的 v1.4.227 發布說明日期是 2026 年 10 月 16 日。這版把原生聊天權限分到每個 Claude／Codex chat，預設值在 Settings → Chat → Behavior。既有聊天保留原模式，換模型也不再重設。

原生 Codex chat 要求 Codex 0.136.0 以上；這項最低版本不能套用到所有終端機使用方式。新原生聊天的權限預設位於 Settings → Chat → Behavior；編排仍須在 Settings → Experimental 啟用。

Remote Server、手機與其他實驗功能仍要個別看版本狀態。Orca 是 Electron 應用程式，加上瀏覽器與數個代理會占用記憶體，但沒有一致硬體與工作負載的測試，不能拿單次占用數字當通用門檻。

團隊真正要估算的成本是模型用量、主機與驗收時間。獨立 worktree 減少互相覆寫檔案的機會，沒有消除合併衝突，也沒有保證多人份的代理輸出只花一人份審查時間。

十六、最短可靠流程由驗收方式決定

Orca 的工作流程可以依任務性質縮到必要程度。需求還在變、每一步都需要人判斷時，一個會話比較容易追蹤。另一個方案需要獨立試驗，再開衍生會話。

拆開後若每份結果仍得完整重讀，平行產生的輸出可能只是把等待換成審查。沒有可查證的通用效率倍數，值得追蹤的是完成同一驗收條件的總成本。

十七、三個導入層級各有過關條件

Orca 的第一層只使用一個會話。完成加入儲存庫、建立 worktree、查看差異與提交，並確認環境檔及規則載入正確。能解釋每項變更，就是這一層的成果。

第二層再加入平行比較、交接與 Design Mode，第一次編排採用兩個代理的只讀審查。兩份報告可核對，協調者確實做過複核，再進下一層。

第三層才讓編排修改程式、安排定期檢查，或部署 Remote Orca Server。事前指定整合者，保留真正的部署權限邊界。升級 Orca 後，依新版內建說明檢查命令與權限，再沿用原本流程。

FAQ

Orca ADE 教學該從哪一步開始？

Orca ADE 適合先完成一個單代理的小任務，再增加編排。第一輪不需要 Run 或 Dispatch；看得懂差異、能核對結果後，再進入兩個代理的只讀審查。

Orca 可以離線代替 Claude Code 或 Codex 的模型嗎？

Orca 本身不附帶可離線取代 Claude Code 或 Codex 的模型。代理使用自己的模型連線與認證；Orca 的開源授權不會免除那些服務的使用條件與費用。

Orca 的手機版會在手機執行代理嗎？

Orca 手機版操作配對電腦或伺服器上的環境，持續執行依賴主機。主機關機後，手機不能接手原本的代理工作；遠端持續執行需由仍在運作的主機承擔。

Orca 更新會改掉既有聊天的權限嗎？

Orca v1.4.227 說明既有原生聊天保留原本的權限模式。新聊天的預設設定與既有聊天不同，團隊升級時應分別核對，不能只看全域預設值。

權威引用

• Stably — Orca 官方專案與授權
• Stably — 安裝文件
• Stably — Worktree 設定
• Anthropic — Claude Code 記憶與指令檔
• Stripe — Webhooks 與事件重試
• Stably — 受監督編排
• Stably — 失敗復原與清理契約
• Stably — 遠端伺服器
• Stably — 排程自動化
• Stably — Orca v1.4.227 發布說明
• Stably — Design Mode 元素資訊
• Stably — 程式歸屬中繼資料
• Stably — 工作位置與持續執行
• Stably — Artifacts 發布權限

Author Insight

需要強制人類核准部署的團隊，不應把 Orca Gate 當成唯一授權邊界。官方契約讓協調者能解決 Gate，這已足以決定工具分工：Orca 管協作紀錄，真正的發布憑證與核准留在外部控制。做到這個分離，才適合把有正式環境影響的任務接進編排。

術語表

I'm a Full Stack Developer with expertise in building modern web applications that fast, secure, and scalable. Crafting seamless user experiences with a passion for headless CMS, Vercel and Cloudflare

Loading...