คู่มือแก้ไขข้อผิดพลาด Claude ละเอียดยิบ: รหัสข้อผิดพลาดทั่วไปและวิธีแก้ไขที่ใช้ได้จริง

เจอข้อผิดพลาดตอนใช้ Claude อาจทำให้ปวดหัว ไม่ว่าคุณจะเป็นนักพัฒนา API หรือผู้ใช้ทั่วไป รหัสข้อผิดพลาดที่พบบ่อยก็มีวิธีแก้ไขที่ตรงจุด บทความนี้รวบรวมข้อผิดพลาดที่เจอบ่อยขณะใช้ Claude พร้อมขั้นตอนแก้ไขที่ผ่านการทดสอบแล้ว ช่วยให้คุณกลับมาคุยหรือเรียก API ได้เร็วขึ้น

ข้อผิดพลาดการเรียก API: การจำกัดอัตราและปัญหาการยืนยันตัวตน

ข้อผิดพลาดที่พบบ่อยที่สุดเมื่อเรียกใช้ Claude API คือ ข้อผิดพลาดเรื่องการจำกัดอัตรา (HTTP 429 Too Many Requests) สาเหตุเกิดจากจำนวนคำขอในช่วงเวลาที่กำหนดเกินโควต้าของบัญชี ต้องปรับความถี่ในการเรียกใช้หรืออัปเกรดแพ็กเกจ วิธีแก้ไขคือเพิ่ม logic การ retry แบบ exponential backoff ในโค้ด พร้อมตรวจสอบว่า API Key ถูกตั้งค่าเป็น environment variable อย่างถูกต้องแล้ว

ข้อผิดพลาดที่พบบ่อยอีกอย่างคือ การยืนยันตัวตนล้มเหลว (HTTP 401 Unauthorized) มักเกิดจาก API Key หมดอายุ คัดลอกแล้วมีช่องว่าง หรือ key ถูกเพิกถอน แนะนำให้สร้าง key ใหม่จาก Anthropic console และตรวจสอบพารามิเตอร์ x-api-key ใน header ว่าไม่มีข้อผิดพลาด หากใช้ reverse proxy ต้องแน่ใจว่าพร็อกซีเซิร์ฟเวอร์ไม่ได้เปลี่ยนแปลงข้อมูลการยืนยันตัวตน

ข้อผิดพลาดการสนทนาขัดข้องและข้อมูลบริบทหาย

ระหว่างการสนทนายาว ๆ ใน Claude อาจพบข้อความ "Conversation too long" หรือ "Token limit exceeded" เกิดจากจำนวน token สะสมของอินพุตและเอาต์พุตเกินความยาวของ context window ของโมเดล (เช่น Claude 3.5 Sonnet รองรับ 200K token) วิธีแก้ไขคือลบประวัติข้อความเก่าด้วยตนเอง เหลือเฉพาะส่วนสำคัญ หรือใช้พารามิเตอร์ max_tokens ควบคุมความยาวเอาต์พุต หลีกเลี่ยงการสร้างเนื้อหาที่ยาวเกินไปในครั้งเดียว

ผู้ใช้บางรายเจอข้อผิดพลาด "Chat prematurely terminated" ซึ่งมักเกิดจากความไม่เสถียรของเครือข่ายหรือเซิร์ฟเวอร์หมดเวลา ตรวจสอบความเสถียรของเครือข่ายภายในบ้าน เปลี่ยนเป็นการเชื่อมต่อแบบมีสาย หรือเปลี่ยนโหนด proxy หากเกิดบ่อยครั้ง ให้ปรับระยะเวลา timeout ของฝั่ง client เป็น 60 วินาทีขึ้นไป

ข้อผิดพลาดเกี่ยวกับบัญชีถูกบล็อกและการสมัครสมาชิก

ผู้ใช้ Claude Pro อาจพบ "Payment declined" หรือ "Billing error" ขณะต่ออายุการสมัคร สาเหตุทั่วไปคือยอดเงินในบัตรเครดิตไม่เพียงพอ ธนาคารปิดกั้นการทำธุรกรรม หรือที่อยู่ในการเรียกเก็บเงินไม่ตรงกัน แนะนำให้เปลี่ยนใช้บัตรที่รองรับการชำระเงินระหว่างประเทศ และตรวจสอบว่าข้อมูลการเรียกเก็บเงินตรงกับข้อมูลที่ธนาคารเก็บไว้ หากใช้บัตรเครดิตเสมือน ต้องแน่ใจว่าได้เปิดใช้งานการยืนยันตัวตนแบบ 3D

ข้อผิดพลาด "Account locked" อีกแบบมักเกิดจากการล็อกอินจากสถานที่ผิดปกติ ซึ่งกระตุ้นระบบรักษาความปลอดภัย ให้ล็อกอินเข้า Anthropic account จากนั้นไปที่การตั้งค่าความปลอดภัยเพื่อปลดล็อกอุปกรณ์ หรือทำการยืนยันผ่านอีเมลเพื่อเข้าถึงอีกครั้ง หลีกเลี่ยงการเปลี่ยน IP และภูมิภาคบ่อย ๆ ในเวลาสั้น เพื่อลดความเสี่ยงในการถูกตรวจจับว่าผิดปกติ

โมเดลไม่พร้อมใช้งานและข้อผิดพลาดพารามิเตอร์

เมื่อเรียก API แล้วได้รับ "Model not found" แสดงว่าชื่อโมเดลที่ระบุพิมพ์ผิด หรือโมเดลนั้นถูกยกเลิกไปแล้ว ต้องตรวจสอบเอกสารทางการเพื่ออัปเดตตัวระบุโมเดล เช่น ชื่อทางการของ Claude 3.5 Sonnet คือ claude-3-5-sonnet-20241022 พร้อมกันนี้ตรวจสอบว่าพารามิเตอร์คำขอไม่มีฟิลด์ที่ไม่รองรับ เช่น พารามิเตอร์ stream รุ่นเก่าถูกแทนที่ด้วย stream_options ในโมเดลใหม่

หากพบ "Invalid request body" โดยปกติเกิดจากรูปแบบ JSON ผิดพลาด หรือฟิลด์ที่จำเป็นขาดหายไป ใช้เครื่องมือตรวจสอบ JSON เพื่อตรวจสอบ body ของคำขอ ให้แน่ใจว่าโครงสร้างของ messages array ถูกต้อง และแต่ละข้อความมีคุณสมบัติ role และ content แนะนำให้ใช้ SDK อย่างเป็นทางการแทนการสร้างคำขอด้วยตนเอง ซึ่งช่วยหลีกเลี่ยงปัญหาด้านรูปแบบโดยอัตโนมัติ