كيفية بناء وكيل Claude على خادم VPS

ما المقصود ببناء وكيل باستخدام Claude

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

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

كلود هو المكوّن المركزي: واجهة Messages API

تمر كل مكالمة إلى Claude عبر نقطة نهاية واحدة، وهي Messages API. ترسل سجل المحادثة حتى اللحظة وقائمة الأدوات التي يُسمح للوكيل باستخدامها، ثم يعيد Claude رسالته التالية. تكون هذه الرسالة إما إجابة نهائية أو طلباً لاستدعاء أداة. في مسار البناء الذاتي، لا توجد «واجهة API للوكيل» منفصلة؛ فاستخدام الأدوات ميزة في نقطة النهاية هذه، وعليك تشغيل الحلقة المحيطة بها في شيفرتك.

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

استخدام الأدوات هو حلقة الوكيل

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

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

ثلاث طرق للبناء، وأيها يناسب VPS

هناك ثلاث طرق لبناء وكيل Claude، وتختلف هذه الطرق في مقدار المكوّنات التي تديرها بنفسك.

الأولى هي كتابة شيفرتك الخاصة التي تستدعي Claude API باستخدام أدواتك الخاصة. تكتب الحلقة بنفسك، أو تستخدم مشغّل الأدوات في SDK، وتستضيف النظام بأكمله على VPS لديك. هذا هو الخيار الشائع لأنه يمنحك تحكماً كاملاً في الأدوات والبيانات والأمان، ويعمل كبرنامج عادي على خادمك. يفترض معظم هذا الدليل استخدام هذا المسار.

الثانية هي Claude Agent SDK. هذا هو Claude Code، أي وكيل البرمجة، بعد تعبئته كمكتبة يمكنك البناء عليها. يتضمن حلقة وكيل كاملة وأدوات مضمّنة لقراءة الملفات وكتابتها، وتشغيل أوامر shell، والبحث، لذلك لا تحتاج إلى تجميع هذه المكوّنات من الصفر. كما يعمل على خادمك أنت، ما يجعله مناسباً جداً لـVPS عندما تريد وكيلاً قادراً على التعامل مع الملفات وshell من دون بناء الإطار بنفسك. يحتاج الوكيل الذي يقرأ الملفات ويشغّل أوامر shell إلى احتواء قبل تشغيله دون إشراف، ويشرح تشغيل Claude Code بأمان على خادم نظام الأذونات وsandbox وخيارات العزل.

الثالثة هي Managed Agents، حيث تدير Anthropic الحلقة وتستضيف sandbox التي تنفّذ فيها أدوات الوكيل. هذا هو الخيار الذي يتطلب أقل قدر من الإدارة: سيكون عليك تشغيل مكوّنات أقل بكثير، لكن مساحة عمل الوكيل ستكون على بنية Anthropic التحتية بدلاً من VPS لديك. استخدمه عندما تريد تقليل العمل التشغيلي إلى أدنى حد، ولا تحتاج إلى تشغيل الأدوات على جهازك أنت. أما في الخيارين الآخرين، فخادمك هو موطن الوكيل، وهذا هو موضوع بقية هذا الدليل.

ربط الأدوات باستخدام MCP

أيّاً كان المسار الذي تختاره، ستحتاج إلى ربط الوكيل بأنظمة فعلية، ويُعد Model Context Protocol الطريقة المنظّمة لتنفيذ ذلك. MCP معيار مفتوح لإتاحة الأدوات والبيانات أمام الوكيل. بدلاً من كتابة تكامل مخصص لكل خدمة، وجّه Claude إلى خادم MCP يوفّر هذه الإمكانات مسبقاً على شكل أدوات. يمكنك تشغيل خوادم MCP كخدمات صغيرة على VPS نفسه، مع منح كل خادم الصلاحيات التي يحتاج إليها فقط. أتناول ذلك في تشغيل خوادم MCP على VPS.

اختيار نموذج

تأتي Claude بعدة نماذج، واختيار أحدها يتطلب موازنة بين القدرة والسرعة والتكلفة. حتى وقت كتابة هذا النص، تتمثل الخيارات الرئيسية في Claude Opus 4.8 (claude-opus-4-8)، وهو الخيار الافتراضي القادر على الاستدلال الصعب وتشغيل الوكلاء لفترات طويلة؛ وClaude Sonnet 5 (claude-sonnet-5)، وهو خيار متوازن وأقل تكلفة وأسرع، مع بقائه قريباً من Opus في العديد من المهام؛ وClaude Haiku 4.5 (claude-haiku-4-5)، وهو الأسرع والأقل تكلفة، للخطوات البسيطة ذات الحجم الكبير. ويأتي فوق هذه النماذج Claude Fable 5 (claude-fable-5)، وهو النموذج الأكثر قدرة، للاستخدام في الأعمال الأكثر تطلباً. استخدم معرّف النموذج الدقيق في التعليمات البرمجية، من دون إضافة تاريخ إليه.

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

شغّله كخدمة محصّنة على VPS

لا يكون الوكيل مفيداً إلا إذا ظل قيد التشغيل، ولا يكون آمناً إلا إذا كان معزولاً. على VPS، يتحقق الأمران بتشغيل الوكيل كخدمة نظام محصّنة بدلاً من تشغيله يدوياً في طرفية. تبدأ الخدمة عند الإقلاع، وتُعاد عند تعطلها، وتكتب السجلات في journal. وعند تحصينها، تعمل الخدمة باستخدام مستخدم غير مميّز ولا تملك إلا صلاحيات الوصول التي تحتاج إليها، لذلك يكون تأثير الخطأ أو التعليمات الضارة محدوداً. لا تستطيع وحدة الخدمة تقييد سوى ما يُسمح للعملية بالوصول إليه، لذلك يجب تنفيذ الإجراءات الأخرى داخل غلاف الوكيل نفسه. وهذا هو دور إضافات DeepSeek Harness التي تستحق التثبيت على مكدس مختلف: تحديد حدود الإنفاق، وقواعد الصلاحيات لكل أداة، وفحص حقن التعليمات.

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

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

إذا كنت تريد مساعد ترميز يعمل في الطرفية، فإن تشغيل وكيل AI للترميز على VPS يشرح استخدام Aider وGoose.

FAQ

ما نموذج Claude الذي يجب أن تستخدمه لبناء وكيل؟

ابدأ باستخدام Claude Opus 4.8 (claude-opus-4-8)، فهو الخيار الافتراضي القادر، ثم عدّل اختيارك حسب الحاجة. يُعد Claude Sonnet 5 (claude-sonnet-5) أرخص وأسرع لمعظم المهام، بينما يناسب Claude Haiku 4.5 (claude-haiku-4-5) الخطوات البسيطة ذات الحجم الكبير، ويُعد Claude Fable 5 (claude-fable-5) الأكثر قدرة على أصعب المهام. من الأنماط الشائعة استخدام نموذج أرخص للخطوات الروتينية ونموذج أقوى للقرارات الصعبة، لأن التبديل بينهما لا يتطلب سوى تغيير في سطر واحد.

هل أشغّل الوكيل بالكامل على VPS الخاص بي، أم تتولى Anthropic ذلك؟

يعتمد ذلك على الأسلوب المستخدم. إذا كتبت حلقة التنفيذ بنفسك باستخدام Claude API، أو استخدمت Claude Agent SDK، فسيعمل الوكيل بالكامل على VPS الخاص بك، ولن تخرج إلى Anthropic إلا استدعاءات النموذج. أما إذا استخدمت Managed Agents، فستشغّل Anthropic الحلقة وتستضيف sandbox الذي تنفَّذ فيه الأدوات، ولذلك سيعمل جزء أقل من الوكيل على خادمك. إذا أردت وكيلاً يعمل على جهازك أنت، فاستخدم أحد الخيارين الأولين.

ما الفرق بين Claude API وClaude Agent SDK؟

يمثل Claude API نقطة نهاية Messages الخام: ترسل محادثة وأدوات، ثم تكتب حلقة الوكيل حولها، أو تستخدم مشغّل الأدوات في SDK لتشغيلها. أما Claude Agent SDK فهو مكتبة أعلى مستوى، وهي Claude Code مُغلّفاً للبناء عليه، وتوفّر حلقة كاملة وأدوات مضمّنة للملفات وshell والبحث. استخدم API عندما تريد تعريف كل شيء بنفسك، واستخدم Agent SDK عندما تريد وكيلاً قادراً من دون بناء البنية الداعمة يدوياً.

كيف تحافظ على أمان Claude API key على خادم؟

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

هل أحتاج إلى استضافة نموذج بنفسي لبناء وكيل باستخدام Claude؟

لا. في Claude، يكون النموذج خدمة مستضافة تستدعيها عبر API، لذلك لا يوجد شيء تحتاج إلى تشغيله على GPU. يشغّل VPS الخاص بك حلقة الوكيل والأدوات والبيانات، بينما تجري عملية الاستدلال لدى Anthropic. وهذا ما يتيح لخادم متواضع تشغيل وكيل قادر. إذا أردت بدلاً من ذلك نموذجاً محلياً بالكامل، فهذا هو المسار المستضاف ذاتياً الذي يغطيه الدليل المرافق حول بناء وكيل AI الخاص بك.