Claude Code subagents 點用：拆細 code review、查 bug 同跑測試

Claude Code 個新招：subagent 再開 subagent

XDA 作者 Mahnoor Faisal 寫咗一篇 Claude Code 使用文，最值得拆開睇嘅位係 Anthropic 官方文件確認：Claude Code v2.1.172 起，subagent 可以再開自己嘅 subagent。用人話講，即係你叫一個 reviewer 去睇 diff，佢可以再叫幾個 verifier 逐條核對 findings，最後只回一份摘要。主對話唔會塞滿中間來回，呢點對大型 repo 好有用。

圖片：Anthropic

點解多人開始咁用

AI coding agent 好多時輸喺 context 亂晒，唔一定係模型唔夠醒。官方 best practices 直接講，context window 會裝住對話、讀過嘅 file、command output；塞滿之後，表現會跌。Subagent 嘅價值係將查 repo、讀 logs、跑測試呢類噪音放入另一個 context，只帶結論返主線。Nested subagents 再行多步：連 verifier 之間嘅辯駁都收喺下層，主線只見結果。

適合用喺咩任務

最啱係三類。第一係 code review：主 agent 改完，reviewer subagent 睇 diff，verifier 再逐條查證。第二係大型 repo 調查：auth、billing、API 各自分開睇。第三係高輸出任務：測試、build logs、文件整理，叫 subagent 回精簡摘要。相反，小改字、單 file bug、要你一路追問一路微調嘅 UI 味道，未必值得開 agent 樹，因為每個 subagent 都要重新攞 context。

底盤要先整好

呢類做法唔應該一開就叫 Claude 自己衝。官方建議先用 Plan mode 讀 file 同訂計劃，確認方向先畀佢改；CLAUDE.md 放 repo 規矩、test command、易錯位，但要短，因為太長會食 context。Hooks 就啱放硬規矩，例如每次 edit 後跑 lint、攔截敏感路徑、過濾長 log。呢啲配置悶，但決定多 agent 係幫手定添亂。

成本唔會自動變平

有一個位要講明：subagent 可以慳主 context，但唔代表 token 免費。Anthropic 成本文件寫，Claude Code 用 API 時按 token 計，實際成本會睇你用咩 model、codebase 幾大，同一時間開幾多個 session。企業部署平均大約 US$13 / developer / active day、每月 US$150-250，實際差距可以好大。Agent teams 又係另一種重型玩法，官方話 plan mode teammates 大約用標準 session 七倍 token。想控成本，先用 /usage 睇數，探索型 subagent 盡量用較平 model，長任務分段清 context。

權限同 secrets 要硬淨

最大風險其實係權限。Subagent 有自己嘅 tools 同 permission，但佢始終可以讀 file、跑 Bash、叫 MCP；nested 之後，出事半徑會跟住擴大。官方 permissions 文件講 deny 先過 ask 同 allow，所以應該喺 project settings 禁 Read(.env)、Read(**/.env)、Read(//**/.env) 呢類規則，對 secrets、SSH key、prod config 做 deny；Bash network 工具如 curl、wget 要小心，WebFetch allowlist 唔會擋晒 Bash 直連。

團隊可以點樣試

如果團隊已經有 Claude Code，第一步唔好即刻砌五層 agent 樹。揀一個低風險、容易驗收嘅任務：例如 PR diff review、test failure 摘要、或者大型 repo 嘅 auth flow 調查。先寫清楚 subagent role、允許 tools、輸出格式同 stop condition，再加一個獨立 verifier。跑兩三次睇 token、誤報同漏報，再考慮開多條線。

呢次 nested subagents 真正有用嘅位，係將 coding agent 由一個長對話，變成一隊有上下級嘅短任務。用得好，主對話會乾淨啲，review 同查 bug 都易追；用得唔好，只會開多幾個 agent 一齊燒 token。下一步要睇 Anthropic 點樣收實大型自動化任務、agent teams 同 permission 管理，尤其係公司 repo 入面嘅 secrets 同審批邊界。

參考來源

• XDA Developers — I set up Claude Code the way Anthropic now recommends, and the sub-agents-spawning-sub-agents trick changed how I work — original report
• Anthropic Claude Code Docs: Create custom subagents — 用嚟核對 nested subagents、五層深度限制、獨立 context、工具同 permission 設定。
• Anthropic Claude Code Docs: Best practices for Claude Code — 用嚟核對 verification、Plan mode、CLAUDE.md、subagents 嘅官方建議。
• Anthropic Claude Code Docs: Configure permissions — 用嚟核對 permission 規則、deny 優先、.env/secrets、sandbox 同 bypassPermissions 風險。
• Anthropic Claude Code Docs: Manage costs effectively — 用嚟核對 token 成本、/usage、team spend limit、agent teams token 風險。
• Claude Code by Anthropic — 用嚟補 Claude Code 產品定位同支援平台。

本文根據原文及公開資料整理；資料有出入時，以原文及官方資料為準。