เป้าหมาย
เปิดใช้และสั่งตั้ง agent team ได้ เข้าใจว่าต่างจาก subagent อย่างไร คุมทีมระหว่างทำงาน ใช้ hook บังคับคุณภาพ และรู้ข้อจำกัดของฟีเจอร์ทดลองนี้ก่อนใช้กับงานจริง
หลักการ
Team ต่างจาก subagent อย่างไร
| Subagents | Agent teams | |
|---|---|---|
| ใครคุยกับใคร | ทุกตัวรายงานกลับหาตัวหลักเท่านั้น | สมาชิกส่งข้อความหากันเองได้ตามชื่อ |
| งาน | ตัวหลักแจกทีละชิ้น | task list ร่วม (รอทำ / กำลังทำ / เสร็จ มี dependency) สมาชิกหยิบงานเองหรือหัวหน้ามอบหมาย |
| แต่ละตัวคือ | Claude ชั่วคราวใน session เดียว | session เต็มรูปแบบ มี context ของตัวเอง ได้ CLAUDE.md, MCP, skills แต่ ไม่เห็นแชตของหัวหน้า |
| ต้นทุน | น้อยกว่า | มากกว่าชัดเจน (เอกสารระบุราว 7 เท่าของ session ปกติเมื่อสมาชิกอยู่ใน plan mode) |
ใช้ team เมื่องานต้องการ ถกเถียงหรือส่งต่อกันระหว่างทำ เช่น สมาชิก 3 คนหาสาเหตุบั๊กคนละสมมติฐานแล้วหักล้างกัน หรือสถาปนิก + คนทำ + คนค้าน
บทบาท
- หัวหน้า (team lead): session ที่คุณคุยอยู่ เปลี่ยนตัวไม่ได้ตลอดอายุทีม
- สมาชิก (teammates): session แยก ข้อความอยู่ใน
~/.claude/teams/{ชื่อทีม}/inboxes/และ task list ที่~/.claude/tasks/{ชื่อทีม}/
ตั้งค่า ⚙️
| ตั้งอะไร | ที่ไหน | ค่าเริ่ม → แนะนำ |
|---|---|---|
| เปิดใช้ | "env": {"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"} ใน settings.json |
ปิด → เปิดใน .claude/settings.local.json ของโปรเจกต์ทดลองเท่านั้น |
| การแสดงผล | "teammateMode": in-process / auto / tmux / iterm2 |
in-process (ใช้ได้ทุก terminal) · แยกหน้าต่างต้องมี tmux หรือ iTerm2 + it2 (ใช้ไม่ได้ใน terminal ของ VS Code, Windows Terminal, Ghostty) |
| ขนาดทีม | ระบุใน prompt | เอกสารแนะนำเริ่ม 3–5 คน และ 5–6 งานต่อคน · "3 คนที่โฟกัสมักดีกว่า 5 คนที่กระจัดกระจาย" |
| โมเดลของสมาชิก | ระบุใน prompt เช่น "ใช้ Sonnet ทุกคน" | ใช้รุ่นเล็กกว่าหัวหน้าเพื่อลดต้นทุน |
| ให้สมาชิกวางแผนก่อนลงมือ | หัวหน้าต้องอยู่ใน plan mode ก่อนตั้งทีม | ⚠️ เมื่อสมาชิกวางแผนเสร็จ หัวหน้าอนุมัติแผนเองโดยไม่ถามคุณ |
| hook ของทีม | TeammateIdle, TaskCreated, TaskCompleted ใน settings (exit 2 = ส่ง feedback กลับ/บล็อกการปิดงาน) |
เช่น บล็อก TaskCompleted ถ้าเทสต์ไม่ผ่าน (หลักเดียวกับ Stop hook บท 7d-03) |
เปิดแล้วมีผลข้างเคียง: เมื่อ Claude สั่ง subagent แบบระบุชื่อ อาจกลายเป็นสมาชิกทีมโดยที่คุณไม่ได้สั่งตั้งทีม — ปิด env นี้เมื่อไม่ได้ใช้
ลองเลย 🧪 (ใน claude แบบ interactive — ใช้กับ -p หรือ SDK ไม่ได้)
ทดลอง A — ทีมถกแนวทาง (ยังไม่แก้โค้ด)
ฉันกำลังออกแบบ [ฟีเจอร์] ในโปรเจกต์นี้ ตั้งทีม 3 คนมองคนละมุม:
คนแรกดู UX ของผู้ใช้, คนที่สองดูสถาปัตยกรรมและข้อมูล, คนที่สามเป็นฝ่ายค้านที่หาจุดอ่อนของสองคนแรก
ใช้ Sonnet ทุกคน ห้ามแก้ไฟล์ ให้คุยกันจนได้ข้อสรุป แล้วสรุปให้ฉันเป็นตาราง ทางเลือก / ข้อดี / ความเสี่ยง / ข้อแนะนำ→ ผลที่ควรได้: เห็นสมาชิก 3 แถวใน agent panel · Ctrl+T เปิด/ปิด task list · ↑/↓ + Enter เข้าไปดูสมาชิก · x หยุดสมาชิกที่เลือก
→ จบงาน: ให้สมาชิกทุกคน shut down (สมาชิกอาจปฏิเสธถ้างานยังไม่เสร็จ)
ทดลอง B — หาสาเหตุบั๊กแบบแข่งสมมติฐาน
บั๊ก: [อาการ + วิธีทำให้เกิด] ตั้งทีม 3 คน แต่ละคนเลือกสมมติฐานต่างกันแล้วหาหลักฐาน
ให้ส่งข้อความหักล้างสมมติฐานของคนอื่นเมื่อเจอหลักฐานขัดแย้ง ห้ามแก้โค้ดจนกว่าจะเหลือสมมติฐานเดียวที่มีหลักฐาน
สรุป: สาเหตุ หลักฐาน (ไฟล์:บรรทัด) และวิธีแก้ที่เสนอถ้าพัง
| อาการ | สาเหตุที่พบบ่อย |
|---|---|
| ไม่มีสมาชิกเกิดขึ้น | ไม่ได้ตั้ง env, รันด้วย -p/SDK หรือ Claude Code เก่าเกิน |
| สถานะงานไม่อัปเดต / ปิดทีมช้า | ข้อจำกัดที่เอกสารระบุไว้ — รอสักครู่หรือสั่งหัวหน้าเช็กใหม่ |
| resume session แล้วสมาชิกหาย | สมาชิกแบบ in-process ไม่รองรับการ resume |
| ค่าใช้จ่ายพุ่ง | ทีมใหญ่เกิน หรือสมาชิกใช้ Opus → ลดเหลือ 3 คน ใช้ Sonnet และปิดทีมทันทีที่เสร็จ |
ข้อดี / ข้อเสีย
| ✅ ข้อดี | ❌ ข้อเสีย |
|---|---|
| สมาชิกถกเถียงและหักล้างกันได้ ได้มุมมองที่ agent ตัวเดียวมักมองข้าม | ฟีเจอร์ทดลอง: resume ไม่ได้, สถานะช้า, ทีมเดียวต่อ session, ซ้อนทีมไม่ได้ |
| task list ร่วม ช่วยงานที่มีหลายชิ้นและ dependency | ต้นทุนสูงที่สุดในเครื่องมือของ Claude Code (~7 เท่าใน plan mode) |
| แต่ละคนมี context ของตัวเอง | หัวหน้าอนุมัติแผนของสมาชิกเอง คุณไม่ได้ตรวจทุกขั้น |
ไม่ควรใช้เมื่อ: งานที่ subagent ทำได้ (แค่ไปหาแล้วรายงานกลับ), งานแก้ไฟล์เดียวกันหลายคน, งานใน CI/headless, หรือเมื่อโควตาใกล้หมด ทางเลือกที่ง่ายกว่า: subagent 2–3 ตัว + ให้ตัวหลักเป็นคนเทียบข้อสรุป มักได้ผล 80% ด้วยต้นทุนน้อยกว่ามาก
สังเกตอะไร
- คุณค่าของ team อยู่ที่ "การคุยกัน" ถ้า prompt ไม่ได้สั่งให้หักล้างหรือส่งต่อกัน ก็แทบไม่ต่างจาก subagent ที่แพงกว่า
- ทุกอย่างที่สมาชิกต้องรู้ต้องอยู่ใน prompt ตั้งทีม หรือในไฟล์ เพราะสมาชิกไม่เห็นแชตของหัวหน้า
สรุปจำง่าย
Team = หลาย session ที่คุยกันเองได้ — ใช้เมื่องานต้องถกเถียง ไม่ใช่แค่แบ่งงาน เริ่ม 3 คน ใช้รุ่นเล็ก และปิดทีมทันทีที่เสร็จ