AI-translated from English; not yet reviewed by a fluent editor.

# 將一項 Claude Code 編碼任務從 Opus 委派給 Haiku，並驗證結果

> 依據文件的 Claude Code 工作流程：把範圍明確的程式碼修改從 Opus 主代理交給專案 Haiku 子代理，檢查實際模型與差異，並在不預設節省的前提下解讀用量。

By BIG CHANGE Editorial

Published: 2026-10-20T10:17:38.691Z
Updated: 2026-10-20T10:17:38.691Z
Canonical: https://bigchange.ai/blog/claude-code-opus-haiku-subagent-coding-guide

![Conceptual charcoal illustration of a reviewer using a laptop trackpad beside a generic two-column code diff with one orange changed section.](https://bigchange.ai/api/media/file/opus-haiku-diff-review-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

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 模型設定文件](https://code.claude.com/docs/en/model-config)說明目前對應與限制。

## 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。[子代理手冊](https://code.claude.com/docs/en/sub-agents)解釋這些控制。

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

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

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

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

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

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

關於用 AI 助手核查儲存庫故障的相關方式，請參閱我們的[AI Goal 修復與驗證指南](https://bigchange.ai/blog/ai-goal-failing-repository-check-guide)。該流程不設定這裡使用的 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 成本指南](https://code.claude.com/docs/en/costs)解釋用量顯示與計費限制。

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

## 來源及延伸閱讀

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

## Sources

- [建立自訂子代理——Claude Code 文件](https://code.claude.com/docs/en/sub-agents) — 專案代理檔案、前置設定、模型優先順序與覆寫、/tasks 查看、權限繼承及 worktree 行為的主要產品手冊。不驗證本指南未執行的任務或節省。
- [模型設定——Claude Code 文件](https://code.claude.com/docs/en/model-config) — 目前 Anthropic API 上 Opus、Haiku 別名與 ID、其他供應商對應、最低版本及受管理 availableModels 限制的主要來源。讀者必須核查本機實際解析。
- [有效管理成本——Claude Code 文件](https://code.claude.com/docs/en/costs) — 解釋 /usage 工作階段 token 與估計欄位、本機方案歸屬、過期顯示、訂閱與 API 計費，以及 Console 的計費權威性。不提供指定執行代理的精確帳單或量得的任務節省。
- [設定權限——Claude Code 文件](https://code.claude.com/docs/en/permissions) — 解釋修改程式碼的執行代理相關的實際 shell 與檔案權限。子代理工具清單本身不是檔案系統路徑邊界。