Claude Code 能為專案子代理分配獨立模型及工具，同時由主對話負責規劃與審查。對於一項獲授權的程式碼儲存庫修改，Opus 主代理可將範圍明確的實作步驟交給 Haiku。實用結果是經過檢查的程式碼修改，以及實際執行模型的記錄。僅設定較便宜的模型，不能證明節省費用。

重要變化

  • 發生了什麼變化：專案代理檔案可為指定名稱的編碼執行代理請求model: haiku，而主工作階段使用 Opus。
  • 為何重要：主代理能審查較小的執行任務，但開發者仍須判斷差異是否符合原始驗收檢查。
  • 需要注意：模型覆寫、組織政策、權限、審查及重試都可能改變實際模型與總用量。宣稱成本優勢前應先核實。

從你已獲授權負責的任務開始

你需要自行控制的 Git 儲存庫、修改權限、Claude Code 對兩個模型系列的使用權，以及一項小到能透過差異評估的授權修改。記錄起始提交、範圍內檔案或行為、現有驗收命令，以及通過檢查的意義。使用乾淨的工作副本執行。命令必須來自你的專案；本指南無法為未知儲存庫提供有意義的測試。

開始前檢查claude --version、服務供應商及計費安排，還有實際生效的模型限制。在 Anthropic API 上，目前別名opus及haiku分別解析為 Opus 5.5（claude-opus-5-5）及 Haiku 5.5（claude-haiku-5-5）；此模型配對需要 Claude Code v2.1.293 或更新版本。其他供應商可能將相同別名對應到較早世代。組織的availableModels政策可能阻擋或替換選擇。在主工作階段中使用/model並記錄顯示的確切主模型。決定授權預算，並檢查真實帳戶或供應商控制；給模型的提示不是保證有效的支出上限。Anthropic 模型設定文件說明目前對應與限制。

1. 定義專案 Haiku 執行代理

在專案中建立名稱唯一的檔案，例如.claude/agents/bounded-code-worker.md，審查後使用以下方式啟動 Opus 主代理：claude --model opus，或用以下命令選擇 Opus：/model。此範例是執行代理定義，不是測試任務：

Markdown
---
name: bounded-code-worker
description: Implements one explicitly bounded, authorized repository change and reports the diff and checks for parent review.
model: haiku
tools: Read, Glob, Grep, Edit, Bash
permissionMode: default
---

在代理檔案結尾的---後立即加入以下自然語言系統提示：只實作主代理交付的任務與檔案範圍。修改前，檢查相關程式碼及指定驗收檢查。如果缺少任務、權限或必要輸入，停止並回報缺口。進行最小的相關修改。允許時執行原始檢查，回報確切命令與結果。傳回修改檔案、差異目的、剩餘失敗及未能驗證的工作。未經明確授權，不得提交、發布、部署或擴大任務。

這個tools清單提供工具；它不會將讀取或 shell 命令限制在指定路徑內。委派前檢查專案與組織的實際權限，尤其是 shell 存取。此流程的主代理應保持 Manual/default 權限模式：Anthropic 文件說明，若主代理處於acceptEdits、auto或bypassPermissions，就會覆寫執行代理的permissionMode。若這是新建 agents 目錄的第一個檔案，而且代理未出現，可重新啟動 Claude Code。子代理手冊解釋這些控制。

選用的isolation: worktree會給執行代理獨立工作副本。文件規定其起點是儲存庫預設分支，可能不同於主代理目前提交。使用或比較修改前，將起始修訂與已記錄的任務基準核對。原始驗收檢查仍需乾淨且獲授權的工作副本。

2. 委派、檢查，再接受或拒絕

給主代理與真實任務相關的指令，使用自己的檔案邊界及檢查命令：

簡要規劃這項授權修改。僅將指定實作委派給bounded-code-worker。保留原始驗收標準及最終審查責任。執行代理回傳後，向我顯示確切差異及檢查結果。在我審查前，不得接受或擴大修改。

執行代理運作時開啟/tasks，記錄該列顯示的模型。這才是執行時檢查；代理檔案或提示中的haiku只是請求。Claude Code v2.1.242 或更新版本會在此顯示執行模型。已完成的背景任務會在/tasks中保留約 30 秒，因此應及時查看並保留逐字記錄。若錯過該列，將模型驗證標記為未完成，不要從檔案推論模型。

閱讀實際差異，檢查每個修改檔案，並在自行控制的工作副本中親自執行原始驗收命令。修改需要時加入針對性檢查。只有行為、範圍與檢查均符合任務才接受結果。如果執行代理提前停止或只回傳部分工作，繼續或修復前先看已改內容。若使用獨立 worktree，併入主工作副本前先審查。

關於用 AI 助手核查儲存庫故障的相關方式，請參閱我們的AI Goal 修復與驗證指南。該流程不設定這裡使用的 Opus 到 Haiku 委派。

如果/tasks顯示其他模型或替換警告，請檢查呼叫的模型參數、代理檔案前置設定、CLAUDE_CODE_SUBAGENT_MODEL以及受管理的模型清單。目前 Claude Code 的呼叫模型優先於檔案前置設定，其次是環境預設，再其次是主模型；v2.1.251 之前則是環境設定優先。CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1（v2.1.257+）可覆寫定義，已安裝 mod 的agent.spawn掛鉤也可替換呼叫模型。修正真正的覆寫來源，或停止執行。不要把非 Haiku 結果改稱為 Haiku。

3. 記錄用量，不虛構節省

在這次受控工作階段前後讀取/usage。依模型記錄輸入、輸出與快取 token、顯示的成本估計、供應商或方案、已接受差異、原始檢查結果及所需審查或返工。Session 區塊按模型彙整整個工作階段，不是這個指定執行代理的精確帳單。方案歸屬百分比是近似的本機日或週歷史，不是這次任務的測量。API 帳戶以 Claude Console 為權威計費來源。訂閱使用者的工作階段美元估計不是額外帳單。如果用量顯示只是上次已知值，應標記為過期。

若要宣稱委派在這項任務上省錢，應與另行授權的單模型執行比較：從相同乾淨起始修訂出發，使用相同任務及驗收標準。計入主代理規劃與審查、執行代理呼叫、重試與返工，只比較已接受結果。一對執行仍只屬於特定任務的觀察。沒有此基準，應回報已驗證的模型路徑及程式碼結果；節省未知。Anthropic 成本指南解釋用量顯示與計費限制。

本流程依據目前文件，不是 BIG CHANGE 實際執行 Claude Code 或測量任務的結果。不要將組織尚未批准給已設定供應商的程式碼或機密傳送出去。此處使用 Claude Code 原生 Opus 與 Haiku 選擇；其他模型供應商需要另行規定的閘道或協調流程及獨立檢查。

來源及延伸閱讀

  • Anthropic：建立自訂子代理——專案代理檔案、模型優先順序、/tasks、權限與 worktree 行為。現行手冊於 2026 年 10 月 20 日核查，說明功能而非本指南未執行範例的結果。
  • Anthropic：模型設定——目前別名、供應商差異、版本要求與受管理模型控制。使用時確認已安裝版本及供應商。
  • Anthropic：有效管理成本——/usage欄位、估計，以及訂閱與 API 計費的差異，不證明本任務有節省。
  • Anthropic：設定權限——修改程式碼的執行代理運作前需要檢查的實際工具權限規則。