Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

แก้ปัญหา API Claude Code

แก้ขีดจำกัด Claude Code ข้อผิดพลาด 500 ภาวะเกินกำลัง 529 และปัญหาคีย์ API

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

claude-code-diagnostics
$ claude-code run --model claude-sonnetAPI Error: rate limit reachedstatus=429 route=messages tokens=128k retries=3ขั้นต่อไป: ลดงานพร้อมกัน ตรวจสอบคีย์ และลองใหม่โดยเพิ่มช่วงรอ
4 กลุ่มข้อผิดพลาด1 ขั้นตอนตรวจสอบ3 รายการตรวจสอบเส้นทาง
คำถามจากชุมชน

คำถามที่ควรใช้วิเคราะห์ข้อผิดพลาด

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

Reddit

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

ขีดจำกัดมาจากบัญชี พื้นที่ทำงาน เส้นทางโมเดล หรือเกตเวย์?

ตรวจสอบขีดจำกัดบัญชี ลดงานพร้อมกันและขนาดบริบท แล้วลองใหม่
Reddit

คีย์ API หรือสมาชิก Pro หรือ Max

การยืนยันตัวตนปัจจุบันใช้สิทธิ์สมาชิกหรือการเรียกเก็บเงิน API?

ตรวจสอบสิทธิ์สมาชิกและการเรียกเก็บเงิน API แยกกัน เว้นแต่ผู้ให้บริการระบุว่าเชื่อมโยงกัน
X / Reddit

500 หรือ 529 ในวงรอบเอเจนต์

ผู้ให้บริการรับภาระเกินกำลัง เส้นทางเกตเวย์มีปัญหา หรือมีวงรอบลองใหม่ซ้ำอยู่?

บันทึกสถานะ ID คำขอ เส้นทาง โมเดล จำนวนโทเคน และจำนวนครั้งที่ลองใหม่ก่อนแก้โค้ด
แผนผังข้อผิดพลาด

เริ่มจากรหัสสถานะ

แยกปัญหาคีย์และสิทธิ์ โควตา ข้อผิดพลาดเซิร์ฟเวอร์ และภาระเกินกำลัง ก่อนเลือกวิธีแก้ไข

429

ถึงขีดจำกัดอัตรา

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

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

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

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

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

ภาระเกินกำลัง

บริการต้นทางมีภาระสูง การเปลี่ยนคีย์ API โดยทั่วไปไม่แก้ปัญหานี้

  • รอและเพิ่มช่วงห่าง
  • ลองโมเดลสำรอง
  • ลดขนาดคำขอ
  • ตรวจสอบสถานะและช่องทางสนับสนุน
401/403

คีย์ API หรือสิทธิ์เข้าถึง

คีย์ที่ใช้อาจผิด หรือไม่มีสิทธิ์เข้าถึงโมเดลหรือเอนด์พอยต์

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

รวบรวมข้อเท็จจริงก่อนแก้โค้ด

  1. บันทึกข้อผิดพลาดที่แน่นอน สถานะ HTTP โมเดล เอนด์พอยต์ และเวลา
  2. ยืนยันว่าใช้คีย์ Anthropic โดยตรงหรือเกตเวย์ที่เข้ากันได้
  3. ตรวจสอบการเรียกเก็บเงินและโควตา API แยกจากสถานะ Pro หรือ Max
  4. เมื่อพบ 429 ให้ลดงานพร้อมกันและขนาดบริบทก่อน
  5. เมื่อพบ 500 หรือ 529 ให้รอและลองใหม่หนึ่งครั้ง แล้วเปรียบเทียบเส้นทางหรือโมเดลสำรอง
  6. สำหรับเกตเวย์ ให้ตรวจสอบเอนด์พอยต์ Messages เส้นทางโมเดล พฤติกรรมแคช และคำแนะนำฝ่ายสนับสนุน

สิทธิ์ Pro หรือ Max ต่างจากการเรียกเก็บเงิน API

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

เริ่มใช้ API

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

ไคลเอนต์ที่เข้ากันได้กับ Claude ต้องมีเอนด์พอยต์ Messages ที่เหมาะสม คีย์ที่ใช้ได้ และเส้นทางโมเดลที่รองรับงานนั้น

ดูเอกสาร
คำถามที่พบบ่อย

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

ทำไม Claude Code แจ้งว่าถึงขีดจำกัดอัตรา?

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

Pro หรือ Max มีคีย์ API ให้ด้วยหรือไม่?

พิจารณาสิทธิ์สมาชิกและการเรียกเก็บเงิน API แยกกัน เว้นแต่หน้าบัญชีทางการระบุเป็นอย่างอื่น ตรวจสอบวิธียืนยันตัวตนและแหล่งเรียกเก็บเงินที่ใช้อยู่

ควรทำอย่างไรเมื่อพบ API Error 500?

เก็บ ID คำขอ รอแล้วลองใหม่หนึ่งครั้ง หากยังเกิดซ้ำ ให้เปรียบเทียบเส้นทางหรือติดต่อฝ่ายสนับสนุนพร้อมเวลา โมเดล และ ID

529 overloaded หมายถึงอะไร?

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

แหล่งอ้างอิง

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

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