بدء سريع: تشغيل Claude Code أو Codex عن بُعد

آخر تحديث

يربط هذا الدليل جهاز تطوير واحدًا بـ PandaNpc ويتحقق من أنه يمكنك تشغيل Claude Code أو Codex أو PandaCode من جهاز آخر. لا يزال الوكيل ينفَّذ على جهاز التطوير لديك؛ يمنحك PandaNpc واجهة عن بُعد متزامنة للرسائل والموافقات والأسئلة وسجل الجلسات.

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

قبل أن تبدأ

ستحتاج إلى:

  • حساب PandaNpc مفتوح في التطبيق الإلكتروني أو تطبيق سطح المكتب أو تطبيق iOS.
  • جهاز مضيف يعمل بنظام Windows x64 أو macOS أو Linux x86_64.
  • وصول إلى الإنترنت من الجهاز المضيف وإذنًا لتثبيت خدمة خلفية على مستوى المستخدم.
  • مجلد مشروع يُسمح لك بتعديله.
  • حساب Claude أو ChatGPT/Codex أو نموذج مخصص إذا لم تكن محركاتك المختارة موثقة مسبقًا.

إذا كنت تحتاج فقط إلى الدردشة المدمجة في PandaNpc ولا تريد التحكم في وكيل على جهاز آخر، فإن PandaPaw غير مطلوب. راجع التثبيت للخيارات الخاصة بالعميل فقط.

1. إنشاء أمر تثبيت المضيف

أثناء تسجيل الدخول، افتح الأجهزة المتصلة واختر إضافة جهاز. ينشئ PandaNpc مفتاح جهاز لمرة واحدة ويعرض الأمر الدقيق لنظام التشغيل لديك.

انسخ هذا الأمر إلى الجهاز الذي يجب أن يعمل عليه وكيل البرمجة. تعامل معه ككلمة مرور حتى يتم استخدامه: مفتاح لمرة واحدة يربط جهازًا واحدًا ولا ينبغي نشره في الدردشة أو لقطات الشاشة أو المشكلات (issues) أو تصديرات سجل الأوامر (shell-history).

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

2. تثبيت PandaPaw على المضيف

macOS أو Linux

شغّل الأمر الجاهز من الأجهزة المتصلة، أو استخدم المثبت العادي:

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

Windows PowerShell

شغّل الأمر الجاهز من الأجهزة المتصلة، أو استخدم:

powershell
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

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

قد يكتمل المثبت حتى عندما يتم تأجيل تفويض الحساب. إذا قال إن التثبيت نجح ولكن اتصال الحساب غير مكتمل، فشغّل:

bash
pandapaw login

3. التحقق من خدمات المضيف

على المضيف، شغّل:

bash
pandapaw status

يجب أن يتعرف الأمر على الخدمات المثبتة ويعرض الجهاز المتصل بالحساب. إذا لم يتمكن الغلاف (shell) من العثور على pandapaw، فافتح طرفية جديدة أولاً حتى يعيد تحميل PATH المحدث للمستخدم.

بالنسبة لمشروع Git، يمكنك أيضًا التحقق مما إذا كان مركز الوكيل (Agent Center) يتعرف على جذر المشروع:

bash
pandapaw agent status --root /path/to/your/project

استخدم مسار مشروع مطلقًا حقيقيًا. يعمل ربط مشروع مركز الوكيل بشكل أفضل عندما يحتوي الدليل على remote.origin.url ثابت لـ Git.

4. بدء أول جلسة عن بُعد

  1. افتح وكيل PandaNpc على هاتفك أو متصفحك أو سطح مكتب آخر.
  2. ابحث عن الجهاز المتصل حديثًا. مؤشر الحالة الأخضر يعني أن المضيف يمكن الوصول إليه حاليًا.
  3. اختر Claude Code أو Codex أو PandaCode وحدد دليل عمل المشروع.
  4. ابدأ جلسة. إذا طلب المحرك منك تسجيل الدخول، فأكمل تفويض هذا المزود على المضيف أو عبر عملية تسجيل الدخول المعروضة.
  5. أرسل طلب اختبار غير ضار مثل: اعرض دليل العمل الحالي وقائمة الملفات في المستوى الأعلى. لا تعدّل أي شيء.

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

5. تأكيد سلوك إعادة الاتصال

أغلق عميل العرض، وانتظر بضع ثوانٍ، ثم أعد فتح نفس الجلسة. يجب أن يعود السجل الموجود ويظل المضيف متصلاً بالإنترنت. يتحقق هذا من المسار البعيد الفعلي بدلاً من إثبات أن المثبت تم تنزيله بنجاح فقط.

لا تضع المضيف في وضع السكون أثناء هذا الاختبار. لا يمكن للمضيف النائم أو المتوقف عن التشغيل تشغيل الوكيل حتى لو كان الاتصال المحفوظ لا يزال ظاهرًا في حسابك.

حل المشكلات

الجهاز لا يظهر في الوكيل

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

`pandapaw` غير معروف

افتح طرفية جديدة. على macOS/Linux، تأكد من أن ~/.local/bin موجود في PATH. على Windows، يضيف المثبت %LOCALAPPDATA%\Programs\pandapaw إلى PATH الخاص بالمستخدم؛ الطرفية المفتوحة قبل التثبيت لن ترى القيمة الجديدة.

الجهاز مدرج لكنه غير متصل

تأكد من أن المضيف قيد التشغيل ومستيقظ وقادر على الوصول إلى الإنترنت. ثم تحقق من pandapaw status. يجب أن تسمح جدران الحماية الخاصة بالمؤسسات بحركة المرور الصادرة عبر HTTPS/WebSocket؛ ولا ينبغي عليك إنشاء قاعدة توجيه منافذ واردة.

الاتصال يعمل لكن المحرك يطلب المصادقة

ربط PandaPaw وتسجيل دخول مزود النموذج منفصلان. يثبت الربط أن المضيف يتبع حساب PandaNpc الخاص بك؛ قد يظل Claude Code أو Codex يتطلب تسجيل دخول الاشتراك الخاص به أو إعداد API. أكمل تسجيل الدخول المعتاد للمحرك، ثم أعد محاولة الجلسة.

الوكيل يفتح في المجلد الخاطئ

أنهِ جلسة الاختبار وأنشئ جلسة باستخدام دليل العمل المقصود. قبل الموافقة على استخدام الأدوات، اطلب من الوكيل طباعة الدليل الحالي. لا يضيف الاتصال عن بُعد صندوق رمل (sandbox) لنظام الملفات بمفرده؛ تظل أذونات أدوات المحرك ودليل العمل المحدد مهمين.

الخطوات التالية