การแก้ปัญหา Claude Code API

แก้ขีดจำกัด ข้อผิดพลาด 500 ภาวะโหลดเกิน 529 และปัญหา API Key

ขั้นตอนเดียวสำหรับการตั้งค่า API Key, Pro หรือ Max เทียบกับการเรียกเก็บเงิน API, endpoint ที่เข้ากันได้กับ Messages, ขีดจำกัด ข้อผิดพลาดเซิร์ฟเวอร์ และเส้นทางที่โหลดเกิน

เลือกเส้นทาง Claude Code API อ่านเอกสาร endpoint

claude-code-diagnostics

$ claude-code run --model claude-sonnetข้อผิดพลาด API: ถึงขีดจำกัดอัตราแล้วstatus=429 route=messages tokens=128k retries=3ถัดไป: ลดการทำงานพร้อมกัน ตรวจสอบ key แล้วลองใหม่แบบ backoff

4 กลุ่มข้อผิดพลาด1 คู่มือ0 หน้าที่มีเนื้อหาบาง

สัญญาณจากชุมชน

สิ่งที่นักพัฒนาถามซ้ำในพื้นที่สาธารณะ

รูปแบบที่เกิดซ้ำจาก Reddit และ X ถูกสรุปเป็นคำแนะนำแก้ปัญหาที่เสถียรและตรวจสอบได้

ถึงขีดจำกัดระหว่างการเขียนโค้ด

บัญชี workspace โมเดล หรือเส้นทางส่งคำขอหรือโทเคนมากกว่าที่อนุญาต

ลดเอเจนต์ที่ทำงานพร้อมกัน · ลดบริบทยาว

API Key เทียบกับสมาชิก Pro หรือ Max

ตรวจสอบ key ที่ใช้งาน Base URL และแหล่งเรียกเก็บเงิน อย่าคิดว่าสมาชิกและเครดิต API ใช้ยอดเดียวกัน

ตรวจสอบสิทธิ์โมเดล · แยกการเข้าสู่ระบบสมาชิกกับการเรียกเก็บเงิน API

X / Reddit

ข้อผิดพลาด 500 หรือ 529 ในลูปเอเจนต์

ผู้ให้บริการหรือเส้นทางส่งข้อผิดพลาดฝั่งเซิร์ฟเวอร์ การลองครั้งเดียวอาจสำเร็จ แต่การล้มเหลวซ้ำต้องใช้หลักฐานเส้นทาง บริการต้นทางมีโหลดสูง การเปลี่ยน API Key มักไม่ช่วย

เก็บ request id · ใช้ backoff

แผนผังข้อผิดพลาด

เริ่มจากรหัสสถานะ ไม่ใช่ข่าวลือ

วิธีที่เร็วที่สุดคือแยกปัญหา key โควตา เซิร์ฟเวอร์ และโหลดเกิน

429

ถึงขีดจำกัดอัตราแล้ว

บัญชี workspace โมเดล หรือเส้นทางส่งคำขอหรือโทเคนมากกว่าที่อนุญาต

ลดเอเจนต์ที่ทำงานพร้อมกัน
ลดบริบทยาว
ลองใหม่แบบ backoff
ตรวจสอบโควตาและขีดจำกัดโมเดล

500

ข้อผิดพลาดเซิร์ฟเวอร์ API

ผู้ให้บริการหรือเส้นทางส่งข้อผิดพลาดฝั่งเซิร์ฟเวอร์ การลองครั้งเดียวอาจสำเร็จ แต่การล้มเหลวซ้ำต้องใช้หลักฐานเส้นทาง

เก็บ request id
ลองใหม่หนึ่งครั้ง
เปลี่ยนเส้นทางหากเกิดซ้ำ
อย่าเริ่มด้วยการเขียนพรอมต์ใหม่

529

โหลดเกิน

บริการต้นทางมีโหลดสูง การเปลี่ยน API Key มักไม่ช่วย

ใช้ backoff
ใช้โมเดลสำรอง
ลดขนาดคำขอ
ตรวจสอบช่องทางสนับสนุน/สถานะ

401/403

ปัญหา API Key หรือสิทธิ์

Claude Code ไม่ได้ใช้ key ที่คาดไว้ หรือ key ไม่มีสิทธิ์เข้าถึงโมเดลหรือ endpoint

ยืนยัน ANTHROPIC_API_KEY
ตรวจสอบ Base URL
ตรวจสอบสิทธิ์โมเดล
แยกการเข้าสู่ระบบสมาชิกกับการเรียกเก็บเงิน API

คู่มือ

รวบรวมข้อมูลเหล่านี้ก่อนแก้โค้ด

จดข้อความผิดพลาด สถานะ HTTP โมเดล endpoint และเวลาให้ครบ
ยืนยันว่า Claude Code ใช้ key ของ Anthropic โดยตรงหรือ Base URL ของเกตเวย์ที่เข้ากันได้
ตรวจสอบการเรียกเก็บเงินและโควตา API แยกจากสถานะ Claude Pro หรือ Max
เมื่อเป็น 429 ให้ลดการทำงานพร้อมกันและขนาดบริบทก่อนเปลี่ยนผู้ให้บริการ
เมื่อเป็น 500 หรือ 529 ให้ลองใหม่หนึ่งครั้งแบบ backoff แล้วเปรียบเทียบเส้นทางหรือโมเดลสำรอง
หากใช้เกตเวย์ ให้ตรวจสอบ endpoint Messages เส้นทางโมเดล แคช และหน้าสนับสนุน

Pro หรือ Max ไม่เหมือนกับการเรียกเก็บเงิน API

รับสิทธิ์เข้าถึง API

ใช้เกตเวย์หรือไม่? ตรวจสอบ endpoint Messages

ไคลเอนต์แบบ Claude Code มักต้องใช้ endpoint ที่เข้ากันได้กับ Messages, API Key ที่ถูกต้อง และเส้นทางโมเดลที่รองรับงาน

ดูเอกสาร

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

ข้อผิดพลาด Claude Code API

เหตุใด Claude Code จึงแจ้งว่าถึงขีดจำกัด?

บัญชี workspace โมเดล หรือเส้นทางส่งคำขอหรือโทเคนมากกว่าที่อนุญาต ลดเอเจนต์ที่ทำงานพร้อมกัน · ลดบริบทยาว · ลองใหม่แบบ backoff · ตรวจสอบโควตาและขีดจำกัดโมเดล

Claude Pro หรือ Max รวม API Key หรือไม่?

ควรทำอย่างไรเมื่อเจอข้อผิดพลาด API 500?

ผู้ให้บริการหรือเส้นทางส่งข้อผิดพลาดฝั่งเซิร์ฟเวอร์ การลองครั้งเดียวอาจสำเร็จ แต่การล้มเหลวซ้ำต้องใช้หลักฐานเส้นทาง เก็บ request id · ลองใหม่หนึ่งครั้ง · เปลี่ยนเส้นทางหากเกิดซ้ำ · อย่าเริ่มด้วยการเขียนพรอมต์ใหม่

โหลดเกิน 529 หมายความว่าอะไร?

บริการต้นทางมีโหลดสูง การเปลี่ยน API Key มักไม่ช่วย ใช้ backoff · ใช้โมเดลสำรอง · ลดขนาดคำขอ · ตรวจสอบช่องทางสนับสนุน/สถานะ

แหล่งข้อมูล

ตรวจสอบกฎปัจจุบันได้ที่ไหน

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

การยืนยันตัวตน Claude Code ข้อผิดพลาด Anthropic API ขีดจำกัด Anthropic API การสนทนาเรื่องขีดจำกัด Claude Code บน Reddit ค้นหาเรื่องขีดจำกัด Claude Code บน X