สิ่งที่เปลี่ยนใน API และ SDK
Claude API คือส่วนเชื่อมต่อที่แอปพลิเคชันใช้ส่งคำขอไปยังโมเดล Claude และรับผลกลับมา โดยเวอร์ชัน API กำหนดรูปแบบคำขอที่รองรับ ส่วน SDK ช่วยให้โค้ดเรียกบริการได้สะดวกขึ้น การอัปเดตรอบนี้จึงกระทบทั้งพารามิเตอร์ในคำขอและวิธีส่งข้อมูลยืนยันตัวตน
Claude API อัปเดตเป็นเวอร์ชัน 2026-10-21 เมื่อ 21 ตุลาคม 2026 นับเป็นเวอร์ชันใหม่ครั้งแรกหลังใช้เวอร์ชัน 2023-06-01 มาตลอดสามปี จุดที่ควรจัดการก่อนคือการถอด temperature, top_p และ top_k ออก หากส่งค่าใดไปกับคำขอเวอร์ชันใหม่ จะได้รับข้อผิดพลาด 400 แม้ค่านั้นเป็นค่าเริ่มต้นก็ตาม สำหรับงานที่ยังต้องใช้ค่า sampling แบบกำหนดเอง เช่น การลด temperature เพื่อให้ผลลัพธ์คงที่ ควรคงคำขอนั้นไว้ที่เวอร์ชันเดิม เพราะไม่มีพารามิเตอร์ใหม่มาแทน
SDK ทุกภาษาขึ้นรุ่นหลักใหม่ ได้แก่ Python 2.0.0, TypeScript 1.0.0, C# 13.0.0, Go 2.0.0, Java 3.0.0, PHP 1.0.0, Ruby 2.0.0 และ ant CLI 2.0.0 การเปลี่ยนรุ่นจึงไม่ใช่แค่ปรับหมายเลข dependency แต่มีการเปลี่ยนแปลงฝั่ง SDK แยกจาก API ด้วย การปล่อยให้ Dependabot หรือ Renovate รวมรุ่นให้อัตโนมัติโดยไม่ทดสอบ อาจทำให้ build หรือ gateway ใช้งานไม่ได้

ย้ายโค้ด SDK ใหม่อย่างเป็นขั้นตอน
การย้ายโค้ด SDK ใหม่ควรเริ่มจากแยกบริการและคำขอที่ยังต้องใช้พารามิเตอร์ sampling แบบเดิมออกจากส่วนที่จะอัปเดต อย่าเปลี่ยน API version และ SDK พร้อมกันโดยไม่ตรวจผล เพราะการแก้จุดหนึ่งไม่ได้รับประกันว่าอีกจุดจะเข้ากันได้
- ค้นหาโค้ดที่ส่ง temperature, top_p หรือ top_k แล้วเอาออกจากคำขอที่ย้ายไปใช้ API เวอร์ชันใหม่ หากยังต้องกำหนดค่าเหล่านี้ ให้คงคำขอนั้นไว้ที่เวอร์ชัน 2023-06-01
- อัปเดต SDK ในสภาพแวดล้อมทดสอบก่อน แล้วตรวจชนิดข้อมูลข้อความและการเรียก API ที่ระบบใช้อยู่ รวมถึงคำขอที่มี document หรือ citations ซึ่งมีข้อจำกัดใหม่
- ตรวจ proxy, gateway, ตัวกรองบันทึก และ test stub ที่อ่าน X-Api-Key แล้วปรับให้รองรับ Authorization: Bearer ซึ่งเป็นช่องทางส่ง API key ของ SDK รุ่นใหม่ ตัว API ยังรับ X-Api-Key ได้ และคู่มือมีตัวอย่างการย้ายกลับไปใช้ header เดิม โดย ant CLI ส่งแบบเดิมไม่ได้
- รันทดสอบคำขอจริงและกรณีผิดพลาดก่อนเผยแพร่ พร้อมตรึงรุ่น dependency ไว้จนกว่าจะยืนยันความเข้ากันได้
ข้อแนะนำนี้สำคัญเป็นพิเศษกับระบบที่พึ่งพา header เดิม เพราะการเปลี่ยนแปลงอาจอยู่ในชั้น gateway หรือเครื่องมือทดสอบ ไม่ใช่เฉพาะโค้ดที่เรียก Claude โดยตรง
ใช้ User Profiles จำกัดผลกระทบเมื่อลูกค้าถูกจำกัดสิทธิ์
แพลตฟอร์มที่ให้ลูกค้าหลายรายเรียก Claude ผ่านองค์กรเดียวมีความเสี่ยง หากคำขอของลูกค้ารายหนึ่งละเมิดนโยบายการใช้งาน การบังคับใช้ข้อจำกัดอาจกระทบทั้งองค์กรและทำให้ลูกค้ารายอื่นใช้บริการไม่ได้ User Profiles Claude ช่วยระบุลูกค้าปลายทางของแต่ละคำขอ และมีฟิลด์ enforcement_status กับ enforcement_actions ให้ตรวจสถานะการจำกัดสิทธิ์หรือการแบนผ่าน API
- สร้างโปรไฟล์ให้ลูกค้าแต่ละรายครั้งเดียวระหว่างขั้นตอนเริ่มใช้งาน โดยเรียก POST /v1/user_profiles แล้วบันทึก ID ที่ขึ้นต้นด้วย uprof_ ไว้ในข้อมูลลูกค้า
- เลือก access_type ให้ตรงกับบริการ โดย application ใช้กับผู้ใช้รายบุคคลในแอป ส่วน passthrough ใช้กับบริษัทที่เข้าถึง API ผ่าน gateway
- แนบ ID ใน anthropic-user-profile-id ทุกครั้งที่ส่งคำขอแทนลูกค้ารายนั้น หากเป็น passthrough ให้ระบุตัวผู้ใช้แต่ละคนใน metadata.user_id ด้วย
ข้อผิดพลาดที่พบบ่อยคือสร้างโปรไฟล์ซ้ำ เพราะ POST /v1/user_profiles ไม่รองรับการเรียกซ้ำแบบเดิมแล้วได้ผลเดิม แม้ใช้ reference_id ซ้ำก็จะได้โปรไฟล์ใหม่ จึงควรสร้างครั้งเดียวและเก็บ ID ให้ถูกต้อง อีกข้อคือคิดว่าการแยก workspace เพียงพอ แต่คำขอที่ไม่มีโปรไฟล์จะถูกนับเป็นการใช้งานขององค์กรผู้ให้บริการ สำหรับ Claude Models on Google Cloud โปรไฟล์ต้องสร้างผ่าน Claude API หรือ Claude Platform on AWS แล้วผูกโปรเจกต์ GCP ผ่าน Verification Portal
พิจารณายุบระบบ multi-agent ก่อนเพิ่ม subagent
การเพิ่ม subagent ไม่ได้แปลว่าระบบจะฉลาดหรือมีประสิทธิภาพขึ้นเสมอไป การส่งต่องานอาจทำให้ข้อมูลสำคัญหายไปในบทสรุป เกิดคำสั่งซ้ำซ้อน และทำให้ทีมวัดผลแยกส่วน แนวทาง single-agent-loop จึงควรเป็นตัวเลือกแรกที่นำไปทดสอบ ไม่ใช่ข้อสรุปให้ลบ subagent ทุกตัว
จากการเปรียบเทียบในระบบใช้งานขององค์กรหลายแห่ง agent ตัวเดียวที่ใช้ skills มักทำคุณภาพได้ดีกว่าทั้ง prompt เดียวที่รวมทุกอย่างและระบบ subagent อีกทั้งมักมีต้นทุนและความหน่วงต่อคำขอต่ำกว่า ลูกค้ารายหนึ่งวัดเทียบกับระบบ multi-agent แล้วพบว่า loop เดียวทำงานเร็วขึ้นราว 2 เท่า ตัวเลขนี้เป็นผลจากกรณีหนึ่ง ไม่ควรนำไปคาดการณ์แทนการวัดกับงานของทีมเอง
- ดึงชุดทดสอบประเมินผลปัจจุบันมาใช้เป็นค่าฐาน แล้วติดตั้ง single-agent-loop-kit โดยโคลนคลังโค้ดและคัดลอก skill ไปยังโฟลเดอร์ทักษะของ Claude Code
- เริ่มใช้ skill ด้วยคำสั่ง Run the single-agent-loop skill แล้วให้เครื่องมือตรวจโค้ด orchestration และพิจารณา subagent ทีละตัว
- ทำตามสามระยะ Measure, Combine และ Fold โดยวัดผลก่อนและหลังทุกครั้ง หากคุณภาพลดลงให้หยุดการพับ subagent ตัวนั้น
ควรเก็บ subagent ไว้เมื่อการรวมทำให้ผลลัพธ์แย่ลงเพราะบริบทบวม เมื่อต้องทำงานอิสระหลายงานพร้อมกัน หรือเมื่อ agent เลือกเครื่องมือผิดและมีคำสั่งขัดกัน การแบ่งตามบริบทที่จำเป็นต้องแยกมักสมเหตุสมผลกว่าการสร้างตัวแทนแยกตามประเภทงาน






