Skip to main content

อ้างอิงข้อผิดพลาด

ค้นหา runtime error messages ของ Claude Code พร้อมความหมายและวิธีแก้ไข

หน้านี้แสดงรายการ runtime errors ที่ Claude Code แสดงและวิธีกู้คืนจากแต่ละรายการ สำหรับ installation errors เช่น command not found หรือ TLS failures ดู Troubleshoot installation and login

note

Claude Code เรียก Claude API สำหรับ model responses ดังนั้น runtime errors ส่วนใหญ่ map กับ API error code ที่อยู่เบื้องหลัง สำหรับคำนิยาม HTTP status code ดิบ ดู Claude Platform error reference

ค้นหาข้อผิดพลาดของคุณ​

ข้อความส่วน
API Error: 500 Internal server errorServer errors
API Error: Repeated 529 Overloaded errorsServer errors
Request timed outServer errors
You've hit your session limit / You've hit your weekly limitUsage limits
Usage credits required for 1M contextUsage limits
Server is temporarily limiting requestsUsage limits
Request rejected (429)Usage limits
Credit balance is too lowUsage limits
Not logged in · Please run /loginAuthentication
Could not resolve authentication methodAuthentication
Invalid API keyAuthentication
This organization has been disabledAuthentication
Unable to connect to APINetwork
SSL certificate verification failedNetwork
Prompt is too longRequest errors

Automatic retries​

Claude Code retry failures ชั่วคราวก่อนแสดงข้อผิดพลาด Server errors, overloaded responses, request timeouts, temporary 429 throttles และ dropped connections ถูก retry สูงสุด 10 ครั้งพร้อม exponential backoff

เมื่อคุณเห็นข้อผิดพลาดบนหน้านี้ retries เหล่านั้นหมดแล้ว ปรับพฤติกรรมด้วย environment variables:

ตัวแปรค่าเริ่มต้นผล
CLAUDE_CODE_MAX_RETRIES10จำนวน retry attempts
API_TIMEOUT_MS600000Per-request timeout เป็น milliseconds

Server errors​

API Error: 500 Internal server error​

API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

บ่งชี้ว่าเกิด failure ที่ไม่คาดคิดภายใน API ไม่ได้เกิดจาก prompt, settings หรือบัญชีของคุณ

วิธีแก้ไข:

  • ตรวจสอบ status.claude.com สำหรับ incidents ที่ active
  • รอหนึ่งนาทีจากนั้นส่ง message อีกครั้ง
  • หากข้อผิดพลาดยังคงอยู่รัน /feedback

API Error: Repeated 529 Overloaded errors​

API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

API ชั่วคราวเต็มความสามารถ A 529 ไม่ใช่ usage limit และไม่ count ต่อ quota ของคุณ

วิธีแก้ไข:

  • ตรวจสอบ status.claude.com
  • ลองอีกครั้งในอีกสักครู่
  • รัน /model และสลับไปยังโมเดลอื่น

Request timed out​

API ไม่ตอบสนองก่อน connection deadline ค่าเริ่มต้นคือ 10 นาที

วิธีแก้ไข:

  • Retry request
  • สำหรับ long-running tasks แบ่ง work เป็น prompts ย่อย
  • หาก network ช้า ให้เพิ่ม API_TIMEOUT_MS

Auto mode ไม่สามารถตัดสินความปลอดภัยของ action​

<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now.

หรือ:

Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

วิธีแก้ไข:

  • Retry หลังจากไม่กี่วินาที
  • รัน /compact เพื่อลดขนาดการสนทนา

Usage limits​

You've hit your session limit​

Subscription plans มี rolling usage allowance เมื่อหมดจะเห็น:

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am

วิธีแก้ไข:

  • รอเวลา reset ที่แสดงใน error
  • รัน /usage เพื่อดู plan limits
  • รัน /usage-credits เพื่อซื้อ usage เพิ่ม

Usage credits required for 1M context​

API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

วิธีแก้ไข:

  • รัน /model และเลือก variant ที่ไม่มี [1m] suffix
  • รัน /usage-credits เพื่อเปิด metered billing

Request rejected (429)​

API Error: Request rejected (429) · this may be a temporary capacity issue.

วิธีแก้ไข:

  • รัน /status และยืนยัน credential ที่ active ถูกต้อง
  • ตรวจสอบ provider console สำหรับ active limits
  • ลด concurrency ด้วย CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY

Credit balance is too low​

Credit balance is too low

วิธีแก้ไข:

Authentication errors​

Not logged in​

Not logged in · Please run /login

วิธีแก้ไข:

  • รัน /login เพื่อยืนยันตัวตน
  • ยืนยัน ANTHROPIC_API_KEY ตั้งค่าและ export ใน shell

Could not resolve authentication method​

Session ถึง API client โดยไม่มี credential

วิธีแก้ไข:

  • ยืนยัน ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN หรือ cloud provider credentials ตั้งค่าใน environment
  • รัน /status ใน interactive session เพื่อยืนยัน credential source

Invalid API key​

Invalid API key · Fix external API key

วิธีแก้ไข:

  • ตรวจสอบ typos และยืนยัน key ไม่ได้ถูก revoke ใน Console
  • รัน env | grep ANTHROPIC เพื่อตรวจสอบ stale keys
  • Unset ANTHROPIC_API_KEY และรัน /login

This organization has been disabled​

Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials

วิธีแก้ไข:

  • Unset ANTHROPIC_API_KEY ใน shell ปัจจุบันและลบออกจาก profile
  • รัน /status เพื่อยืนยัน credential ที่ active คือ subscription

Your organization has disabled API key authentication​

Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account

วิธีแก้ไข:

  • Unset ANTHROPIC_API_KEY หากข้อความระบุถึงมัน
  • รัน /login เพื่อ sign in ด้วย claude.ai account

Network errors​

Unable to connect to API​

Unable to connect to API

วิธีแก้ไข:

  • ตรวจสอบการเชื่อมต่ออินเทอร์เน็ต
  • ตรวจสอบ proxy settings
  • ยืนยัน firewall ไม่บล็อก outbound connections ไปยัง api.anthropic.com

SSL certificate errors​

SSL certificate verification failed

วิธีแก้ไข:

  • ตั้ง CLAUDE_CODE_CERT_STORE ไปยัง custom CA bundle
  • ปรึกษา IT team เกี่ยวกับ corporate proxy certificates

Request errors​

Prompt is too long​

Prompt is too long

วิธีแก้ไข:

  • รัน /compact เพื่อสรุปการสนทนา
  • รัน /clear เพื่อเริ่มการสนทนาใหม่
  • แบ่ง task ใหญ่เป็น tasks ย่อย

There's an issue with the selected model​

ตรวจสอบ model ID ที่กำหนดค่าใน environment variables, settings files และ CLI flags ตาม order ลำดับความสำคัญ

แจ้งข้อผิดพลาด​

หาก /feedback ไม่มีในสภาพแวดล้อมของคุณ คุณสามารถ: