จัดการทีมของ Claude Code Sessions

ประสานงาน Claude Code หลายอินสแตนซ์ให้ทำงานร่วมกันเป็นทีม พร้อมงานร่วมกัน การส่งข้อความระหว่าง Agent และการจัดการจากส่วนกลาง

warning

ทีม Agent เป็นฟีเจอร์ทดลองและปิดใช้งานโดยค่าเริ่มต้น เปิดใช้งานโดยเพิ่ม CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS ใน settings.json หรือในสภาพแวดล้อม ทีม Agent มี ข้อจำกัดที่ทราบ เกี่ยวกับการกลับมาใช้ session การประสานงานงาน และพฤติกรรมการปิดระบบ

ทีม Agent ช่วยให้คุณประสานงาน Claude Code หลายอินสแตนซ์ให้ทำงานร่วมกัน Session หนึ่งทำหน้าที่เป็นหัวหน้าทีม ประสานงาน มอบหมายงาน และสรุปผล ส่วนสมาชิกทีมทำงานอิสระในหน้าต่างบริบทของตนเอง และสื่อสารกันโดยตรง

ต่างจาก Subagent ที่รันภายใน Session เดียวและรายงานกลับไปยัง Agent หลักเท่านั้น คุณยังสามารถโต้ตอบกับสมาชิกทีมแต่ละคนได้โดยตรงโดยไม่ต้องผ่านหัวหน้า

note

ทีม Agent ต้องใช้ Claude Code v2.1.32 หรือใหม่กว่า ตรวจสอบเวอร์ชันของคุณด้วย claude --version

เมื่อไหรควรใช้ทีม Agent

ทีม Agent มีประสิทธิภาพสูงสุดสำหรับงานที่การสำรวจแบบขนานเพิ่มคุณค่าจริงๆ กรณีการใช้งานที่แข็งแกร่งที่สุด:

• การวิจัยและตรวจสอบ: สมาชิกหลายคนสามารถตรวจสอบแง่มุมต่างๆ ของปัญหาพร้อมกัน แล้วแบ่งปันและท้าทายข้อค้นพบของกันและกัน
• โมดูลหรือฟีเจอร์ใหม่: สมาชิกแต่ละคนสามารถเป็นเจ้าของส่วนต่างๆ โดยไม่กวนกัน
• Debug ด้วยสมมติฐานที่แข่งขันกัน: สมาชิกทดสอบทฤษฎีต่างกันพร้อมกันและมาบรรจบที่คำตอบได้เร็วกว่า
• การประสานงานข้ามชั้น: การเปลี่ยนแปลงที่ครอบคลุม frontend, backend และ test แต่ละส่วนถือโดยสมาชิกต่างกัน

เปรียบเทียบกับ Subagent

	Subagent	ทีม Agent
บริบท	หน้าต่างบริบทของตนเอง ผลลัพธ์กลับไปยังผู้เรียก	หน้าต่างบริบทของตนเอง อิสระอย่างสมบูรณ์
การสื่อสาร	รายงานผลกลับไปยัง Agent หลักเท่านั้น	สมาชิกส่งข้อความถึงกันโดยตรง
การประสานงาน	Agent หลักจัดการงานทั้งหมด	รายการงานร่วมกันพร้อมการประสานงานตนเอง
เหมาะสำหรับ	งานที่มุ่งเน้นซึ่งสำคัญแค่ผลลัพธ์	งานซับซ้อนที่ต้องการการพูดคุยและความร่วมมือ
ต้นทุน Token	ต่ำกว่า: ผลลัพธ์สรุปกลับไปยังบริบทหลัก	สูงกว่า: สมาชิกแต่ละคนเป็น Claude อินสแตนซ์แยก

เปิดใช้งานทีม Agent

ทีม Agent ปิดใช้งานโดยค่าเริ่มต้น เปิดใช้งานโดยตั้งค่าตัวแปรสภาพแวดล้อม CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS เป็น 1 ในสภาพแวดล้อม shell หรือผ่าน settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

เริ่มต้นทีม Agent แรกของคุณ

หลังจากเปิดใช้งานทีม Agent แล้ว บอก Claude ให้สร้างทีม Agent และอธิบายงานและโครงสร้างทีมที่คุณต้องการเป็นภาษาธรรมชาติ Claude จะสร้างทีม, สร้างสมาชิก และประสานงานตามคำสั่ง

ตัวอย่างนี้ทำงานได้ดีเพราะสามบทบาทเป็นอิสระจากกัน:

ฉันกำลังออกแบบเครื่องมือ CLI ที่ช่วยนักพัฒนาติดตาม TODO comments ทั่วทั้ง codebase
สร้างทีม Agent เพื่อสำรวจจากมุมต่างๆ: สมาชิกหนึ่งด้าน UX อีกด้านสถาปัตยกรรมเทคนิค
และอีกคนเล่นบทนักวิจารณ์

ควบคุมทีม Agent

เลือกโหมดการแสดงผล

ทีม Agent รองรับโหมดการแสดงผลสองแบบ:

• In-process: สมาชิกทั้งหมดรันภายในเทอร์มินัลหลักของคุณ ใช้ Shift+Down เพื่อสลับระหว่างสมาชิก
• Split panes: สมาชิกแต่ละคนได้รับ pane ของตนเอง คุณเห็น output ของทุกคนพร้อมกัน ต้องใช้ tmux หรือ iTerm2

โหมดค่าเริ่มต้นคือ "auto" ซึ่งใช้ split panes ถ้าคุณรันอยู่ใน tmux หรือเทอร์มินัลคือ iTerm2 และใช้ in-process ในกรณีอื่น ตั้งค่า teammateMode ใน ~/.claude/settings.json:

{
  "teammateMode": "in-process"
}

บังคับ in-process mode สำหรับ session เดียวโดยส่งเป็น flag:

claude --teammate-mode in-process

ระบุสมาชิกและโมเดล

Claude จะตัดสินจำนวนสมาชิกตามงาน หรือคุณสามารถระบุได้:

สร้างทีมที่มี 4 สมาชิกเพื่อ refactor โมดูลเหล่านี้แบบขนาน
ใช้ Sonnet สำหรับสมาชิกแต่ละคน

กำหนดให้อนุมัติแผนก่อน

สำหรับงานที่ซับซ้อนหรือเสี่ยง คุณสามารถกำหนดให้สมาชิกวางแผนก่อนดำเนินการ:

สร้างสมาชิก architect เพื่อ refactor โมดูล authentication
กำหนดให้อนุมัติแผนก่อนที่พวกเขาจะทำการเปลี่ยนแปลงใดๆ

ปิดระบบสมาชิก

เพื่อยุติ session ของสมาชิกอย่างปลอดภัย อ้างอิงด้วยชื่อ ตัวอย่างกับสมาชิกชื่อ researcher:

ขอให้ researcher teammate ปิดระบบ

ทำความสะอาดทีม

เมื่อเสร็จแล้ว ขอให้หัวหน้าทำความสะอาด:

ทำความสะอาดทีม

warning

ใช้หัวหน้าในการทำความสะอาดเสมอ สมาชิกไม่ควรรัน cleanup เพราะบริบททีมของพวกเขาอาจไม่แก้ไขได้อย่างถูกต้อง

สถาปัตยกรรมของทีม Agent

ส่วนประกอบ	บทบาท
หัวหน้าทีม	Session Claude Code หลักที่สร้างทีม, สร้างสมาชิก และประสานงาน
สมาชิก	Claude Code อินสแตนซ์แยกที่ทำงานตามงานที่มอบหมาย
รายการงาน	รายการงานร่วมที่สมาชิก claim และดำเนินการ
Mailbox	ระบบส่งข้อความสำหรับการสื่อสารระหว่าง Agent

แนวทางปฏิบัติที่ดีที่สุด

ให้บริบทเพียงพอแก่สมาชิก

สร้างสมาชิก security reviewer ด้วย prompt: "ตรวจสอบโมดูล authentication ที่ src/auth/
สำหรับช่องโหว่ด้านความปลอดภัย เน้นที่การจัดการ token, session management, และการตรวจสอบ input
รายงานปัญหาพร้อมระดับความรุนแรง"

เลือกขนาดทีมที่เหมาะสม

เริ่มต้นด้วย 3-5 สมาชิกสำหรับ workflow ส่วนใหญ่ มี 5-6 งานต่อสมาชิกเพื่อให้ทุกคนมีงานทำโดยไม่สับสน

รอให้สมาชิกเสร็จ

บางครั้งหัวหน้าเริ่มดำเนินการงานเองแทนที่จะรอสมาชิก หากเกิดเช่นนี้:

รอให้สมาชิกของคุณดำเนินการงานให้เสร็จก่อนดำเนินการต่อ

ข้อจำกัด

ทีม Agent เป็นฟีเจอร์ทดลอง ข้อจำกัดปัจจุบัน:

• ไม่มีการกลับมาใช้ session กับ in-process teammates: /resume และ /rewind ไม่ restore สมาชิก in-process
• สถานะงานอาจล่าช้า: สมาชิกบางครั้งล้มเหลวในการทำเครื่องหมายงานว่าเสร็จ
• การปิดระบบอาจช้า: สมาชิกจะเสร็จสิ้น request หรือ tool call ปัจจุบันก่อนปิดระบบ
• ทีมเดียวในแต่ละครั้ง: หัวหน้าสามารถจัดการทีมเดียวเท่านั้น
• ไม่มีทีมซ้อนกัน: สมาชิกไม่สามารถสร้างทีมหรือสมาชิกของตนเอง
• Split panes ต้องใช้ tmux หรือ iTerm2: ไม่รองรับใน VS Code integrated terminal, Windows Terminal หรือ Ghostty