دليل الاستخدام

يستند إلى الشاشات التي جرى التحقق منها في Claude Code 2.1.288~2.1.291

1. التحضير

تُربط أجهزة Mac الخاصة بالمطوّرين بخادم واحد للشركة.

• خادم الشركة: يوضع خادم تطبيقات ويب (WAS) وقاعدة بيانات على خادم داخلي. تُتاح وحدة تحكم الويب خلف بروكسي HTTPS الخاص بالشركة، ولا تُفتح اتصالات Agent (/ws/agent · /agent/) إلا داخل الشبكة الداخلية (VPN). ويتطلب تسجيل الدخول إلى الويب اسم المستخدم وكلمة المرور مع OTP إلزاميًا.
• كل Mac: tmux وClaude Code. يجب تشغيل Claude Code داخل نافذة tmux لتتمكن من الإدخال والموافقة من الويب.
• تثبيت Agent: نفّذ في طرفية Mac المطوّر (داخل الشبكة الداخلية) الأمر ذا السطر الواحد الذي يُنشئه المسؤول من الإدارة › المضيفون › «إضافة مضيف» في الويب. يمكن استخدام رمز التسجيل مرة واحدة فقط وخلال 15 دقيقة.

# شكل الأمر الذي يُنشئه «إضافة مضيف» (العنوان والرمز هما القيمتان الظاهرتان على الشاشة)
curl -fsSL <عنوان الخادم>/agent/install.sh | bash -s -- --code XXXX-XXXX

يتحقق سكربت التثبيت من الملف التنفيذي، ويسجّله، ويُبقيه قيد التشغيل عبر launchd، ويضبط أحداث hook في Claude Code، ثم يُجري فحصًا ختاميًا. بعد ذلك يُحدَّث Agent بزر «التحديث الآن» من الويب.

2. عرض الجلسات

تظهر في قائمة الجلسات جلسات كل أجهزة Mac مرتّبة حسب الحالة.

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

3. الموافقات · الأسئلة

• طلب الإذن: «سماح» · «السماح دائمًا بهذا الأمر» · «رفض». يحفظ «السماح دائمًا» القاعدة التي اقترحها Claude فقط (وهي عادةً ذلك الأمر وحده). إذا كان السؤال عن كل أمر مزعجًا، فغيّر وضع الأذونات إلى «تلقائي».
• أسئلة Claude: اختر من الخيارات في بطاقة السؤال (خيارًا واحدًا أو عدة خيارات) أو اكتب ردك بنفسك، ثم «إرسال الإجابة». إذا كانت هناك عدة أسئلة فيجب الإجابة عنها كلها قبل الإرسال.
• تظهر النافذة نفسها في الطرفية أيضًا، ويُعتمد الرد الذي يصل أولًا.
• نوافذ التأكيد التي تظهر في الطرفية فقط (مثل «Background work is running» عند /exit، و«Switch model?» عند تغيير النموذج) تظهر أيضًا كبطاقة «يسأل في الطرفية» ويمكنك الاختيار فيها من الويب.
• تتجمّع الطلبات المنتظرة في عمود التنبيهات (على الهاتف في علامة التبويب «التنبيهات»).

4. الموجّهات · الملفات · الإيقاف

• اكتب في حقل الإدخال ثم أرسل (⌘/Ctrl+Enter). تُرسل النصوص الطويلة كما هي، ولا يُفرَّغ حقل الإدخال إلا بعد وصول تأكيد الإرسال.
• اسحب الملفات وأفلتها في حقل الإدخال أو الصقها لتُرفع إلى uploads/ في مجلد الجلسة ويُدرج @المسار في حقل الإدخال. ويمكنك أيضًا اختيار مجلد والرفع إليه بزر الإرفاق.
• «إيقاف» يعادل Esc في الطرفية. وتُرسل أوامر مثل /compact · /clear بالأزرار السريعة.

5. جلسة جديدة · استئناف

1. اختر في «جلسة جديدة» الـ Mac (المضيف) والحساب والنموذج وeffort ومجلد المشروع ووضع الأذونات. ولا يمكن الفتح إلا داخل المجلدات المسموح بها على ذلك الـ Mac.
2. «محادثة جديدة» أو «استئناف» (اختيار محادثة منتهية). تُقرأ القائمة من قرص ذلك الـ Mac، فتظهر حتى محادثات المجلدات التي استُخدمت من الطرفية فقط (وفي أعلاها أحدث محادثة، كما في claude --continue). ويُفتح الاستئناف بوضع الأذونات وeffort اللذين كانت المحادثة تستخدمهما.
3. عند الاستئناف بحساب غير الذي حُفظت فيه المحادثة، يُنسخ ملف المحادثة إلى ذلك الحساب ويُتابَع فيه (ويبقى ملف الحساب الأصلي كما هو).

6. النموذج · effort · وضع الأذونات

• غيّرهما بزر «النموذج · effort» في ترويسة الجلسة. التغيير افتراضيًا لهذه الجلسة فقط، وإذا فعّلت «الحفظ أيضًا كقيمة افتراضية للجلسات الجديدة» تتغير القيم الافتراضية لذلك الحساب أيضًا.
• إذا غيّرت النموذج أثناء المحادثة، يعيد النموذج الجديد قراءة المحادثة كاملة عند الرسالة التالية، فتكون أبطأ وتستهلك رموزًا أكثر.
• أوضاع الأذونات: افتراضي (يسأل في كل مرة) · قبول التعديلات تلقائيًا · التخطيط · تلقائي (يسأل عمّا يبدو خطرًا فقط) · السماح بالكل (في المجلدات الموثوقة فقط).

7. نقل الجلسة

قائمة الجلسة › «النقل إلى مضيف آخر». لا تُنقل إلا الجلسات المنتهية على الـ Mac الأصلي.

• انقل المحادثة وحدها، أو انقل مجلد العمل معها. يُحزم مجلد العمل دون المجلدات القابلة لإعادة الإنشاء مثل node_modules · target، ويمر عبر الخادم ثم يُفك في مجلد فارغ على الـ Mac المستقبِل.
• تابع المراحل بشريط التقدّم (التصدير ← الحزم ← الرفع ← الاستلام ← الفك ← الاستئناف). تستمر العملية حتى لو أغلقت الويب، ويظهر التقدّم عند عودتك.
• الأصل أن تُزامَن الشيفرة عبر git. وتعرض نافذة النقل مقارنة بين حالة git على جهازَي Mac.

8. مستكشف الملفات

• افتح مجلد الجلسة بزر «الملفات» في ترويسة الجلسة. يدعم علامات التبويب والعرض جنبًا إلى جنب ومعاينة Markdown ومعاينة الصور.
• للتعديل فُكّ القفل وعدّل ثم ⌘+S. وإذا عدّل Claude الملف نفسه في الأثناء فستُنبَّه إلى التعارض.
• يمكن إعادة التسمية والتكرار والحذف. والحذف ليس إلا نقلًا إلى سلة المهملات، ولا يُكتب شيء في .git · .claude.
• إذا غيّرت الإعدادات › هذا المتصفح › «فتح مستكشف الملفات» إلى «في نافذة جديدة»، يُفتح «الملفات» في نافذة منفصلة لتعرض الملفات أثناء متابعة المحادثة.

9. المهام · الاستخدام

• المهام: اعرض الوكلاء وسير العمل الجارية الآن في الخلفية عبر كل الجلسات، وما انتهى خلال آخر 24 ساعة.
• الاستخدام: اختر الفترة والحساب والمضيف لمقارنة التكلفة التقديرية والطلبات ورموز المخرجات وإصابة التخزين المؤقت بالفترة السابقة. وتتوفر حدود الحساب (5 ساعات · أسبوعي · أسبوعي حسب النموذج) والتوقّع وفق الوتيرة الحالية، والأشرطة اليومية حسب النموذج، والترتيب حسب المشروع والجلسة، وخريطة حرارة يوم الأسبوع × الساعة.
• التكلفة تقدير محسوب بأسعار API، وليست رسوم الاشتراك.

10. الإدارة · الإعدادات

• المضيفون: حالة الاتصال والإصدار والمقاييس، و«إضافة مضيف» وإلغاء التسجيل، و«التحديث الآن» لـ Agent.
• الحسابات · الاستخدام: حالة تسجيل دخول حسابات Claude · Ollama على كل Mac، وتسجيل الدخول والخروج من الويب.
• النموذج: تشغيل النماذج المتاحة وإيقافها، والنموذج الافتراضي لكل نوع.
• النسخ الاحتياطي: يرفع Agent سجل المحادثات على كل Mac إلى خادم الشركة كل 10 دقائق. حجم أرشيف الخادم والمساحة المتاحة على القرص، وحالة النسخ الاحتياطي لكل مضيف مع «نسخ احتياطي الآن»، والبحث في المحادثات المنسوخة احتياطيًا و«استعادة» (للمسؤول). وتُفتح المحادثة المستعادة من جلسة جديدة › استئناف.
• الإعدادات: إعدادات الخادم مثل حدود معاينة الملفات ومدة الاحتفاظ (للمسؤول)، وإعدادات هذا المتصفح مثل السمة والمحرر.

11. على الهاتف · سطح المكتب

الهاتف: استخدم «إضافة إلى الشاشة الرئيسية» في Safari لتشغيله كتطبيق، وتنقّل عبر علامات التبويب السفلية (الجلسات · التنبيهات · المهام · الاستخدام · الإدارة). ومن علامة تبويب التنبيهات تنتقل مباشرةً إلى الموافقات والأسئلة بزر «الرد في الجلسة».

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

12. طرفية الويب

افتح من الويب صدفة Mac المطوّر (الإدارة › المضيفون › «الطرفية») وشاشة tmux الفعلية لجلسة claude (قائمة الجلسة › «العرض في الطرفية»). ولأنها صدفة بصلاحيات مستخدم ذلك الـ Mac، فهي مقيّدة بالشروط التالية.

• يجب تفعيلها مباشرةً على ذلك الـ Mac — لا يمكن تفعيلها من الويب. وعند تعطيلها تُغلق الطرفيات المفتوحة أيضًا.
• للمسؤول فقط، ويُطلب OTP مرة أخرى في كل فتح. يُسجَّل الفتح والإغلاق والوقت وعدد البايتات في سجل التدقيق، ولا يُسجَّل محتوى ضغطات المفاتيح. وتُغلق بعد 30 دقيقة دون إدخال.
• على سطح المكتب تُفتح في نافذة منفصلة (الإعدادات › هذا المتصفح › «فتح طرفية الويب»). وتبقى الطرفية كما هي حتى لو أغلقت نافذة وحدة التحكم أو أعدت تحميلها.
• اعرض المخرجات السابقة بعجلة الفأرة أو السحب أو PgUp/PgDn أو Shift+PageUp، واضغط أي مفتاح للعودة إلى الشاشة الأصلية. يُنسخ النص فور تحديده بالسحب، ويمسح ⌘+K الشاشة والمخرجات السابقة، بينما يمسح ⌘+L الشاشة فقط.
• يُحدَّد عدد أسطر المخرجات السابقة المحفوظة من الإعدادات › «طرفية الويب › عدد أسطر السجل» (الافتراضي 10,000 سطر).

# في طرفية ذلك الـ Mac — تفعيل · تعطيل · الحالة
~/.ssemtong/bin/ssemtong-agent terminal on
~/.ssemtong/bin/ssemtong-agent terminal off
~/.ssemtong/bin/ssemtong-agent terminal status

13. قائمة الموجّهات

• في «الموجّهات» ضمن عمود التنبيهات (على الهاتف في علامة التبويب «التنبيهات») تظهر فقط الموجّهات التي أدخلها الإنسان في تلك الجلسة، الأحدث أولًا — الرقم والوقت وأول ثلاثة أسطر، واضغط لعرضها كاملة.
• اضغط زر ↳ للانتقال إلى ذلك الموجّه في المحادثة وتمييزه لحظيًا. وأثناء القراءة من هناك لا تنجرف الشاشة إلى الأسفل مع وصول مخرجات جديدة، وتعود بزر «إلى الأسفل».
• إذا اخترت موجّهًا سابقًا لم يُحمَّل على الشاشة بعد، تُحمَّل المحادثة المحيطة به من الخادم ثم يُنتقل إليه، وتتابع القراءة بـ «تحميل بقية المحادثة».

14. اللغة

تدعم وحدة تحكم الويب: الكورية · English · 日本語 · 简体中文 · Français · Español · Bahasa Indonesia · Tiếng Việt · ភាសាខ្មែរ · العربية. اختر اللغة من زر 🌐 في الأعلى (وفي شاشة تسجيل الدخول في الأسفل) أو من الإعدادات › هذا المتصفح › «اللغة». تتبع في البداية لغة المتصفح، ويتذكّر المتصفح اللغة التي تختارها. وما زالت بعض الرسائل التي يرسلها الخادم وAgent تظهر بالكورية.