tmux مع Claude Code: واصل العمل عن بُعد بجلسات مستقلة

العامل الحاسم هنا هو الجهاز الذي ينفّذ العمل. يحافظ tmux على جلسة الطرفية عند انقطاع الاتصال، لكنه لا يستطيع مواصلة الحوسبة على حاسوب دخل في وضع السكون، ولا إبقاء خادم مطفأ قيد التشغيل، ولا إعادة تشغيل عملية Claude بعد تعطلها. توصي Anthropic صراحةً باستخدام tmux أو screen لجلسة Claude بعيدة تريد إبقاءها تعمل بعد انقطاع SSH. توثيق Remote Control من Anthropic.

كيف تضبط tmux وفق إعدادات Anthropic الموثّقة؟

ضع الإعدادات على الجهاز الذي يشغّل Claude Code. إذا كنت تعمل عن بُعد، فالمقصود هو ملف ~/.tmux.conf على الجهاز البعيد. ثبّت tmux باستخدام مدير الحزم على ذلك الجهاز عند الحاجة، وتحقّق هناك من tmux -V وclaude --version قبل المتابعة.

ادمج المقطع التالي في ~/.tmux.conf. الأسطر الثلاثة الأولى هي الإعدادات الواردة في توثيق Anthropic، أما خيار الفأرة المعلّق فهو تفضيل اختياري لا تشترطه Anthropic.

set -g allow-passthrough on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

# Optional preference: enable mouse interaction in tmux.
# set -g mouse on

يتيح التمرير المباشر وصول الإشعارات وتحديثات التقدّم إلى الطرفية الخارجية. وتتيح المفاتيح الموسّعة لـ tmux التمييز بين Shift+Enter وEnter. لتطبيق الإعدادات على خادم tmux يعمل بالفعل، نفّذ tmux source-file ~/.tmux.conf؛ أما الخادم الجديد فيحمّل الملف عند بدء التشغيل. إعداد الطرفية في توثيق Anthropic.

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

خصّص لكل شجرة عمل جلسة باسم واضح

شجرة عمل Git هي نسخة عمل أخرى من المستودع، لها ملفاتها وفرعها الخاص، وتشترك معه في سجل التغييرات. أما جلسة tmux فهي مجموعة من نوافذ الطرفية تحمل اسمًا، ويمكن تقسيم النافذة إلى أجزاء. تخيّل شجرة العمل طاولةً للعمل، وtmux غرفةً تستطيع مغادرتها والعودة إليها. دليل أشجار العمل من Anthropic.

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

يفترض مثال الإعداد الأول التالي وجود مستودع في ~/src/project يحتوي على إيداع واحد على الأقل، وأن أسماء الفروع والمجلدات والجلسات المستخدمة متاحة. استبدل dev@devbox ومسار المشروع بما يناسبك. ابدأ التنفيذ من الصدفة العادية على حاسوبك المحمول، خارج tmux. تتبع أوامر شجرة العمل خطوات Anthropic اليدوية، أما تنظيم الجلسات المسماة فهو الإجراء المقترح في هذا الدليل.

ssh dev@devbox
cd ~/src/project

git worktree add ../project-feature-a -b feature-a
git worktree add ../project-bugfix -b bugfix

tmux new-session -d -s cc-feature-a -n claude -c "$HOME/src/project-feature-a"
tmux new-session -d -s cc-bugfix -n claude -c "$HOME/src/project-bugfix"

tmux attach-session -t cc-feature-a
# Now inside the feature worktree's tmux shell:
claude

بعد الاتصال عبر SSH، أدخل بقية الأوامر على الجهاز البعيد. تحتوي الجلستان المنفصلتان عن العميل في البداية على صدفتي أوامر. وعندما تتصل بإحداهما وتشغّل claude، تبدأ جلسة البرمجة أمامك، بما في ذلك أي مطالبات إعداد معتادة. افصل اتصالك بالجلسة، ثم اتصل بـ cc-bugfix وشغّل claude فيها عندما تريد تفعيل المهمة الثانية.

تحتاج كل شجرة عمل إلى إعداد المشروع الخاص بها، بما يشمل الاعتماديات وأي تهيئة محلية لازمة. تحقّق من المجلد والفرع قبل تكليف Claude بتعديل الملفات. إدارة أشجار العمل يدويًا وفق Anthropic.

لإضافة صدفة اختيارية للاختبارات داخل نسخة عمل الميزة، نفّذ tmux new-window -t cc-feature-a -n checks -c "$HOME/src/project-feature-a" من صدفة على الجهاز المضيف. أبقِ الفحوص بجوار المهمة التي تخصّها، وتجنّب استخدام نسخة العمل الرئيسية مساحةً مؤقتة مشتركة للوكيلين.

إذا كنت تستخدم Codex أيضًا، فإن دليل أشجار العمل في Codex CLI يشرح سير العمل الخاص بتلك الأداة على حدة.

افصل الجلسة وأغلق الحاسوب ثم عد عبر SSH

عند استخدام مفتاح بادئة tmux الافتراضي، اضغط Ctrl+B، ثم ارفع إصبعيك عن المفتاحين واضغط D. يفصل ذلك العميل عن الجلسة ويعيدك إلى صدفة الجهاز البعيد. يمكنك الآن قطع اتصال SSH، مع ترك Claude يعمل داخل جلسته.

عند العودة، نفّذ ssh dev@devbox، ثم tmux list-sessions، ثم tmux attach-session -t cc-feature-a. استخدم الجهاز البعيد نفسه وحساب المستخدم نفسه. ويمكنك تنفيذ ما يعادل ذلك بأمر واحد من حاسوبك المحمول: ssh -t dev@devbox 'tmux attach-session -t cc-feature-a'.

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

تعيدك إعادة الاتصال إلى عملية الطرفية الموجودة. أما إذا كانت العملية قد انتهت، فاستعادة المحادثة إجراء مختلف: يستأنف claude --continue أحدث محادثة في المجلد الحالي، ويفتح claude --resume قائمة للاختيار. ولا يغني أي منهما عن إبقاء العملية الأصلية قيد التشغيل. استئناف الجلسات في توثيق Anthropic.

إذا أردت الوصول من الهاتف أو المتصفح، فاطّلع على Claude Code Remote Control. يظل التنفيذ على الجهاز المضيف، الذي يجب أن يبقى قيد التشغيل. Remote Control من Anthropic.

متى تحتاج إلى فريق من الوكلاء؟

فرق الوكلاء ميزة تجريبية ومعطّلة افتراضيًا. من صدفة داخل tmux، ابدأ جلسة تفاعلية جديدة للوكيل القائد باستخدام CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude --teammate-mode tmux. يفعّل متغير البيئة الفرق لهذا التشغيل، ويختار الخيار وضع تقسيم النافذة. إعداد فرق الوكلاء في توثيق Anthropic.

الوضع الافتراضي الحالي هو in-process. يستخدم auto أجزاء النافذة داخل tmux، ويلجأ إلى الوضع البديل عند الحاجة؛ أما tmux فيختار وضع تقسيم النافذة مع اكتشاف الطرفية. ولحفظ هذا التفضيل، استخدم teammateMode في ~/.claude/settings.json. يتيح تقسيم النافذة لكل عضو في الفريق طرفية مستقلة ظاهرة. وتدرج Anthropic الطرفية المدمجة في VS Code وWindows Terminal وGhostty ضمن الطرفيات غير المدعومة لهذا الوضع. أوضاع العرض وقيودها لدى Anthropic.

في التجربة الأولى، أقترح تكليف الوكيل القائد بهذه المهمة المحددة:

لا تتحول جلستا cc-feature-a وcc-bugfix اللتان شغّلتهما يدويًا إلى أعضاء في فريق لمجرد أن tmux يضمّهما. إنشاء الفريق قرار مستقل يحدد من يوزّع العمل ويجمع النتائج ويوفّق بينها. وفضّل الوكلاء الفرعيين في Claude Code عندما تريد تفويض مهام محددة ضمن جلسة واحدة.

جزء النافذة ليس نسخة عمل مستقلة. خصّص ملفات مختلفة، أو استخدم أشجار عمل منفصلة لمهام تعديل الملفات المستقلة. وتستهلك الفرق أيضًا مزيدًا من رموز المعالجة؛ لا يقلل tmux هذا الاستهلاك. تعيدك إعادة الاتصال إلى طرفية ما تزال تعمل، بينما لا يعيد /resume أعضاء الفريق الذين يعملون داخل العملية نفسها. إرشادات Anthropic للفرق.

خمس حالات يناسبها هذا التنظيم

أعطي الأولوية للاستخدامات التالية بهذا الترتيب. كل منها سير عمل محتمل، وليس ادعاءً بتحسّن مقاس في الإنتاجية.

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

أداتان صغيرتان يمكن بناؤهما حول هذا الإعداد

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

يشير تقدير DataForSEO للكلمات المفتاحية في الولايات المتحدة، المسترجع في 12 أكتوبر 2026، إلى 480 عملية بحث شهريًا عن «tmux claude code». هذه إشارة محدودة إلى الاهتمام بالإعداد، وليست عددًا للمشترين. التحدي أن برنامجًا نصيًا داخليًا قصيرًا قد يفي بالغرض؛ لذا يحتاج المنتج المدفوع إلى إعداد خاص بالفريق أو دعم يوفّر عليه عملًا متكررًا.

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

يقدّر فحص DataForSEO نفسه 1,600 عملية بحث شهريًا في الولايات المتحدة عن «claude code remote» و70 عن «claude code remote ssh». يشمل الاستعلام الأوسع أشخاصًا يبحثون عن واجهات أخرى للعمل عن بُعد، لذلك لا يثبت وحده وجود طلب على منتج خاص بـ SSH. أما التحدي فهو إدارة الوصول: يجب أن يحترم السجل صلاحيات كل مطوّر الحالية على الأجهزة المضيفة. قابل فرقًا تعتمد العمل عن بُعد قبل بناء لوحة تحكم.

أسئلة ستواجهك أثناء الاستخدام

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

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