إبقاء Claude Code يعمل بعد انقطاع SSH: وصفة tmux

أبقِ Claude Code يعمل بعد انقطاع SSH باستخدام tmux. عُد إلى العملية نفسها، وتحقق من الاستمرارية، واستخدم الخيار الاختياري في AgentsRoom.

الوكيل يعمل على خادمك. تغلق الحاسوب المحمول. وعندما تعود، لا تجد عملية تعود إليها.

وصلنا هذا الطلب بالضبط: جلسات بعيدة دائمة تنجو من انقطاع العميل، ليتمكن المستخدم من المتابعة من جهاز آخر. كان تشغيلنا عبر SSH يشغّل أداة CLI على المضيف أصلًا. لم يكن ذلك كافيًا: كانت العملية لا تزال مرتبطة بطرفية SSH التفاعلية.

أطلقنا هذا التغيير في AgentsRoom 1.198.0. إليك الوصفة اليدوية أولًا، ثم ما يفعله التطبيق بها. مشكلة دورة الحياة نفسها تخص Claude Code وCodex وأدوات CLI التفاعلية الأخرى للبرمجة.

يجب أن تعيش الطرفية أطول من الاتصال

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

يمنح tmux العملية طرفية تعيش على المضيف بشكل مستقل عمّن يشاهدها. يصف دليل البدء الخاص به هذا الاستخدام بالضبط: حماية البرامج البعيدة من انقطاع الاتصال والوصول إليها من حاسوب آخر.

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

شغّل tmux قبل الوكيل

على مضيف من نوع Unix، اتصل باسم SSH المستعار المعتاد لديك. استبدل مسار المستودع بمسارك:

ssh my-server
tmux -V
tmux new-session -s coding
cd ~/projects/my-repo
claude

بالنسبة إلى Codex، استخدم codex في السطر الأخير بدلًا من ذلك. يجب أن تكون أداة CLI مثبتة ومسجّلًا دخولك فيها على الخادم. ابدأ بمستودع يمكنك التجريب فيه دون عواقب.

انفصل بالضغط على Ctrl+B ثم D. وأعد الاتصال لاحقًا:

ssh my-server
tmux list-sessions
tmux attach-session -t coding

يوثّق دليل tmux الانفصال والارتباط. إعادة الارتباط تعيدك إلى الطرفية الحية. لا ترسل المهمة من جديد ولا تطلق وكيلًا آخر.

تحقّق من دورة الحياة قبل أن تكلّفه بعمل حقيقي

يمكنك التحقق من الوصفة دون استهلاك حصة وكيل. داخل جلسة tmux الجديدة، شغّل هذا الأمر المحدود بدلًا من أداة CLI:

python3 -u -c 'import time; [(print(i, flush=True), time.sleep(1)) for i in range(60)]'

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

بعد ذلك، جرّب مهمة قصيرة للوكيل. بعد إعادة الاتصال، تحقق من الملفات التي غيّرها ومن حاجته إلى إجابة. قد تنجو الجلسة بينما ينتظر الوكيل عند طلب إذن. إبقاؤه حيًا لا يجعله مستقلًا.

ما الذي غيّرناه في AgentsRoom

افتح اتصال SSH المحفوظ وفعّل إبقاء الوكلاء قيد التشغيل على هذا المضيف عند إغلاق AgentsRoom. الخيار معطّل افتراضيًا. يحتاج المضيف إلى tmux 3.0 أو أحدث.

افتح الآن مشروعًا بعيدًا وأطلق وكيلًا فيه. تعمل أداة CLI داخل جلسة tmux مسمّاة على المضيف. الخروج من AgentsRoom أو وضع الحاسوب المحمول في وضع السكون أو فقدان الاتصال يترك تلك الجلسة كما هي. فتح الوكيل المحفوظ نفسه مجددًا يرتبط بها، بما في ذلك من حاسوب آخر على حسابك.

اتخذنا أربعة خيارات تقنية لأن كل واحد منها يغيّر ما يعيشه المستخدم:

  • اسم الجلسة يتبع هوية الوكيل. إعادة فتح ذلك الوكيل تجد عمليته؛ والوكيل الجديد يحصل على جلسة جديدة.
  • يستخدم التطبيق خادم tmux منفصلًا ويتجاهل إعدادات tmux الشخصية لديك. ولا يعيد ترتيب الجلسات التي تديرها يدويًا.
  • بادئة tmux معطّلة داخل التطبيق. يبقى Ctrl+B متاحًا لأداة CLI للبرمجة، ويصل إليها مفتاح Escape دون التأخير المعتاد في tmux.
  • إعادة تشغيل الوكيل صراحةً تستبدل العملية البعيدة. الخروج من التطبيق يفصل نافذة العرض الخاصة به. يجب أن يكون لهذين الإجراءين أثران مختلفان.

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

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

حين لا ينبغي أن يعتمد الوكلاء على كمبيوترك إطلاقًا

الإعداد أعلاه يبقي الوكيل حيًّا على المضيف، لكن AgentsRoom يظل يعمل على كمبيوترك، فتتوقف تشغيلات الفرق والمشغّلات حين يتوقف. منذ الإصدار 1.252.0 (نوفمبر 2026)، يمكن للتطبيق نفسه أن يعيش على الخادم:

sudo apt install ./desktop_<version>_amd64.deb
agentsroom --server

خذ حزمة arm64 على خادم ARM. يطبع الخادم رابطًا ورمزًا قصيرًا. افتح الرابط على كمبيوترك أو هاتفك، وتحقق من الجهاز والرمز، ثم انقر على ربط. بعد ذلك، يفتح agentsroom --server --open ~/my-repo مشروعًا.

لا توجد نافذة، ولا Xvfb ولا VNC. يرى هاتفك وأجهزة الكمبيوتر الأخرى لديك مشاريع الخادم، وتشغّل وكلاءه وتجيب عن أسئلتهم عبر الوسيط المشفّر من طرف إلى طرف، دون أي منفذ وارد. تثبّت كل أداة CLI للوكلاء على الخادم وتسجّل الدخول إليها هناك، كما تفعل على كمبيوتر محمول.

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

أين يندرج nohup وMosh

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

يتعامل Mosh مع الاتصالات المتقطعة وتغيّر الشبكة. وتنبّه وثائقه أيضًا إلى أنه يزامن الشاشة الظاهرة بدلًا من سجل التمرير الكامل. يمكن استخدامه مع tmux؛ وإبقاء جلسة متاحة بعد الخروج المتعمّد من العميل مسألة منفصلة عن التنقل بين الشبكات.

ما لا تحلّه الاستمرارية

لا يزال على المضيف أن يبقى قيد التشغيل. إعادة التشغيل تنهي عملياته الحية. وقد يوقف التقدمَ حدُّ حصة أو تعطّل أداة CLI أو سؤال إذن. تعيد الاتصال إلى الشاشة الحالية؛ ولا يوجد وعد بأن يظهر من جديد كاملًا سجل وحدة التحكم الذي عرضه حاسوبك الآخر.

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

تشرح صفحة الوصول عن بُعد كيف تصل إلى وكلائك. وتجيب هذه الوصفة عن السؤال التالي: هل لا يزال هناك وكيل تصل إليه بعد أن ينقطع الاتصال؟

الأسئلة الشائعة

هل ينجو وكيل البرمجة على خادم من انقطاع اتصال SSH؟

الطرفية التفاعلية العادية عبر SSH ليست آلية للاستمرارية. فقدان طرفيته قد يوقف الوكيل. شغّله داخل tmux على الخادم قبل قطع الاتصال، ثم ارتبط بتلك الجلسة من جديد. يجب أن يبقى الخادم قيد التشغيل، وقد يتوقف الوكيل مع ذلك لأسبابه الخاصة.

هل يمكنني إعادة الاتصال من حاسوب آخر؟

نعم، اتصل بالخادم نفسه بمستخدم المضيف نفسه وارتبط بجلسة tmux المسمّاة. في AgentsRoom، فعّل الجلسات الدائمة لاتصال SSH، ثم افتح الوكيل المحفوظ نفسه من حاسوب آخر على حسابك. تشغيل وكيل مختلف ينشئ جلسة مختلفة.

هل إعادة الاتصال هي نفسها استئناف محادثة؟

لا. الارتباط بجلسة tmux حية يعيدك إلى عملية لم تتوقف قط. استئناف محادثة محفوظة يطلق عملية تقرأ سجل أداة CLI. لا يستطيع ملف محادثة استعادة أمر قيد التنفيذ ولا عملية طرفية انتهت بالفعل.

هل يوقف إغلاق AgentsRoom وكيلًا بعيدًا دائمًا؟

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

تحميل AgentsRoom

شغّل كل وكلاء الذكاء الاصطناعي لديك، في كل مشاريعك، من نافذة واحدة.

تحميل AgentsRoomمجاني

التطبيق المرافق: تابع وكلاءك أينما كنت

استخدم Claude أو Codex أو Antigravity CLI أو أي مزود AI آخر.

أرسل الأخطاء والطلبات مباشرة إلى قائمة المهام العامة.

تابع القراءة