Claude Code subagent 建立教學：分析資料夾自動規劃架構、Agent Teams 何時用、省 Token 完整攻略（2026）

Claude Code subagent 建立教學 — 這篇文章告訴你：如何讓 Claude Code 分析你的工作流程、自動建立專屬 Subagent 架構，以及何時使用 Agent Teams 協同作戰。同時完整說明如何透過限制工具清單、切換 Haiku/Sonnet/Opus 模型，把每次發文的 Token 消耗壓到最低。所有範例來自 Claude Code 官方文件（code.claude.com）與實際運行的阿宥 AI 助理架構。

Subagent 是什麼？為什麼能省 Token？

官方定義：每個 subagent 在自己的 context window 中執行，具有自訂系統提示、特定工具存取和獨立權限。

省 Token 的核心原理很簡單：

此外，Subagent 可以指定更便宜的模型（Haiku），讓簡單任務不需要動用 Sonnet，每月可節省數百元台幣的 API 費用。

第一步：讓 Claude Code 分析你的資料夾，自動規劃 Subagent 架構

不知道要建幾個 Subagent？讓 Claude Code 直接幫你規劃：

# 在 Claude Code 中輸入：
幫我分析 ~/projects 資料夾的任務結構，
找出哪些任務重複出現 3 次以上，
規劃應該建立哪些 subagent（含名稱、工具限制、模型建議），
並告訴我預估可節省多少 Token。

Claude 會掃描資料夾結構、讀取流程文件，然後輸出：

• 建議的 subagent 清單（名稱 + 功能描述）
• 每個 subagent 的工具限制（越短越省）
• 建議使用的模型（Haiku/Sonnet）
• 預估 Token 節省量

第二步：用 /agents 指令建立 Personal Subagent（步驟詳解）

官方建議用 /agents 命令建立 使用者層級 subagent，儲存至 ~/.claude/agents/，所有專案都能用。

也可以直接用 Write 工具建立 .md 檔：

# ~/.claude/agents/my-agent.md

---
name: seo-researcher
description: 執行 SEO 關鍵字研究。用並行 WebFetch 打 Google Suggest API，找零競爭長尾詞。
color: "#4CAF50"
model: claude-haiku-4-5
tools:
  - Bash
  - WebFetch
  - WebSearch
---

你是 SEO 研究員，只打 3 個並行 WebFetch，不多輪搜尋...

持久記憶目錄 ~/.claude/agent-memory/ 讓 Subagent 跨對話累積見解，例如常見錯誤模式和最佳實踐。

實戰架構：阿宥 AI 助理的 8 個 Subagent 完整說明

以下是根據實際發文流程建立的 8 個 Subagent，每個都有工具限制和最佳模型：

6/8 使用 Haiku，僅 2 個需要 Sonnet → 整體 Token 費用大幅降低

Agent Teams：什麼時候用？什麼時候不要用？

Agent Teams 讓多個 Claude 實例同時工作，但Token 消耗是 Subagent 的數倍，選錯會燒錢。

啟用方式（預設停用）：

# 方法一：環境變數
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

# 方法二：settings.json
{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }

# 啟用後，用自然語言建立團隊
建立一個 agent team，同時審查 PR #142 的安全性、效能、測試覆蓋。

模型切換完整指南：Haiku / Sonnet / Opus 怎麼選？

Claude Code 支援三種模型，正確選擇可節省 30-50% 費用：

Subagent 切換模型的方式：在 .md 檔的 frontmatter 加 model: claude-haiku-4-5，每次呼叫該 subagent 時自動使用指定模型。

省 Token 的 7 個實戰指令（直接複製貼上）

這些是官方文件和實戰驗證有效的 Token 節省指令：

ASCII 架構圖：Subagent + Agent Teams 完整關係

┌─────────────────────────────────────────────────────────────────┐
│         Claude Code Subagent + Agent Teams 架構圖（2026）        │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  你的指令（自然語言）                                             │
│       │                                                         │
│       ▼                                                         │
│  ┌─────────────────────────────────────────┐                   │
│  │         主代理（Main Claude Code）       │                   │
│  │  讀 CLAUDE.md + 自動記憶 + 判斷路由     │                   │
│  └─────────────┬───────────────────────────┘                   │
│                │                                                │
│    ┌───────────┼──────────────────────────┐                    │
│    ▼           ▼                          ▼                    │
│  ┌──────┐  ┌────────────────┐   ┌──────────────────┐          │
│  │單一  │  │  Subagent 路由  │   │  Agent Teams     │          │
│  │執行  │  │（順序任務用）  │   │  （並行探索用）  │          │
│  └──────┘  └────────────────┘   └──────────────────┘          │
│                │                         │                     │
│    ┌───────────┴──┐           ┌──────────┴────────────┐       │
│    ▼              ▼           ▼          ▼             ▼       │
│  🟢SEO      🟠WP發布     👤隊友A    👤隊友B      👤隊友C       │
│  研究員     Haiku       （安全）   （效能）    （測試）        │
│  只有       只有        各自獨立  各自獨立   各自獨立          │
│  WebFetch   Bash+Write  context  context   context             │
│                │                         │                     │
│    結果回傳給主代理              隊友互相溝通+共享任務列表       │
│    Token 低                     Token 高（數倍）                │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

💡 記住：Subagent = 工具限制 + 廉價模型 = 省 Token。Agent Teams = 並行協作 = 燒 Token。每天發一篇文章選 Subagent，3 篇同時寫才選 Teams。

FAQ：最常被問到的 5 個問題

✍️ 關於作者：阿宥

雲林在地 AI 房仲顧問，長期研究 Claude Code 自動化工作流程。實際用 8 個 Subagent 架構管理每日發文任務，持續追蹤官方文件並整理為繁中實戰教學。

每組序號第一裝置限一用・不可轉讓或分享