Claude Code عالق أو متجمّد؟ دليل الإنقاذ الكامل

عالق عند «Compacting conversation…»

يعمل الضغط التلقائي عندما يمتلئ نافذة السياق: يلخّص Claude Code المحادثة حتى تلك اللحظة ويستبدلها. في جلسة ضخمة فعلًا قد تستغرق هذه الجولة دقائق — وقد أصلحت إصدارتا v2.1.282 و v2.1.284 أعطالًا حقيقية: الضغط يفشل حين يُرفض طلب التلخيص، أو تبقى خطأ «Prompt is too long» بعد الضغط. إذا كانت الجلسة بحجم عادي وتدور أكثر من دقيقتين أو ثلاث، فهي عالقة لا تعمل.

1. 1إن كانت الجلسة ضخمة بحق، امنحها أولًا دقيقتين — أصلحت v2.1.283 دوّامة الضغط فلا يبدأ عدّادها إلا حين يبدأ الضغط فعلًا.
2. 2بعدها اضغط Esc ثم Ctrl+C لإلغاء الضغط. تؤكد الوثائق الرسمية أن Ctrl+C يلغي العملية الحالية دون إهدار جلستك.
3. 3ثم اضغط يدويًا مع تركيز يتخلّص الملخص من مخرجات الأدوات الضخمة، مثلًا: /compact keep only the plan and the diff.
4. 4إن كان السجل القديم قابلًا للرمي، فشغّل /clear وابدأ من جديد — وحدّث إلى v2.1.284 أو أحدث لتحصل على محاولات الضغط المُصلحة.

/compact keep only the plan and the diff/clear

عالق عند «Almost done thinking…»

خلافًا للحدس، هذه العبارة ليست مؤشر تقدّم: أكّد المسؤولون في المشكلة #63387 أن العبارات المتنقلة لا تقابل حالة التفكير الحقيقية للنموذج. لذلك قد يبقى «almost done» على الشاشة دقائق طويلة، والمشكلة #55328 توثّق أدوارًا لم يُجدِ معها Esc ولا Ctrl+C أي نفع بينما امتدّ التفكير الموسّع طويلًا.

1. 1اضغط Esc مرة وانتظر ثوانٍ؛ إن استمرت الدوّامة اضغط Ctrl+C.
2. 2إن بقي الإدخال ميتًا، أغلق تبويب الطرفية وافتح واحدًا جديدًا وشغّل claude --resume في المجلد نفسه لاستعادة الجلسة.
3. 3إن تعلّق كل دور طويل بالطريقة نفسها، حدّث Claude Code ثم اشتبه في خادم MCP أو خطّاف متوقف — لا فرق ظاهريًا بينهما وبين تعليق التفكير، و /mcp يريك أيّ خادم هو المُخوِّل.

claude --resume

«Not responding — try stopping»

هذه اللافتة البرتقالية هي كلب الحراسة في Claude Code: استدعاء أداة — غالبًا أمر bash طويل — صمت ما يكفي ليُبرز интерфейس زر إيقاف. إنه تنبيه لا حكم: في عروض Anthropic التوضيحية نفسها استمرت العملية بالعمل بشكل طبيعي تحت اللافتة، وبوريس تشيرني قائد Claude Code طلب علنًا تسجيلات لهذه الحالة — الفريق على علم ويحقّق.

1. 1تحقق أولًا هل ما زال الأمر الأساسي يُخرج نتائج — عملية بناء تترجم بهدوء لا تحتاج مقاطعة.
2. 2إن كان عالقًا حقًا، اضغط Esc أو زر الإيقاف البرتقالي لمقاطعة الدور.
3. 3أخبر Claude أنك أوقفته يدويًا — بعد الإيقاف اليدوي قد يظنّ النموذج خطأً أن الأداة رُفضت فيعتذر بدل أن يواصل.
4. 4أعد تشغيل العملية الطويلة في الخلفية أو على دفعات أصغر كي لا يتجهّر كلب الحراسة مرة أخرى.

claude --resume

حافة خشنة معروفة: في عرض توضيحي من Anthropic لهذه اللافتة نفسها ظهر زر الإيقاف بينما الأمر كان سليمًا — تحقّق قبل الإيقاف.

عالق عند «Resuming container…» (جلسات السحابة)

تعمل جلسات Claude Code على الويب والجوال داخل حاوية سحابية. إعادة فتح جلسة قديمة تعني إيقاظ تلك الحاوية وبثّ السجل إليها — وهذا بطيء فعلًا مع السجلات الكبيرة. وقد أصلحت v2.1.286 علّة كانت تجعل الجلسات ذات السجلات الضخمة جدًا لا تستيقظ أبدًا لأن الحاوية توقفت بينما كان السجل ما يزال يُحمَّل.

1. 1انتظر بضع دقائق أولًا — إيقاظ حاوية باردة أبطأ من جلسة جديدة، ولا يوجد شريط تقدّم يخبرك أن الأمور تتحرك.
2. 2حدّث واجهة الأوامر إلى v2.1.286 أو أحدث — claude update أو npm install -g @anthropic-ai/claude-code — ذلك الإصدار يصلح علّة «لا تستيقظ أبدًا» للسجلات السحابية الضخمة.
3. 3ما زالت متجمّدة بعد التحديث؟ أعد تحميل جلسة الويب؛ إن استمر الأمر، افتح جلسة جديدة وتابع العمل هناك.

claude updatenpm install -g @anthropic-ai/claude-code

حلّ مجتمعي، الرد الرسمي لم يصل: عدة مستخدمين أفادوا باستيقاظ الحاوية خلال نحو خمس دقائق — لا تحكم عليها بالموت إلا بعد ذلك.

تجمّد عند بدء التشغيل

التجمّد قبل ظهور الموجّه محلي في الغالب: خادم MCP أو إضافة أو خطّاف ينهار، أو حالة تالفة، أو مشكلة في الإضافة نفسها. أصلحت v2.1.284 تبويبات VS Code التي توقفت عن الاستجابة بعد Restart Extensions، وأصلحت v2.1.286 دوّامة «Teleporting session…» اللانهائية حين تتوقف الإضافة عن الاستجابة. ولأن /doctor داخل التطبيق يحتاج جلسة حيّة، نبدأ من الصدفة.

1. 1شغّل claude doctor من طرفيتك — الوثائق الرسمية توصي به تحديدًا لحالة «لا يبدأ إطلاقًا»؛ يفحص التثبيت ويقترح إصلاحات.
2. 2شغّله بـ claude --safe-mode، الذي يعطّل لهذه الجلسة كل الإضافات وخوادم MCP والخطّافات — إن نجح الإقلاع فالجاني أحد هذه التخصيصات.
3. 3أعد تفعيل تخصيصاتك واحدًا تلو الآخر — أو شغّل /mcp بعد الدخول — لتحديد الجاني ثم حدّثه أو أزله.
4. 4في VS Code، حدّث الإضافة أيضًا — إصلاحا 2.1.28x أعلاه لا يوجدان إلا في الإصدارات الحالية.

claude doctorclaude --safe-mode

متجمّد في الطرفية

التجمّد الكلاسيكي للنافذة كلها — إدخال ميت، دوّامة واقفة، Ctrl+C مهمل — له سيناريو موثّق. تسلسل الدليل الرسمي نفسه: جرّب الإلغاء، ثم أعد تشغيل الطرفية إن لزم، ثم استأنف الجلسة؛ ولن تخسر شيئًا في الحالين. أما الإخراج المشوّه أو ناقص الرسم في طرفية المحرر المدمجة فمشكلة أخرى — تسريع GPU — لها إصلاح بأمر واحد.

1. 1اضغط Ctrl+C لمحاولة إلغاء العملية الحالية.
2. 2إن بقيت النافذة بلا استجابة، أغلق الطرفية بالكامل وافتح واحدة جديدة.
3. 3في الطرفية الجديدة، شغّل claude --resume في مجلد المشروع نفسه — الوثائق تعدّ بأن المحادثة لن تضيع.
4. 4الإخراج مشوّه في طرفية VS Code المدمجة؟ شغّل /terminal-setup — يطفئ تسريع GPU للطرفية فيزول التشويه.

claude --resume/terminal-setup

«Model overloaded» وحلقة «Retrying…»

هذه المرة ليست المشكلة في طرفيتك بل في سعة Anthropic. عندما ترتفع حركة المرور لدى جميع المستخدمين في وقت واحد، ترد الـ API بالخطأ HTTP 529 (overloaded_error، أي «The API is temporarily overloaded»)، ولا يعرض Claude Code رسالة «API Error: Repeated 529 Overloaded errors» إلا بعد أن يكون قد أعاد المحاولة من تلقاء نفسه — حتى 10 مرات افتراضيًا بتراجع أُسّي. هذا الانتظار هو مؤشر «Retrying in Ns · attempt x/y» الذي تراه على الشاشة. وهناك صيغة ألطف تسمّي النموذج المزدحم مباشرة: «Opus is experiencing high load, please use /model to switch to Sonnet». السعة تُتتبَّع لكل نموذج على حدة، فالنموذج الذي تستخدمه الآن يحدد خياراتك.

1. 1انتظر حتى تمر الموجة أولًا. التوجيه الرسمي هو إعادة المحاولة بعد بضع دقائق: الخطأ 529 يعني فقط أن السعة المشتركة مزدحمة مؤقتًا، ومعظم الذرور تهدأ من تلقاء نفسها، وحلقة إعادة المحاولة تعمل لصالحك طوال ذلك.
2. 2تحقق من status.claude.com قبل تعديل أي إعداد محلي — فإن كانت هناك حادثة جارية، فالانتظار هو الإصلاح كله. وإذا كنت تتصل عبر بوابة أو مزوّد سحابي، فستشير رسالة الخطأ إلى صفحة حالة ذلك المزوّد.
3. 3شغّل /model وبدّل إلى نموذج أقل ازدحامًا — رسالة الخطأ نفسها تقترح ذلك. السعة تُتتبَّع لكل نموذج، فالانتقال من نموذج مشبع إلى آخر أهدأ قد يعيد الوصول فورًا.
4. 4تشغيل دون إشراف أو في CI؟ اضبط CLAUDE_CODE_RETRY_WATCHDOG=1 ليواصل Claude Code إعادة المحاولة عند أخطاء 529 بدلًا من إفشال المهمة، وعدّل CLAUDE_CODE_MAX_RETRIES (الافتراضي 10 والحد الأقصى 15) إن احتجت إلى ميزانية مختلفة.

/modelCLAUDE_CODE_RETRY_WATCHDOG=1 claude

لا تخلط بينه وبين حدود خطتك: توثّق الرسمية تنصّ صراحة على أن 529 «is not your usage limit and doesn't count against your quota» — ليس حد استخدام ولا يستهلك حصتك. والشريط المشابه «Server is temporarily limiting requests (not your usage limit)» هو تقييد مؤقت من جهة الخادم يعيد Claude Code المحاولة بعده تلقائيًا منذ الإصدار v2.1.199.