استكشاف انقطاع الاتصال عن بُعد في Claude Code: أعراض ستة أنواع من الانقطاع ومعايير تشخيصها وحلولها

عند تشغيل Claude Code عن بُعد، أكثر ما يزعجك ليس عدم الاتصال، بل الاتصال ثم الانقطاع، مع اختلاف سبب الانقطاع في كل مرة.

كلمة «انقطاع الاتصال» تغطي في الواقع ستة أعطال مختلفة تمامًا. لكلٍّ منها أعراض مميزة وحلول مستقلة عن بعضها — إذا ظننت أن فشل الاتصال الطويل بسبب تبديل الشبكة هو نوم الجهاز، فلن يفيدك إيقاف وضع السكون؛ وإذا انتظرت أن تتعافى حالة الاتصال نصف الميت باعتبارها مجرد ضعف في الشبكة، فلن تتحسن من تلقاء نفسها حتى الفجر.

تستعرض هذه المقالة الأسباب بالاستناد إلى ما تراه فعليًا: لكل نوع انقطاع، نعطي الأعراض، وكيف تتأكد أنه هو، والحل المناسب له. وإذا أردت البدء مباشرة، انتقل إلى قائمة الفحص في القسم الأخير.

يتناول هذا المقال استكشاف انقطاع الاتصال فقط. لتثبيت الوصول عن بُعد، راجع «الوصول عن بُعد إلى Claude Code: تحكم بالجلسات من أي مكان حتى عند إيقاف تشغيل جهازك»، ولاستخدام الهاتف راجع «الاتصال بـ Claude Code من الهاتف: عرض الجلسات والموافقة على الأدوات في أي وقت على iOS».

طابق الأعراض أولًا: أي نوع تراه؟

الاتصال عن بُعد يتكون من جزأين: الجهاز المطوِّر الذي يعمل عليه Claude Code ←→ جهاز العرض الذي في يدك. أي خلل في أيٍّ من الجزأين يظهر كـ«انقطاع»، لكن الأعراض تختلف:

ما تراه	على الأرجح هو	الانتقال إلى
تتجمد الجلسة فجأة، وعند إعادة الاتصال تجد التقدم متوقفًا عند تلك اللحظة	نوم الجهاز المطوِّر / قفل الشاشة	§1
ينقطع الاتصال في اللحظة التي تدخل فيها المصعد، أو تتحول إلى 4G، أو تنتقل إلى WiFi	قطع الاتصال الطويل	§2
بمجرد إغلاق الطرفية على جهازك أو دخوله في وضع السكون، ينقطع الاتصال عن بُعد فورًا	قيد صارم لحلول نقل الشاشة	§3
يظهر الاتصال كمتصل، لكن رسائلك تختفي دون أي خطأ	اتصال نصف ميت	§4
يمكنك إعادة الاتصال، لكنك تعود إلى جلسة فارغة / الرسائل أثناء الانقطاع اختفت	إعادة الاتصال لم تعُد إلى الجلسة الأصلية	§5
عند الاتصال بعد ساعات، الجلسة غير موجودة	تم إعادة تدوير العملية دون استعادة باردة	§6

الأسهل للتشخيص الخاطئ هو النوع الرابع: لا يُصدر أي خطأ. حالة الاتصال خضراء، والرسائل تُرسل، لكن لا يوجد أي استجابة أبدًا — وهو أصعب في التتبع من الانقطاع المباشر، لأن كل المؤشرات تخبرك أن «كل شيء طبيعي».

1. نوم الجهاز المطوِّر / قفل الشاشة / إغلاق الغطاء

الأعراض: تتوقف الجلسة بالكامل في لحظة معينة. عند إعادة الاتصال، يظل التقدم متوقفًا عند لحظة الانقطاع، دون أي خطوة للأمام.

السبب: يعتقد الكثيرون أن «الجهاز المطوِّر يعمل طوال الوقت»، لكن إسبات النظام، والنوم عند إغلاق الغطاء، وقفل الشاشة الموقوت كلها قد تعلّق أو تقتل عملية Claude Code. الطرف المعروض عليه يرى فقط «توقفًا مفاجئًا».

كيف تتأكد: ارجع إلى الجهاز المطوِّر وتحقق مما إذا كانت العملية ما زالت موجودة، ومن سجلات النظام بحثًا عن أي سجل سكون. إذا كانت العملية موجودة لكن الطابع الزمني متوقف عند لحظة الانقطاع، فهي على الأرجح هي.

الحل: اضبط خطة الطاقة على الجهاز المطوِّر إلى «عدم السكون / عدم النوم عند إغلاق الغطاء». هذا هو الحل الجذري الوحيد — فلا يمكن لأي حل عن بُعد إنقاذ جهاز دخل في النوم بالفعل.

2. تبديل الشبكة يقتطع الاتصال الطويل

الأعراض: ينقطع الاتصال في لحظة واضحة ومحددة — عند دخول المصعد، أو انتقال WiFi إلى 4G، أو إعادة اتصال النطاق العريض في منتصف الليل.

السبب: يعتمد المزامنة اللحظية عن بُعد على اتصال طويل (WebSocket / SSH). بمجرد تغيّر عنوان IP، تفشل هذه الاتصالية فورًا دون أي مجال للتفاوض.

كيف تتأكد: إذا تطابق توقيت الانقطاع مع توقيت تبديل شبكتك، فهي هي.

الحل: هذا النوع لا يمكن تجنبه، ولا يمكن احتواؤه إلا بـإعادة الاتصال التلقائي + التراجع التدريجي (1 ثانية → 2 ثانية → 5 ثوانٍ… لتجنب القصف الفوري بعد الانقطاع). لا يملك SSH المجرد هذه الإمكانية، فإذا انقطع انقطع، وعليك إعادة الاتصال يدويًا. عند اختيار الحل، يعد هذا معيارًا صارمًا.

3. حلول نقل الشاشة: يجب أن يبقى الجهاز المحلي مفتوحًا في المقدمة

الأعراض: بمجرد إغلاق الطرفية على جهازك، أو دخوله في وضع السكون، ينقطع الاتصال على جانب الهاتف فورًا. ليس انتهاء مهلة تدريجيًا، بل فشل في المزامنة.

السبب: التحكم عن بُعد الرسمي من Anthropic يعمل عن طريق بث الجلسة التي تعمل على جهازك المحلي إلى الهاتف/المتصفح. يتطلب ذلك بقاء Claude Code على الجهاز المحلي مفتوحًا في المقدمة وجهازك المحلي متصلًا بالإنترنت طوال الوقت. بمجرد سقوط الجهاز المحلي، لا يوجد دورة حياة مستقلة يعتمد عليها الطرف البعيد.

كيف تتأكد: أغلق نافذة الطرفية على جهازك ولاحظ ما إذا كان الاتصال عن بُعد ينقطع في نفس الثانية. إذا كان الأمر كذلك، فأنت تستخدم حل نقل الشاشة.

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

4. الاتصال نصف الميت (half-open): أكثر الأنواع صعوبة في الاكتشاف

الأعراض: يظهر الاتصال كمتصل، لكن إرسال الرسائل لا يلقى استجابة، ولا تظهر أي أخطاء. قد يستمر هذا لعدة دقائق، أو حتى تقوم بإعادة الاتصال يدويًا.

السبب: عندما ينقطع الاتصال الشبكي بصمت (انتهاء مهلة إدخالات NAT، فقدان حالة الأجهزة الوسيطة، إشارة ضعيفة لدرجة فقدان الحزم دون قطع الارتباط)، قد يظن طرفا TCP أنهما ما زالا متصلين بينما لا تمر البيانات فعليًا. من دون نبضات القلب (heartbeat)، سيحافظ الطرفان على هذا الوهم.

كيف تتأكد: حالة الاتصال طبيعية، لكن الرسائل المرسلة لا تحصل على إشعار استلام ولا على خطأ؛ ثم تتعافى فورًا بعد قطع الاتصال وإعادة الاتصال يدويًا — إذن هو هذا النوع.

الحل: يجب تشغيل نبضات القلب (keepalive ping) على الاتصال: إذا لم يتم تلقي أي استجابة من الطرف الآخر خلال المهلة المتفق عليها، فحكم على الاتصال بأنه نصف ميت، واقطعه وأعد الاتصال بفعالية بدل الانتظار بلا فائدة. يجب أن يكون المعيار «عدم تلقي استجابة»، وليس «عدم وجود أخطاء» — فالاتصال نصف الميت لا يُصدر أخطاءً أبدًا.

5. إعادة الاتصال لا تعيدك إلى الجلسة الأصلية / فقدان الرسائل

الأعراض: يمكن إعادة الاتصال بعد الانقطاع، لكنك إما تعود إلى جلسة فارغة، أوقد جميع الرسائل التي أُرسلت أثناء الانقطاع.

السبب: إعادة الاتصال لا تؤدي إلا إلى إنشاء اتصال جديد، دون إعادة اشتراك هذا الاتصال في الجلسة الأصلية؛ كما لا يتم تخزين الرسائل المؤقتة لك أثناء الانقطاع.

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

الحل: اختر حلًا يمكنه إعادة الاشتراك تلقائيًا في الجلسة الأصلية بعد إعادة الاتصال، وإعادة عرض السجل التاريخي أثناء الانقطاع. إعادة الاتصال دون العودة إلى الجلسة نفسها تعني أن الاتصال تم عبثًا.

6. إعادة تدوير عملية الجلسة دون استعادة باردة

الأعراض: الانقطاعات القصيرة وإعادة الاتصال تعمل بشكل طبيعي، لكن عند العودة بعد عدة ساعات، الجلسة غير موجودة.

السبب: قد يتم إعادة تدوير عمليات الجلسة الخاملة لفترة طويلة، وقد يُعاد تشغيل العملية الحارسة نفسها (بسبب ترقية، أو رفع بعد انهيار). وبهذا تختفي حالة الجلسة الموجودة في الذاكرة.

كيف تتأكد: يحدث الانقطاع فقط عند الانقطاع الطويل، ولا يتكرر مع الانقطاع القصير.

الحل: تحتاج إلى قدرة الاستعادة الباردة (cold recovery) — حيث تُحفظ حالة الجلسة على القرص، وعند اختفاء العملية يمكن استعادة السياق من القرص. في الوضع المثالي، بمجرد إرسالك رسالة، يستعيد تلقائيًا ويستمر، دون أن تدرك ذلك.

قائمة الفحص (تنطبق على أي حل)

اتبعها بالترتيب، وكل خطوة يمكن التحقق من صحتها بشكل مستقل:

1. هل دخل الجهاز الذي يعمل عليه الجلسة في السكون أو قفل الشاشة؟ → أوقف النوم التلقائي، واجعله لا ينام عند إغلاق الغطاء. (§1)
2. هل يتزامن وقت الانقطاع مع وقت تبديل شبكتك؟ → تحتاج حلاً مع إعادة اتصال تلقائية + تراجع تدريجي، ولا تعتمد على SSH المجرد. (§2)
3. هل ينقطع الاتصال عن بُعد فور إغلاق الطرفية على جهازك؟ → قيد صارم لحلول نقل الشاشة، وعليك التحول إلى بنية خدمة مقيمة دائمة. (§3)
4. هل تعلق عند «تظهر متصلًا لكن الرسائل بلا استجابة»؟ → اتصال نصف ميت، ولا يمكن إنقاذه تلقائيًا إلا بفحص نبضات القلب. (§4)
5. هل الجلسة فارغة / الرسائل ناقصة بعد إعادة الاتصال؟ → تحتاج إلى «إعادة الاتصال بالجلسة الأصلية + إعادة عرض السجل التاريخي». (§5)
6. هل تفقد الجلسة فقط عند الانقطاع الطويل؟ → تحتاج إلى حفظ على القرص + استعادة باردة. (§6)

تطبيق ذلك على حلول محددة

من الأنواع الستة المذكورة أعلاه، فقط النوع الأول هو مشكلة إعدادات في جهازك، أما الأنواع الخمسة الباقية فهي جميعًا محددة بالبنية المعمارية — تُحسم عند اختيار الحل، ولا يمكن إصلاحها بعد وقوع المشكلة بتعديل المعاملات.

أي حل عن بُعد لا ينقطع يجب أن يتوفر فيه في الوقت نفسه: عمليةارسة مقيمة على جانب الجهاز المطوِّر (تغطي المخاطر المتبقية من §1 و§3)، وإعادة اتصال تلقائية + تراجع تدريجي (§2)، وفحص نبضات القلب (§4)، وإعادة الاتصال بالجلسة الأصلية + إعادة عرض السجل التاريخي (§5)، واستعادة باردة من القرص (§6).

مجموعة PandaNpc + pandapaw صُممت لتلتزم بهذه النقاط الست واحدة واحدة: pandapaw يُسجَّل على الجهاز المطوِّر كعملية حارسة مقيمة تبدأ تلقائيًا عند الإقلاع (وليست نافذة طرفية يجب فتحها يدويًا، بل تُرفع تلقائيًا إذا انهارت)؛ وعند انقطاع اتصال جهاز العرض، يعيد الاتصال تلقائيًا مع تراجع تدريجي؛ ويشغّل نبضات قلب على الاتصال، فإذا لم يستجب الطرف الآخر قضى بأن الاتصال نصف ميت وأعاد الاتصال بفعالية؛ وبعد إعادة الاتصال يشترك تلقائيًا في الجلسة الأصلية ويعيد عرض سجل الانقطاع؛ وحتى إذا أُعيد تدوير عملية الجلسة، تكفي رسالة واحدة لاستئناف العمل من القرص عبر استعادة باردة.

لتفاصيل التثبيت والاتصال، راجع «الوصول عن بُعد إلى Claude Code»؛ ولمعرفة كيفية عرض الجلسات والموافقة على الأدوات من الهاتف، راجع «الاتصال بـ Claude Code من الهاتف».

مأزق إضافي: لا تقع في فخ الفوترة عند التشغيل عن بُعد

عند استكشاف انقطاع الاتصال، قد تتحول بسهولة إلى تشغيل claude -p (وضع headless)، لكن ابتداءً من 15 يونيو 2026 عدّلت Anthropic الفوترة — لم يعد headless يستهلك من حصة الاشتراك، بل يستهلك رصيد SDK شهريًا صغيرًا، وبعد نفاده يُحتسب وفقًا لأسعار API، والاستخدام الكثيف يتجاوز الحدود بسهولة. أما الوضع التفاعلي (claude REPL) فلا يزال يستهلك من حصة الاشتراك. عند تغيير الحل لاستكشاف الانقطاع، انتبه ألا تغيّر طريقة الفوترة بالخطأ.