أخطاء Claude Code الشائعة وحلولها — المرجع الكامل
يتوقّف Claude Code فجأة برسائل مثل "سجّل الدخول مجدداً" أو "حد المعدل" أو "الموجّه طويل جداً" أو "MCP لا يتصل" — والبحث عن كل واحد منها يصبح مرهقاً. هذا مرجع عملي يفهرس الأخطاء التي تصادفها بكثرة، مع السبب والأمر الذي تُشغّله لكل واحد. يبدأ بأوامر التشخيص الثلاثة التي تُشغّلها أولاً (claude doctor للتشخيص الكامل، /status للمصادقة النشطة، /context لتفصيل السياق)، ثم يركّز على العائلات الأربع الشائعة (الاستهلاك/حدود المعدل، تجاوز السياق، انتهاء المصادقة، فشل اتصال MCP) عبر جداول "العرَض ← السبب ← أمر الحل" تشمل المصادقة وتسجيل الدخول، والاستهلاك/حدود المعدل (يستهلك Claude Code 10-100 ضعف رموز الدردشة)، والسياق والرموز (الموجّه طويل جداً، تذبذب التلخيص)، والخادم والنموذج (500/529/مهلة منتهية/نموذج غير موجود)، والتثبيت/PATH/التحديث، والشبكة والوكيل (ECONNREFUSED، TLS)، وMCP، والأذونات (المنع يفوق التجاوز)، وأخرى (thinking blocks 400، صورة/PDF، IDE). وينتهي بورقة مرجعية للخطأ ← الحل وأسئلة شائعة. مبني على وثائق Claude Code الرسمية (حتى 2026): عند التعثّر شغّل أوامر التشخيص الثلاثة، وإن لم يُصلَح، شغّل claude update.