วิธีแก้ปัญหา Claude ติดขีดจำกัดการใช้งาน (Usage Limits)

ขีดจำกัดการใช้งานของ Claude คืออะไร

ขีดจำกัดการใช้งานของ Claude แบ่งออกเป็นสองระบบแยกจากกัน สิ่งแรกที่ต้องทำคือตรวจสอบว่าคุณติดขัดที่ระบบใด การสมัครสมาชิก Claude (Pro, Max, Team หรือ Enterprise แบบรายที่นั่ง) จะให้โควตาการใช้งานแบบหมุนเวียนซึ่งใช้ร่วมกันในทุกโมเดล ยกเว้นขีดจำกัดบางประการของตระกูลโมเดล และใช้ร่วมกับการแชทใน Claude ดังนั้นระบบจะหยุดการทำงานของคุณด้วยข้อความเช่น You've hit your session limit · resets 3:45pm สำหรับแผน Enterprise แบบคิดค่าบริการตามการใช้งานในปัจจุบันจะเป็นข้อยกเว้น คือไม่มีโควตาที่รวมมาให้ และการใช้งานทั้งหมดจะถูกคิดค่าบริการตามอัตรา API ตั้งแต่ token แรก ส่วน Claude API จะวัดผลอีกรูปแบบหนึ่ง คือความเร็วในการส่งคำขอและจำนวน token ซึ่งนับเป็นรายนาที ระบบจะหยุดการทำงานของคุณด้วยข้อผิดพลาด HTTP 429 ประเภท rate_limit_error โดยปกติจะมี header retry-after ระบุจำนวนวินาทีที่ต้องรอ

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

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

คุณติดขีดจำกัดใด? โปรดอ่านข้อความที่ระบุไว้ให้ชัดเจน

Claude Code จะระบุชื่อระบบไว้ในข้อความที่แสดงผล โปรดตรวจสอบให้ตรงกับระบบของคุณก่อนทำการเปลี่ยนแปลงใดๆ

• You've hit your session limit · resets 3:45pm คือขีดจำกัดของแพ็กเกจสมาชิก โควตาการใช้งานแบบหมุนเวียนสำหรับรอบปัจจุบันของคุณถูกใช้จนหมดแล้ว
• You've hit your weekly limit · resets Mon 12:00am คือระบบเดียวกันแต่เป็นขีดจำกัดในรอบระยะเวลาที่ยาวกว่า
• You've hit your Opus limit · resets 3:45pm คือขีดจำกัดของแพ็กเกจสมาชิกที่บังคับใช้เฉพาะกับคำขอที่ใช้โมเดล Opus การเปลี่ยนไปใช้โมเดลนอกตระกูล Opus จะช่วยให้คุณทำงานต่อได้
• You've hit your Sonnet limit · resets 3:45pm คือขีดจำกัดประเภทเดียวกันสำหรับตระกูลโมเดล โดยบังคับใช้เฉพาะกับคำขอที่ใช้โมเดล Sonnet การเปลี่ยนไปใช้โมเดลนอกตระกูล Sonnet จะช่วยให้คุณทำงานต่อได้
• ข้อความที่ขึ้นต้นด้วย Fable limit reached หมายความว่าคุณได้ใช้โควตาประจำสัปดาห์ในส่วนที่จัดสรรไว้สำหรับโมเดล Fable จนครบแล้ว การใช้งานต่อจะมีค่าใช้จ่ายหักจากเครดิตการใช้งาน Claude Code จึงขอให้คุณยืนยันก่อนดำเนินการ เลือกโมเดลอื่นด้วย /model เพื่อให้อยู่ภายใต้ขอบเขตของแพ็กเกจของคุณ
• API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com. คือขีดจำกัดอัตราการเรียกใช้งาน API (Rate limit) คุณใช้งานถึงขีดจำกัดที่ตั้งค่าไว้สำหรับ API key ของคุณ หรือสำหรับโปรเจกต์ Amazon Bedrock หรือ Google Cloud ของคุณ ซึ่งข้อใดจะมีผลนั้นขึ้นอยู่กับ วิธีการตรวจสอบสิทธิ์ของไคลเอนต์ เนื่องจากไคลเอนต์ Bedrock หรือ Vertex จะถูกวัดปริมาณการใช้งานเทียบกับโควตาของโปรเจกต์บนคลาวด์ของคุณ แทนที่จะเป็นขององค์กร Anthropic
• API Error: Server is temporarily limiting requests (not your usage limit) คือการจำกัดความเร็วชั่วคราวที่ไม่เกี่ยวข้องกับโควตาแพ็กเกจของคุณ Claude Code จะพยายามเชื่อมต่อใหม่โดยอัตโนมัติพร้อมการหน่วงเวลา (backoff) ก่อนที่จะแสดงบรรทัดดังกล่าวให้คุณเห็น

ขีดจำกัดการใช้งาน: เซสชัน, รายสัปดาห์ และช่วงเวลาของ Opus

แผน Pro, Max, Team หรือ Enterprise แบบคิดตามจำนวนที่นั่ง (seat-based) จะมาพร้อมกับโควตาการใช้งานแบบหมุนเวียน เมื่อโควตาหมดลง Claude Code จะบล็อกคำขอเพิ่มเติมจนกว่าจะถึงเวลารีเซ็ตที่ระบุในข้อความ คุณสมบัติสองประการของโควตานี้เป็นสาเหตุหลักของความสับสน

• โควตานี้ใช้ร่วมกับ Claude chat งานที่คุณทำบน claude.ai จะหักจากโควตาเดียวกันกับงานในเทอร์มินัล ดังนั้นการใช้งานแชทอย่างหนักในช่วงบ่ายจะทำให้โควตาสำหรับการเขียนโค้ดในช่วงเย็นของคุณลดลง ทุกช่องทางที่คุณลงชื่อเข้าใช้ด้วยบัญชีนั้นจะดึงข้อมูลจากแหล่งเดียวกัน ดังนั้นบน Linux แอปเดสก์ท็อปเวอร์ชันเบต้าและ Claude Code CLI จะใช้โควตาร่วมกัน ไม่ใช่แยกกัน
• โควตานี้ใช้ร่วมกันในทุกโมเดล ขีดจำกัดรายเซสชันและรายสัปดาห์เป็นแหล่งรวมสำหรับทุกโมเดล ข้อยกเว้นคือเพดานของตระกูลโมเดลที่อยู่ภายในแหล่งรวมนั้น ได้แก่ ขีดจำกัดของ Opus และ Sonnet และในที่นั่งแบบ Max และ Premium จะมีการจัดสรร Fable ไว้สูงสุด 50% ของขีดจำกัดรายสัปดาห์ของคุณ สำหรับที่นั่งแบบ Pro และ Standard นั้น Fable จะไม่รวมอยู่ในขีดจำกัดของแผน และจะคิดค่าบริการตามเครดิตการใช้งานตั้งแต่คำขอแรก

สำหรับ Claude for Teams และ Enterprise แบบคิดตามจำนวนที่นั่ง รูปแบบที่ระบุไว้คือโควตาต่อที่นั่งซึ่งจะรีเซ็ตตามช่วงเวลาหมุนเวียน 5 ชั่วโมงและช่วงเวลารายสัปดาห์ โดยใช้ร่วมกับ Claude chat และ Cowork และกำหนดขนาดตามระดับที่นั่ง (Standard หรือ Premium) แผน Enterprise แบบคิดตามการใช้งานในปัจจุบันทำงานแตกต่างออกไป คือไม่มีโควตาที่รวมมาให้จนกว่าจะหมด แต่การใช้งานจะถูกคิดค่าบริการตามอัตรา API และเพดานการใช้งานคือขีดจำกัดการใช้จ่ายที่ผู้ดูแลระบบกำหนดไว้ในระดับองค์กรและสำหรับผู้ใช้แต่ละราย ในแผนที่ได้รับความช่วยเหลือด้านการขาย การใช้งานที่ถูกหยุดโดยขีดจำกัดการใช้จ่ายจะกลับมาใช้งานได้อีกครั้งเมื่อเริ่มรอบบิลถัดไป เว้นแต่เจ้าของบัญชีจะเพิ่มขีดจำกัดก่อน ในแผนแบบบริการตนเอง (self-serve) การใช้งานจะหยุดลงเมื่อยอดเครดิตที่ชำระล่วงหน้าหมดลง จนกว่าเจ้าของบัญชีจะซื้อเพิ่ม ในแผน Pro และ Max เวลาที่ระบุในข้อความและแถบ /usage ของคุณเองคือตัวเลขที่เชื่อถือได้ ไม่ใช่ตัวเลขที่คัดลอกมาจากบล็อกโพสต์ หากคุณยังคงตัดสินใจเลือกระดับแผน แผน Claude ที่คุณต้องการ จะเปรียบเทียบสิ่งที่แต่ละแผนจำกัดไว้ให้คุณทราบ

เหตุใดการสลับโมเดลด้วย /model จึงไม่ช่วยกู้คืนเซสชันหรือขีดจำกัดรายสัปดาห์

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

ข้อยกเว้นคือเพดานการใช้งานของตระกูลโมเดล หากข้อความแจ้งเตือนระบุ You've hit your Opus limit หรือ You've hit your Sonnet limit ดังนั้น /model คือวิธีแก้ไขที่ถูกต้อง ให้สลับไปใช้โมเดลที่อยู่นอกตระกูลนั้นแล้วทำงานต่อได้ทันที เนื่องจากมีการบล็อกเฉพาะคำขอของตระกูลโมเดลนั้นเท่านั้น ขีดจำกัดของ Fable สำหรับสิทธิ์ใช้งานระดับ Max และ Premium ก็ทำงานในลักษณะเดียวกัน: ให้สลับไปใช้โมเดลอื่นเพื่อทำงานต่อภายใต้แผนของคุณ หรือใช้งาน Fable ต่อโดยใช้ usage credits อย่างไรก็ตาม Fable จะดึงโควตารายสัปดาห์ที่ใช้ร่วมกันเร็วกว่าโมเดลอื่น ดังนั้นการสลับโมเดลหลังจากถึงขีดจำกัดของ Fable จะไม่ทำให้คุณใช้งานเกินขีดจำกัดรายสัปดาห์โดยรวมได้

การมองว่าขีดจำกัดดังกล่าวเป็นบั๊กคือความเข้าใจผิดประการที่สอง การติดตั้งใหม่หรือการยืนยันตัวตนใหม่ไม่ช่วยเปลี่ยนแปลงสิ่งใด โควตาจะกลับมาเมื่อครบกำหนดรอบเวลา เมื่อคุณใช้สิทธิ์รีเซ็ตขีดจำกัดฟรี หรือเมื่อคุณซื้อ usage credits เพิ่มเติม

สิ่งที่ควรทำเมื่อพบข้อจำกัดของแพ็กเกจสมาชิก

1. ตรวจสอบเวลาที่ระบบจะรีเซ็ต เนื่องจากช่วงเวลาของเซสชันนั้นสั้น แต่ช่วงเวลารายสัปดาห์ไม่ใช่สิ่งที่คุณจะนั่งรอที่โต๊ะทำงานได้ สำหรับ Claude Code v2.1.234 หรือใหม่กว่า /rate-limit-options สามารถรอเวลาการรีเซ็ตและทำงานที่ค้างอยู่ต่อได้โดยอัตโนมัติ
2. หากเป็นข้อจำกัดของรุ่น Opus, Sonnet หรือ Fable ให้รันคำสั่ง /model แล้วเลือกรุ่นอื่นที่อยู่นอกกลุ่มผลิตภัณฑ์ดังกล่าว
3. รันคำสั่ง /usage เพื่อดูข้อจำกัดของแพ็กเกจ แถบสถานะการใช้งาน และเวลาที่จะรีเซ็ต /cost เป็นคำสั่ง alias สำหรับหน้าจอเดียวกัน
4. ตรวจสอบที่ Settings > Usage บน claude.ai หรือใน Claude Desktop เพื่อดูส่วน Resets แพ็กเกจที่มีสิทธิ์จะได้รับข้อเสนอให้รีเซ็ตข้อจำกัดฟรีเป็นครั้งคราว การคลิก "Reset for free" จะรีเซ็ตข้อจำกัดของเซสชัน 5 ชั่วโมงหรือข้อจำกัดรายสัปดาห์ของคุณให้กลับมาเต็มทันที ขึ้นอยู่กับว่าข้อเสนอนั้นครอบคลุมส่วนใด ปุ่มนี้ไม่มีให้ใช้งานใน Claude Code บนเทอร์มินัลหรือ IDE หรือบน Claude Mobile และข้อเสนอแต่ละรายการมีวันหมดอายุ
5. รันคำสั่ง /usage-credits เพื่อทำงานต่อหลังจากถึงขีดจำกัดแล้ว สำหรับแพ็กเกจ Pro และ Max ระบบจะเปิดการตั้งค่าการเรียกเก็บเงินของคุณ สำหรับแพ็กเกจ Team และ Enterprise ระบบจะเปิดการตั้งค่าการใช้งานขององค์กร หรือส่งคำขอไปยังผู้ดูแลระบบของคุณหากคุณไม่มีสิทธิ์เข้าถึงการเรียกเก็บเงิน
6. หากคุณพบข้อจำกัดเดิมทุกสัปดาห์ แสดงว่าแพ็กเกจนั้นไม่เหมาะสมกับวิธีการทำงานของคุณ และ แนวทางแก้ไขเมื่อถึงขีดจำกัดการใช้งาน เป็นสิ่งที่ควรพิจารณาเพียงครั้งเดียว แทนที่จะต้องมาจัดการทุกครั้งที่มีการรีเซ็ต

/usage-credits จำเป็นต้องมีการสมัครสมาชิก claude.ai ที่ลงชื่อเข้าใช้ผ่าน /login บริการนี้ไม่สามารถใช้งานได้กับการยืนยันตัวตนด้วย API key เนื่องจาก API key ไม่มีโควตาแพ็กเกจให้ขยายเพิ่ม

เครดิตการใช้งานมีผลข้างเคียงประการหนึ่งที่ควรทราบไว้ก่อน โดยปกติแล้ว Claude Code จะให้ prompt cache สำหรับบทสนทนาหลักของคุณเป็นเวลาหนึ่งชั่วโมงในขณะที่คุณยังอยู่ภายใต้การใช้งานที่รวมอยู่ในแพ็กเกจสมาชิก และจะลดเหลือห้านาทีเมื่อคุณเริ่มใช้เครดิต ทำให้การโต้ตอบหลายครั้งต้องเริ่มใหม่แบบ cold start และ การใช้โทเค็นของ Claude Code จะเพิ่มขึ้นสำหรับงานเดิม Subagent จะอยู่นอกกลุ่มบทสนทนาหลักนั้น จึงได้รับเวลาห้านาทีแม้จะยังอยู่ภายใต้การใช้งานตามแพ็กเกจ การเลือก TTL ด้วยตนเองผ่านการตั้งค่า promptCacheTtl หรือ CLAUDE_CODE_PROMPT_CACHE_TTL บน Claude Code v2.1.242 หรือใหม่กว่า จะช่วยรักษาอายุการใช้งานหนึ่งชั่วโมงไว้ได้ในขณะที่คุณใช้เครดิตอยู่

ข้อความที่ดูเหมือนขีดจำกัดการใช้งานแต่ไม่ใช่

ข้อผิดพลาดของ Claude Code สี่รายการมักถูกรายงานว่าเป็นขีดจำกัดการใช้งาน ทั้งที่ความจริงไม่ใช่

• คำเตือนเรื่อง context หรือการ auto-compact ไม่ใช่ขีดจำกัดการใช้งาน /context จะแสดงบรรทัดเช่น Context exceeds the 200k-token limit by 94k tokens ตามด้วยคำสั่งที่ใช้เพิ่มพื้นที่ว่าง เมื่อบทสนทนามีขนาดเกินหน้าต่าง context ของโมเดล การ compact จะสรุปประวัติเก่าเพื่อเพิ่มพื้นที่ว่าง แต่กระบวนการนี้ไม่ได้ฟรี: /compact จะอ่านบทสนทนาที่กำลังสรุป ดังนั้นการ compact context ขนาดใหญ่จึงถือเป็นคำขอขนาดใหญ่ที่หักจากแผนของคุณ หากคุณต้องการเริ่มต้นใหม่แทนที่จะใช้ความต่อเนื่อง /clear จะไม่มีค่าใช้จ่ายใดๆ
• Prompt is too long · automatic compaction failed: <the underlying error> หมายความว่าการ compact อัตโนมัติล้มเหลวจากข้อผิดพลาดที่ระบุไว้ /compact จะล้มเหลวซ้ำๆ ด้วยข้อผิดพลาดเดิมจนกว่าคุณจะแก้ไข
• Credit balance is too low หมายความว่าองค์กรใน Console ของคุณเครดิตแบบเติมเงินหมด หรือ Claude Code กำลังส่งคำขอของผู้สมัครสมาชิกผ่าน API key ของ Console; /status จะแสดงว่า credential ใดที่กำลังใช้งานอยู่ คุณสามารถเพิ่มเครดิตได้ที่ platform.claude.com/settings/billing ซึ่งมีระบบเติมเงินอัตโนมัติให้เลือกใช้ด้วย
• API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context เป็นการตรวจสอบสิทธิ์ ไม่ใช่โควตาที่หมดลง หากคุณเลือกตัวแปร [1m] ของ Opus 4.6 หรือ Sonnet 4.6 ให้เลือกตัวแปรที่ไม่มีคำต่อท้าย [1m] หรือตั้งค่า CLAUDE_CODE_DISABLE_1M_CONTEXT=1 หากข้อความนี้ปรากฏขึ้นระหว่างบทสนทนาเนื่องจาก context มีขนาดเกิน 200K tokens ตัว Claude Code จะทำการ compact กลับมาให้อยู่ภายใต้ขีดจำกัดมาตรฐานโดยอัตโนมัติ สำหรับ Sonnet 5 ขึ้นไป, Opus 4.7 ขึ้นไป, Haiku 5.5 และโมเดลตระกูล Fable จะทำงานด้วยหน้าต่างขนาด 1M โดยกำเนิดและไม่มีคำต่อท้ายให้ลบออก ตัวแปรดังกล่าวคือสิ่งที่จำกัดขนาดไว้ที่ 200K

อีกหนึ่งข้อผิดพลาดมาจาก API โดย 413 request_too_large เป็นการจำกัดขนาดของคำขอเดี่ยว ไม่ใช่การจำกัดอัตราการใช้งาน (rate limit)

API rate limits: การนับจำนวนของสถานะ 429

Messages API จะวัดค่าสามอย่างแยกกันสำหรับโมเดลแต่ละคลาส:

• จำนวนคำขอต่อนาที (RPM)
• จำนวน input tokens ต่อนาที (ITPM)
• จำนวน output tokens ต่อนาที (OTPM)

องค์กรของคุณยังมีขีดจำกัดการใช้จ่าย (spend limit) ซึ่งเป็นคนละเรื่องกัน โดยเป็นค่าใช้จ่ายสูงสุดต่อเดือนสำหรับการใช้งาน API เมื่อคุณใช้งานถึงเพดานการใช้จ่ายของระดับ (tier) ของคุณ การใช้งาน API จะหยุดลงจนกว่าจะถึงเดือนถัดไป เว้นแต่คุณจะขอเพิ่มขีดจำกัด สถานะนี้จะแสดงเป็น 429 rate_limit_error เช่นกัน แต่จะไม่มี header retry-after และมีค่า enforced_spend_limit_reached อยู่ใน error.details.error_code ซึ่งการทำ retry loop จะไม่สามารถแก้ไขปัญหานี้ได้ หากคุณตั้งค่าขีดจำกัดการใช้จ่ายที่ต่ำกว่าไว้เองใน Console จะแสดงผลต่างออกไป โดยคำขอจะส่งกลับเป็น HTTP 400 invalid_request_error พร้อมข้อความที่ขึ้นต้นด้วย You have reached your specified API usage limits ซึ่งการเพิ่มหรือลบขีดจำกัดดังกล่าวจะทำให้กลับมาใช้งานได้ตามปกติ

กลไกสี่ประการเป็นตัวกำหนดว่าเมื่อใดที่สถานะ 429 จะเกิดขึ้น:

• ขีดจำกัดแยกตามคลาสของโมเดล: ขีดจำกัดจะถูกนำไปใช้กับโมเดลแต่ละตัวแยกกัน ดังนั้นคุณจึงสามารถใช้โมเดลที่แตกต่างกันได้พร้อมกันจนถึงขีดจำกัดของแต่ละโมเดล โมเดลบางตระกูลใช้ถังเก็บข้อมูล (bucket) ร่วมกัน เช่น ขีดจำกัดของ Opus เป็นยอดรวมของ Claude Opus 4.8, Opus 4.7, Opus 4.6 และ Opus 4.5 ในขณะที่ Claude Sonnet 5 จะมีขีดจำกัดแยกต่างหาก
• ความจุจะถูกเติมเต็มอย่างต่อเนื่อง: API ใช้อัลกอริทึม token bucket ดังนั้นความจุจะถูกเติมเต็มอย่างต่อเนื่องแทนที่จะรีเซ็ตในเวลาที่กำหนด ขีดจำกัดที่ 60 คำขอต่อนาทีอาจถูกบังคับใช้เป็นหนึ่งคำขอต่อวินาที ดังนั้นการส่ง 60 คำขอพร้อมกันในคราวเดียวจะยังคงล้มเหลว
• เฉพาะ input ที่ไม่ได้แคชเท่านั้นที่จะถูกนับรวมใน ITPM สำหรับโมเดลส่วนใหญ่: input_tokens และ cache_creation_input_tokens จะถูกนับรวม ส่วน cache_read_input_tokens จะไม่ถูกนับในโมเดล Claude ส่วนใหญ่ โดยมี Claude Haiku 3.5 เป็นข้อยกเว้นตามเอกสาร ดังนั้นการทำ Caching จึงช่วยเพิ่มพื้นที่ว่างของ rate-limit นอกเหนือไปจากการได้รับส่วนลด ในส่วนของ output นั้น max_tokens ที่สูงจะไม่ถูกนำไปนับรวมกับ OTPM เนื่องจาก OTPM จะนับเฉพาะโทเค็นที่ถูกสร้างขึ้นจริงเท่านั้น
• ขีดจำกัดมีผลในระดับองค์กร: Workspace สามารถกำหนดขีดจำกัดที่ต่ำกว่าได้ และขีดจำกัดของทั้งองค์กรจะมีผลเสมอแม้ว่าผลรวมของขีดจำกัดในแต่ละ workspace จะมากกว่าก็ตาม ขีดจำกัดที่คุณไม่ได้แก้ไขในระดับ workspace จะถูกสืบทอดมาจากระดับองค์กร ไม่ใช่การปล่อยให้ไม่มีขีดจำกัด

ระดับ (tier) ที่ชื่อว่า Start, Build, Scale และ Custom จะเป็นตัวกำหนดตัวเลขจริง ซึ่งจะถูกกำหนดโดยอัตโนมัติจากประวัติการใช้งานและสถานะบัญชีของคุณ องค์กรใหม่และองค์กรที่มีประวัติการใช้งานน้อยอาจเริ่มต้นในระดับ Evaluation ซึ่งต่ำกว่าขีดจำกัดมาตรฐานที่ประกาศไว้ ดังนั้นสถานะ 429 ครั้งแรกอาจเกิดขึ้นเร็วกว่าที่ตารางคาดการณ์ไว้ การเพิ่มขึ้นของการใช้งานอย่างรวดเร็วจะกระตุ้นขีดจำกัดการเร่งความเร็ว (acceleration limits) ซึ่งจะส่งสถานะ 429 กลับมาในขณะที่คุณยังอยู่ในระดับ tier ของคุณ ดังนั้นควรค่อยๆ เพิ่มปริมาณ traffic ตัวเลขที่ประกาศไว้ทั้งหมดคือเพดานสูงสุด: ขีดจำกัดตามเอกสารคือการใช้งานสูงสุดที่อนุญาต ไม่ใช่ค่าขั้นต่ำที่รับประกัน หากต้องการขอเพิ่ม ให้ใช้ "Request tier increase" ในหน้า Rate limits บน Claude Console

การอ่านค่า 429: retry-after, ส่วนหัว (headers) และการลองใหม่โดย SDK

ข้อผิดพลาดของ API ทุกรายการจะส่งคืนโครงสร้างข้อมูลเดียวกัน คือออบเจกต์ error แบบซ้อนที่ระบุประเภทและข้อความแจ้งเตือน พร้อมด้วย request_id ในระดับบนสุด

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "<names the rate limit you exceeded>"
  },
  "request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}

ข้อมูลส่วนที่เหลือจะอยู่ในส่วนหัว (headers)

• retry-after คือจำนวนวินาทีที่ต้องรอจนกว่าคุณจะสามารถส่งคำขอซ้ำได้ การลองใหม่ก่อนเวลานี้จะล้มเหลว ไม่ใช่ข้อผิดพลาด 429 ทุกรายการที่จะมีส่วนหัวนี้ และ 429 ที่เกิดจาก spend-cap จะไม่มีส่วนหัวนี้เสมอ
• anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining และ anthropic-ratelimit-requests-reset อธิบายงบประมาณคำขอของคุณ
• anthropic-ratelimit-input-tokens-* และ anthropic-ratelimit-output-tokens-* แสดงข้อมูลเดียวกันสำหรับ ITPM และ OTPM โดยมีส่วนต่อท้ายเป็น limit, remaining และ reset เช่นเดียวกัน
• anthropic-ratelimit-tokens-* แสดงค่าสำหรับขีดจำกัดที่เข้มงวดที่สุดที่มีผลอยู่ในขณะนั้น

ส่วนหัว reset เป็นการประทับเวลาตามมาตรฐาน RFC 3339 ส่วนหัว remaining token จะถูกปัดเศษให้เป็นหลักพัน ดังนั้นให้ใช้ค่าเหล่านี้เป็นเพียงตัวบ่งชี้ระดับ (gauge) เท่านั้น โหมด Fast มีพูลของตัวเองและมีส่วนหัว anthropic-fast-* แยกต่างหาก ให้ตรวจสอบค่าเหล่านี้ทั้งหมดจากการเรียกใช้งานที่สำเร็จทุกครั้ง:

curl -s -D - -o /dev/null https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}' \
  | grep -i 'ratelimit\|retry-after\|request-id'

การตอบกลับทุกรายการจะมีส่วนหัว request-id ที่ไม่ซ้ำกัน เช่น req_018EeWyXxfu5pfWkrYcMdjWG โดยจะปรากฏเป็น request_id ในเนื้อหาข้อผิดพลาด และเป็น _request_id ในการตอบกลับของ Python SDK และ TypeScript SDK โปรดระบุค่านี้เมื่อคุณติดต่อฝ่ายสนับสนุน

ตรวจสอบว่าคุณจำเป็นต้องเขียนลูป backoff หรือไม่ก่อนที่จะเริ่มเขียนจริง SDK อย่างเป็นทางการจะลองใหม่โดยอัตโนมัติเมื่อเกิดความล้มเหลวชั่วคราว ซึ่งรวมถึงข้อผิดพลาดในการเชื่อมต่อ, การจำกัดอัตรา (rate limits) และข้อผิดพลาดเซิร์ฟเวอร์ระดับ 5xx โดยใช้การหน่วงเวลาแบบ exponential backoff ซึ่งโดยค่าเริ่มต้นจะลองใหม่ 2 ครั้ง และจะปฏิบัติตามส่วนหัว retry-after หากมีระบุไว้ ไคลเอ็นต์แต่ละตัวรองรับตัวเลือก maximum-retries เพื่อปรับเปลี่ยนหรือปิดใช้งานพฤติกรรมดังกล่าว

import anthropic

client = anthropic.Anthropic(max_retries=5)  # the SDK default is 2

try:
    msg = client.messages.create(
        model="claude-sonnet-5",
        max_tokens=1024,
        messages=[{"role": "user", "content": "hello"}],
    )
except anthropic.RateLimitError as err:
    headers = err.response.headers
    print("still limited after retries; wait", headers.get("retry-after"), "seconds")
    print("request id:", headers.get("request-id"))

ข้อผิดพลาด 529 overloaded ไม่ใช่ความผิดของคุณ

รหัส 429 หมายความว่าคุณส่งคำขอเร็วเกินไป ส่วนรหัส 529 overloaded_error หมายความว่า API กำลังรับภาระหนักชั่วคราว ซึ่งอาจเกิดขึ้นได้เมื่อ API มีปริมาณการใช้งานสูงจากผู้ใช้ทั้งหมด ไม่ได้เกิดจาก key หรือโค้ดของคุณแต่อย่างใด ให้ลองส่งคำใหม่อีกครั้งโดยใช้กลยุทธ์ exponential backoff ซึ่ง SDK ได้จัดการเรื่องนี้สำหรับสถานะ 5xx ไว้ให้แล้ว และให้ตรวจสอบสถานะที่ status.claude.com หากปัญหายังไม่คลี่คลาย สำหรับรหัส 500 api_error นั้นเป็นข้อผิดพลาดภายในระบบ ซึ่งคุณสามารถลองส่งคำขอใหม่ด้วยวิธีเดียวกัน ทั้งสองกรณีนี้ไม่ใช่การจำกัดอัตราการใช้งาน (rate limit)

อ่านขีดจำกัดของคุณเองแทนการดูตาราง

สำหรับบัญชีแบบสมัครสมาชิก /usage คือหน้าจอที่สำคัญที่สุด โดยจะแสดงแถบการใช้งานตามแผนของคุณและรายละเอียดว่าส่วนใดที่ใช้โควตาไปบ้าง และ d หรือ w ใช้สำหรับสลับระหว่างช่วงเวลา 24 ชั่วโมงล่าสุดกับ 7 วันล่าสุด มีข้อควรระวังสองประการคือ บล็อก Session จะแสดงการใช้งาน API token ซึ่งมีไว้สำหรับผู้ใช้ API ดังนั้นผู้สมัครสมาชิกทั่วไปสามารถละเว้นตัวเลขดอลลาร์ในส่วนนี้ได้ ตัวเลขเหล่านี้มาจากประวัติเซสชันในเครื่องนั้นๆ ดังนั้นการใช้งานจากอุปกรณ์อื่นหรือจาก claude.ai จะไม่ถูกรวมอยู่ในนี้

ในส่วนของ API หน้า Usage ใน Claude Console จะแสดงกราฟสองรายการ ได้แก่ "Rate Limit - Input Tokens" และ "Rate Limit - Output Tokens" กราฟ Input จะพล็อตค่าสูงสุดรายชั่วโมงของ input tokens ที่ไม่ได้แคชต่อนาทีเทียบกับขีดจำกัด ITPM ปัจจุบันของคุณ โดยมีอัตราการแคชแสดงอยู่ข้างๆ เพื่อให้คุณเฝ้าสังเกตขีดจำกัดก่อนที่จะถึงขีดจำกัดจริงในระหว่างการใช้งานจริง (production)

หากต้องการอ่านขีดจำกัดที่คุณตั้งค่าไว้ผ่านโปรแกรม:

curl -s https://api.anthropic.com/v1/organizations/rate_limits \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

การดำเนินการนี้จำเป็นต้องใช้ข้อมูลรับรอง Admin API ได้แก่ Admin API key, OAuth token ที่มีขอบเขต org:admin หรือคีย์ของบัญชีส่วนบุคคลหรือบัญชีบริการที่ไม่ได้จำกัดขอบเขตไว้ที่ workspace ใด workspace หนึ่ง คีย์ API ของ workspace จะไม่สามารถใช้งานได้ GET /v1/organizations/workspaces/{workspace_id}/rate_limits ทำหน้าที่เดียวกันในระดับราย workspace ทั้งสองคำสั่งเป็นแบบอ่านได้อย่างเดียว หากต้องการเปลี่ยนขีดจำกัด ให้ใช้หน้า Rate limits ใน Console

การใช้ less เพื่อลดข้อจำกัด

ทั้งสองระบบมีการวัดผลในลักษณะเดียวกัน ดังนั้นวิธีการเหล่านี้จึงใช้ได้กับทั้งคู่

• ใช้ token ต่อรอบให้น้อยลง การทำงานต่อเนื่องช่วยรักษา cache ให้พร้อมใช้งาน และ /clear ระหว่างงานที่ไม่เกี่ยวข้องกันนั้นไม่มีค่าใช้จ่าย การใช้งาน token ของ Claude Code อธิบายรายละเอียดเกี่ยวกับกลไกเหล่านี้ไว้อย่างครบถ้วน
• ลดความพยายามในการประมวลผล ระดับการทำงานคือ low, medium, high, xhigh และ max เมนู /effort ยังมีตัวเลือก ultracode ซึ่งเป็นการเพิ่มการใช้จ่ายแทนที่จะลดลง การใช้การคิดวิเคราะห์เชิงลึกกับงานเปลี่ยนชื่อไฟล์ทั่วไปนั้นไม่ก่อให้เกิดประโยชน์
• ลดการทำงานแบบขนานหลังจากพบข้อผิดพลาด 429 ให้ลดค่า CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY และหลีกเลี่ยงการใช้ subagent ทำงานพร้อมกันจำนวนมาก รวมถึงรัน /status ด้วย เพราะการตั้งค่า ANTHROPIC_API_KEY ที่ไม่ถูกต้องอาจทำให้คำขอถูกส่งผ่าน key ระดับต่ำแทนที่จะเป็นสิทธิ์จาก subscription ของคุณ
• ย้ายงานที่ไม่ต้องการการโต้ตอบไปที่ Message Batches API ระบบนี้ประมวลผลข้อมูลปริมาณมากแบบอะซิงโครนัสโดยมีส่วนลด 50% สำหรับ input และ output token ภายใต้ขีดจำกัดอัตราของตัวเอง ดังนั้นงานที่รันในตอนกลางคืนจะไม่แย่งทรัพยากรจากเซสชันการทำงานของคุณ

งานที่ต้องนำข้อมูลเข้าสู่ context มักจะได้รับผลกระทบมากที่สุด หากคุณกำลัง วิเคราะห์หุ้นและออปชันเทียบกับข้อมูลตลาดแบบเรียลไทม์ การดึงเฉพาะส่วนที่จำเป็นสำหรับแต่ละคำถามจะมีค่าใช้จ่ายเพียงเศษเสี้ยวของการคัดลอกตารางราคาและข้อมูลทั้งหมด งานที่มีลักษณะเป็นชุดข้อมูลขนาดใหญ่ที่ขับเคลื่อนด้วยโปรแกรมแทนที่จะเป็นคนควรใช้ API key ตั้งแต่ต้น การย้ายไปใช้ช่องทางดังกล่าวจะเปลี่ยนวิธีการชำระเงินและวิธีการวัดผล เนื่องจาก Claude API ไม่มีระดับการใช้งานฟรี แผน Max และ Team จะรวมเครดิต API รายเดือนสำหรับการรันแอปและเอเจนต์ของคุณเองเมื่อเชื่อมต่อกับองค์กรใน Console แล้ว เครดิตเหล่านี้ไม่ครอบคลุมการใช้งาน Claude Code และไม่เปลี่ยนแปลงขีดจำกัดการใช้งานตามแผนของคุณ แอป Claude API แรกของคุณบน VPS อธิบายเรื่องการจัดการ key และการลองใหม่ (retry) และการรันเอเจนต์ระยะยาวจะยังคงทำงานต่อไปได้แม้การเชื่อมต่อจะหลุดหากคุณ รัน Claude Code บน VPS ภายใน tmux

FAQ

ทำไมการเปลี่ยนโมเดลถึงไม่ช่วยแก้ปัญหาการจำกัดการใช้งาน Claude ของฉัน?

เนื่องจากขีดจำกัดของเซสชันและรายสัปดาห์นั้นใช้ร่วมกันในทุกโมเดล โควตาการใช้งานเป็นของแผนการใช้งาน ไม่ใช่ของโมเดล ดังนั้น /model จึงเป็นการเปลี่ยนโมเดลที่จะตอบคำถาม ไม่ใช่การเพิ่มโควตาที่เหลืออยู่ ข้อยกเว้นคือขีดจำกัดเฉพาะตระกูลโมเดล: You've hit your Opus limit และ You've hit your Sonnet limit จะมีผลเฉพาะกับตระกูลนั้นๆ เท่านั้น และขีดจำกัดของ Fable ในที่นั่งแบบ Max และ Premium จะจำกัดเฉพาะ Fable เท่านั้น ในกรณีนี้ การเปลี่ยนโมเดลคือวิธีแก้ไขที่ระบุไว้ในเอกสาร

ข้อผิดพลาด 429 rate_limit_error หมายถึงอะไร และฉันควรรอนานแค่ไหน?

หมายความว่าบัญชีของคุณถึงขีดจำกัดอัตราการใช้งาน (rate limit) สำหรับคลาสโมเดลนั้นแล้ว ไม่ว่าจะเป็นจำนวนคำขอต่อนาที, จำนวน input tokens ต่อนาที หรือจำนวน output tokens ต่อนาที โดยปกติการตอบกลับจะมี header retry-after ระบุจำนวนวินาทีที่ต้องรอ และการลองใหม่ก่อนเวลานั้นจะล้มเหลว SDK อย่างเป็นทางการจะทำการลองใหม่ (retry) เมื่อพบ rate limit และข้อผิดพลาด 5xx โดยใช้วิธี exponential backoff ซึ่งค่าเริ่มต้นคือ 2 ครั้ง และจะปฏิบัติตาม header ดังกล่าวหากมีระบุไว้ หากได้รับข้อผิดพลาด 429 ในขณะที่คุณยังใช้งานอยู่ภายในขีดจำกัดของระดับบัญชี แสดงว่าเป็นขีดจำกัดการเร่งความเร็วจากการใช้งานที่เพิ่มขึ้นอย่างกะทันหัน ส่วนข้อผิดพลาด 429 ที่มี enforced_spend_limit_reached ใน error.details.error_code ซึ่งไม่มี header retry-after ระบุมาด้วยนั้น คือการถึงขีดจำกัดการใช้จ่ายรายเดือน ซึ่งการรอเป็นเวลาหลายนาทีจะไม่ช่วยให้ใช้งานต่อได้

ฉันจะดูขีดจำกัดการใช้งาน Claude และเวลาที่ขีดจำกัดจะรีเซ็ตได้อย่างไร?

ใน Claude Code ให้รัน /usage เพื่อดูแถบสถานะแผนการใช้งาน, เวลาการรีเซ็ต และรายละเอียดการใช้งาน; /cost เป็นคำสั่ง alias และ d หรือ w ใช้สำหรับสลับระหว่างข้อมูล 24 ชั่วโมงล่าสุดกับ 7 วันล่าสุด ตัวเลขเหล่านี้มาจากประวัติเซสชันในเครื่อง จึงไม่รวมการใช้งานจากอุปกรณ์อื่นหรือจาก claude.ai สำหรับ API นั้น Console จะแสดงแผนภูมิขีดจำกัดอัตราการใช้งานของคุณ และ GET /v1/organizations/rate_limits จะส่งคืนค่าขีดจำกัดที่คุณตั้งค่าไว้โดยใช้ข้อมูลประจำตัว Admin API เช่น Admin API key

ฉันสามารถทำงานต่อได้หรือไม่หลังจากถึงขีดจำกัดแผนการใช้งาน Claude แล้ว?

อาจทำได้ ในบางกรณีให้รัน /usage-credits เพื่อซื้อโควตาการใช้งานเพิ่มหลังจากถึงขีดจำกัดสำหรับแผน Pro และ Max หรือเพื่อขออนุมัติจากผู้ดูแลระบบในแผน Team และ Enterprise; วิธีนี้จำเป็นต้องล็อกอิน claude.ai ผ่าน /login และไม่สามารถใช้งานได้กับการยืนยันตัวตนด้วย API key หากไม่ใช่วิธีดังกล่าว ให้รอจนถึงเวลาการรีเซ็ต, ใช้สิทธิ์รีเซ็ตขีดจำกัดฟรีหากมีตัวเลือกใน Settings > Usage บน claude.ai หรือ Claude Desktop, เปลี่ยนโมเดลหากเป็นขีดจำกัดของ Opus, Sonnet หรือ Fable หรือย้ายงานไปทำบน API key ซึ่งจะวัดปริมาณการใช้งานต่อนาทีแทนการวัดตามช่วงเวลา