ระดับ 8d · บทที่ 2/6

Agent teams — ทีม AI ที่คุยกันเองและแบ่งงานจาก task list ร่วม

⏱ 30 นาทีลองในClaude ↗
ข้อมูลบางส่วนอาจเปลี่ยน — ตรวจสอบก่อนใช้

บทนี้มีข้อมูลที่เปลี่ยนบ่อย (ฟีเจอร์ ราคา ชื่อเมนู) ตรวจกับเว็บทางการก่อนนำไปใช้

เป้าหมาย

เปิดใช้และสั่งตั้ง 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 คน ใช้รุ่นเล็ก และปิดทีมทันทีที่เสร็จ