Claude Code เวิร์กโฟลว์ไดนามิก: รัน Subagents ขนานนับร้อยด้วย Opus 4.8

Claude Opus 4.8 มาพร้อมกับฟีเจอร์เด่นสำหรับ Claude Code: Dynamic Workflows ในหนึ่งเซสชัน เอเจนต์ผู้ควบคุมสามารถสร้างซับเอเจนต์แบบขนานได้หลายร้อยตัวเพื่อจัดการกับงานขนาดใหญ่ที่มีการแยกสาขา: การปรับโครงสร้างในไฟล์หลายสิบไฟล์ การเรียกใช้เมทริกซ์การทดสอบที่กว้างขวาง หรือการสำรวจเส้นทางโซลูชันหลายเส้นทางพร้อมกัน มันดูเหมือนเวทมนตร์ในเทอร์มินัล ภายใต้เบื้องหลังแล้ว มันคือสองส่วนที่ทำงานร่วมกันอย่างเป็นรูปธรรม

คู่มือนี้จะอธิบายว่า Dynamic Workflows ทำงานอย่างไร ควรใช้เมื่อใด และจะสร้างรูปแบบการควบคุมเดียวกันผ่าน API ดิบได้อย่างไร สำหรับตัวโมเดลเอง ดู Claude Opus 4.8 คืออะไร สำหรับข้อมูลพื้นฐานสถาปัตยกรรมเอเจนต์ การวิเคราะห์สถาปัตยกรรม Claude Code agent harness ของเราคือสิ่งที่ควรอ่านคู่กัน

Dynamic Workflows คืออะไรกันแน่

ใน Claude Code, Dynamic Workflows ปรากฏเป็นโหมดที่เรียกว่า ultracode ในเมนู effort นี่คือส่วนที่ควรทำความเข้าใจ: ultracode ไม่ใช่ระดับ effort API ใหม่ มันคือการรวมกันของสองสิ่งที่มีอยู่แล้วใน Opus 4.8:

1. ระดับ effort xhigh
2. ข้อความระบบระหว่างการสนทนา (Mid-conversation system messages)

เมื่อรวมกัน สิ่งเหล่านี้ทำให้เอเจนต์ผู้ควบคุมมีความลึกซึ้งในการให้เหตุผลเพื่อวางแผนงานขนาดใหญ่ และได้รับอนุญาตให้เปิดตัวเอเจนต์ผู้ปฏิบัติงานได้เมื่อมีงานเกิดขึ้น นั่นคือเคล็ดลับทั้งหมด ส่วนที่เหลือคือการเชื่อมต่อของ Claude Code

ส่วนประกอบที่ 1: xhigh effort

พารามิเตอร์ effort ควบคุมจำนวนโทเค็นที่ Opus 4.8 ใช้ในการตอบกลับ รวมถึงการเรียกใช้เครื่องมือ xhigh เป็นระดับที่ Anthropic แนะนำสำหรับการเขียนโค้ดและการทำงานแบบเอเจนต์ในระยะยาว ซึ่งได้รับการปรับแต่งสำหรับการทำงานที่ยาวนานกว่า 30 นาที ด้วยงบประมาณโทเค็นหลายล้าน

สำหรับ Dynamic Workflow ความลึกซึ้งนั้นมีความสำคัญ เพราะผู้ควบคุมต้องมีการวางแผนจริง: แยกงานออกเป็นหน่วยย่อยที่เป็นอิสระ ตัดสินใจว่าจะสร้างคนงานกี่คน และรวมผลลัพธ์ของพวกเขา ระดับ effort ที่ต่ำกว่าจะจำกัดขอบเขตของงานและเรียกใช้เครื่องมือน้อยลง ซึ่งตรงกันข้ามกับสิ่งที่ผู้ควบคุมต้องการ เมื่อคุณเรียกใช้ xhigh ให้ตั้งค่า max_tokens ให้มีขนาดใหญ่ (64K เป็นจุดเริ่มต้นที่เหมาะสม) เพื่อให้โมเดลมีพื้นที่ในการคิดและประสานงาน

ส่วนประกอบที่ 2: ข้อความระบบระหว่างการสนทนา

นี่คือความสามารถใหม่ของ Messages API ที่ทำให้ทุกอย่างเป็นไปได้ ก่อน Opus 4.8, prompt ของระบบจะอยู่ที่จุดเริ่มต้นของการสนทนาและคงที่ ตอนนี้คุณสามารถวางรายการระบบไว้กลางอาร์เรย์ messages ได้ โดยการแทรกคำแนะนำหรือสิทธิ์ใหม่ๆ ระหว่างงาน

นั่นคือสิ่งที่ทำให้ผู้ควบคุมได้รับอนุญาตให้เปิดตัวเวิร์กโฟลว์แบบหลายเอเจนต์หลังจากที่การสนทนาเริ่มต้นขึ้นแล้ว แทนที่จะต้องเจรจาล่วงหน้า Anthropic ได้บันทึกกลไกนี้ไว้ใน ข้อความระบบระหว่างการสนทนา เป็นการเปลี่ยนแปลง API เล็กน้อยแต่มีผลกระทบใหญ่หลวง: เอเจนต์สามารถเพิ่มความสามารถได้กลางคันระหว่างการทำงานตามสิ่งที่พวกเขาค้นพบ

การเปิดใช้งานใน Claude Code

ใน Claude Code, Dynamic Workflows จะอยู่ภายใต้ตัวเลือก ultracode ในเมนู effort การเลือกตัวเลือกนี้จะตั้งค่า xhigh effort และให้สิทธิ์เซสชันในการสร้าง subagents แบบขนานผ่านข้อความระบบระหว่างการสนทนา จากนั้นคุณก็อธิบายงานขนาดใหญ่และปล่อยให้ผู้ควบคุมกระจายงานออกไป

มีบางอย่างที่เกิดขึ้นโดยอัตโนมัติ:

• Claude วางแผนงานและตัดสินใจว่าจะแบ่งงานอย่างไร
• มันจะเปิดตัวผู้ปฏิบัติงานแบบขนาน โดยแต่ละคนจะรับผิดชอบงานย่อยหนึ่งส่วน
• ผลลัพธ์จะถูกส่งกลับและรวมเข้ากับเซสชันหลัก

หากคุณได้ตั้งค่า Claude Code ด้วยแผนการทำงานแล้ว คู่มือการตั้งค่า Claude Agent SDK with Claude plan ของเราจะครอบคลุมการกำหนดค่าโดยรอบ

ควรใช้ Dynamic Workflows เมื่อใด (และไม่ควรใช้เมื่อใด)

Dynamic Workflows โดดเด่นในงานที่กว้างขวางและสามารถทำขนานกันได้:

• การปรับโครงสร้างรูปแบบในหลายไฟล์พร้อมกัน
• การสร้างและเรียกใช้เมทริกซ์การทดสอบขนาดใหญ่
• การสำรวจแนวทางการนำไปใช้งานหลายวิธีพร้อมกัน แล้วนำมาเปรียบเทียบกัน
• การวิเคราะห์ codebase ขนาดใหญ่ โดยที่แต่ละ worker รับผิดชอบหนึ่งโมดูล

มันเป็นเครื่องมือที่ไม่ถูกต้องสำหรับงานที่แคบและเป็นลำดับ การสร้าง subagents หลายร้อยตัวสำหรับการเปลี่ยนแปลงไฟล์เดียวจะสิ้นเปลืองโทเค็นโดยไม่มีประโยชน์ และ worker แบบขนานไม่สามารถช่วยได้เมื่อแต่ละขั้นตอนขึ้นอยู่กับขั้นตอนที่แล้ว ค่าใช้จ่ายนั้นเป็นจริง: subagents xhigh หลายร้อยตัวหมายถึงโทเค็นหลายล้านตัว ให้จับคู่รูปแบบกับลักษณะของงาน

การสร้างสิ่งเดียวกันผ่าน API

คุณไม่จำเป็นต้องมี Claude Code เพื่อสร้างการควบคุม ส่วนประกอบสองอย่างเดียวกันมีให้ใช้งานใน Messages API ดิบ และ Anthropic ได้จัดเตรียมตัวอย่างที่ทำงานได้จริงใน การสร้างโหมดการควบคุม รูปแบบคือ:

1. เรียกใช้การควบคุมที่ xhigh effort ที่วางแผนงาน
2. ใช้ข้อความระบบระหว่างการสนทนาเพื่อให้สิทธิ์ผู้ควบคุมในการจัดส่ง workers
3. กระจายการเรียก worker แบบขนาน โดยแต่ละ worker รับผิดชอบงานหนึ่งหน่วย
4. รวบรวมผลลัพธ์และส่งกลับไปยังผู้ควบคุมเพื่อรวม

import anthropic

client = anthropic.Anthropic()

orchestrator = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=64000,
    output_config={"effort": "xhigh"},
    thinking={"type": "adaptive"},
    messages=[
        {"role": "user", "content": "Plan a refactor of the auth module across all 14 services."},
    ],
)

แต่ละ worker คือการเรียกใช้ Messages แยกกันที่คุณสามารถรันพร้อมกันได้ บ่อยครั้งที่ระดับ effort ต่ำกว่าเนื่องจากงานของมันแคบ หากคุณกำลังเปรียบเทียบสิ่งนี้กับโครงสร้างพื้นฐานเอเจนต์ที่โฮสต์ของ Anthropic คู่มือ managed agents vs Agent SDK จะอธิบายข้อดีข้อเสีย

ค่าใช้จ่ายและการควบคุม

ซับเอเจนต์แบบขนานจะเพิ่มการใช้โทเค็นอย่างรวดเร็ว Dynamic Workflow ที่เปิดตัว 200 workers ซึ่งแต่ละตัวใช้โทเค็นหลายหมื่นที่ xhigh จะมีค่าใช้จ่ายจริง สามนิสัยที่จะทำให้มันสมเหตุสมผล:

• จำกัดขอบเขตของ workers ให้กระชับ และเรียกใช้ที่ effort ระดับ medium หรือ low หากงานย่อยเอื้ออำนวย
• จำกัด max_tokens ต่อ worker เพื่อไม่ให้เอเจนต์ที่ควบคุมไม่ได้ใช้จ่ายงบประมาณจนหมด
• แคชบริบทที่ใช้ร่วมกัน เพื่อไม่ให้ prompt ของระบบที่ซ้ำกันถูกเรียกเก็บเงินเต็มอัตรากับทุก worker

รายละเอียดราคาของ Opus 4.8 มีการคำนวณระดับ effort และการแคช ฉบับย่อ: การควบคุมนั้นทรงพลัง แต่ค่าใช้จ่ายจะเพิ่มขึ้นตามจำนวนเอเจนต์ ดังนั้นให้พิจารณาการทำงานแบบขนานอย่างรอบคอบ

การทดสอบการควบคุมของคุณด้วย Apidog

เมื่อคุณสร้างการควบคุมผ่าน API ส่วนที่ยากในการดีบักคือการกระจายงาน: workers ได้รับบริบทที่จำกัดขอบเขตที่ถูกต้องหรือไม่ การตอบสนองของพวกเขามีรูปร่างตามที่ขั้นตอนการรวมของคุณคาดหวังหรือไม่ และข้อความระบบระหว่างการสนทนาของคุณทำงานได้อย่างถูกต้องหรือไม่ คุณไม่ต้องการค้นพบข้อผิดพลาดหลังจากเรียกใช้ worker แบบสด 200 ครั้ง

Apidog ช่วยให้คุณทดสอบส่วนต่างๆ แยกกันได้:

• บันทึกคำขอผู้ควบคุมและตรวจสอบการแยกงานที่วางแผนไว้ก่อนที่คุณจะจัดส่งสิ่งใดๆ
• จำลองปลายทาง worker เพื่อให้คุณสามารถทดสอบตรรกะการกระจายงานและการรวมของคุณโดยไม่ต้องใช้โทเค็นในการเรียกใช้จริงหลายร้อยครั้ง
• เพิ่มการยืนยันเกี่ยวกับรูปร่างการตอบสนองของ worker เพื่อให้ payloads ที่ผิดพลาดเกิดข้อผิดพลาดอย่างชัดเจน
• เล่นซ้ำการเรียก worker เดียวที่ระดับ effort ต่างกันเพื่อปรับค่าใช้จ่ายต่อ worker

ดาวน์โหลด Apidog สร้างคำขอผู้ควบคุมและ worker กับ https://api.anthropic.com/v1/messages และตรวจสอบวงจรบน mocks ก่อน เมื่อตรรกะมั่นคงบน mocks แล้ว ให้เปลี่ยนไปใช้ปลายทางแบบสด

คำถามที่พบบ่อย

Dynamic Workflows ใน Claude Code คืออะไร? คุณสมบัติที่ช่วยให้เซสชันเดียวสามารถสร้าง subagents แบบขนานได้หลายร้อยตัวเพื่อจัดการกับงานขนาดใหญ่ที่มีการแยกสาขา มันขับเคลื่อนโดย xhigh effort บวกกับข้อความระบบระหว่างการสนทนาใน Opus 4.8

ultracode เป็นระดับ effort ที่แยกต่างหากหรือไม่? ไม่ใช่ Ultracode เป็นชื่อที่ Claude Code ใช้เรียก xhigh effort ที่จับคู่กับสิทธิ์ในการเปิดตัวเวิร์กโฟลว์แบบหลายเอเจนต์ ระดับ effort API ยังคงเป็น low, medium, high, xhigh และ max

ข้อความระบบระหว่างการสนทนาคืออะไร? การเปลี่ยนแปลง Messages API ใน Opus 4.8 ที่ช่วยให้คุณสามารถวางรายการระบบไว้กลางการสนทนา โดยการแทรกคำแนะนำหรือสิทธิ์ใหม่ๆ ระหว่างงาน นี่คือสิ่งที่ทำให้ผู้ควบคุมสามารถสร้าง workers ได้หลังจากเริ่มการทำงาน

ฉันสามารถสร้าง Dynamic Workflows โดยไม่มี Claude Code ได้หรือไม่? ได้ คุณสามารถใช้ xhigh effort บวกกับข้อความระบบระหว่างการสนทนาใน Messages API ดิบ Anthropic เผยแพร่ตัวอย่างการควบคุมที่ทำงานได้จริงในเอกสารของพวกเขา

Dynamic Workflows มีค่าใช้จ่ายสูงหรือไม่? อาจจะสูงได้ ซับเอเจนต์ xhigh หลายร้อยตัวรวมกันเป็นโทเค็นหลายล้านตัว จำกัดขอบเขตของ workers ให้กระชับ ลด effort ลงเมื่อทำได้ และแคชบริบทที่ใช้ร่วมกันเพื่อควบคุมค่าใช้จ่าย

ฉันควรหลีกเลี่ยง Dynamic Workflows เมื่อใด? สำหรับงานที่แคบหรือเป็นลำดับอย่างเคร่งครัด Workers แบบขนานไม่เพิ่มคุณค่าใดๆ เมื่อแต่ละขั้นตอนขึ้นอยู่กับขั้นตอนก่อนหน้า และพวกเขาสิ้นเปลืองโทเค็นกับงานเล็กๆ