كيفية استخدام وكلاء Claude Code: الإعداد، الأدوات، الصلاحيات، وسير عمل الحماية

لاستخدام وكلاء Claude Code بشكل جيد، تعامل مع Claude Code كحلقة وكيل (agent loop) وليس كنافذة دردشة: ابدأه داخل المستودع الذي تريد تعديله، وامنحه تعليمات مشروع واضحة، واربط فقط الأدوات التي يحتاجها فعلاً، وأبقِ الصلاحيات مشدودة، ونفّذ العمليات داخل بيئة معزولة عندما يتجاوز سير العمل التعديلات المحلية منخفضة المخاطر. هذا هو الفرق بين جلسة برمجة مفيدة وأخرى مكلفة وفوضوية.

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

ما الذي يعنيه الناس عادةً بـ “وكلاء Claude Code”

معظم المطورين الذين يبحثون عن “وكلاء Claude Code” يقصدون أحد أمرين:

1. Claude Code نفسه بصفته وكيل برمجة مستقل.
2. وكلاء متخصصون متعددون، أو أدوات، أو وكلاء فرعيون يعملون داخل سير عمل Claude Code.

كلا الأمرين صحيح. يتصرف Claude Code بالفعل كأداة برمجة وكيلية: يمكنه فحص مستودع، وتعديل الملفات، وتشغيل الأوامر، والتفاعل مع النتائج. كما توثّق Anthropic مكونات بناء ذات صلة مثل تكاملات أدوات MCP، والخطافات (hooks)، والوكلاء الفرعيين، ولهذا السبب يظهر المصطلح غالباً بصيغة الجمع.

النموذج العملي بسيط:

• Claude Code هو سير العمل المضيف.
• النموذج يتولى التخطيط وقرارات الخطوة التالية.
• الأدوات توفر الوصول إلى الملفات، والأوامر، والمتصفحات، وواجهات API، والأنظمة الخارجية.
• الصلاحيات تحدد ما يُسمح لـ Claude بفعله دون سؤال.
• بيئة الحماية (sandbox) تمنحك مكاناً آمناً لتشغيل الكود وتنفيذ الأدوات.

إذا أبقيت هذه الطبقات الخمس منفصلة، يصبح تشغيل Claude Code أسهل وأكثر موثوقية.

الخطوة 1: تثبيت Claude Code والبدء في الدليل الصحيح

توثّق Anthropic Claude Code كأداة CLI قابلة للتثبيت. مسار التثبيت القياسي هو:

npm install -g @anthropic-ai/claude-code
claude

التفصيل المهم ليس التثبيت فقط. ابدأ Claude Code من المستودع الذي تريد أن يعمل عليه. يقرأ Claude Code الدليل الحالي، وتعليمات المشروع المحلية، وأي إعدادات أدوات خاصة بالمشروع من هناك.

إذا كان المستودع جديداً، شغّل:

/init

يُنشئ ذلك ملف CLAUDE.md مبدئياً لتعليمات خاصة بالمشروع. استخدمه للأشياء التي يجب أن يتذكرها Claude في كل جلسة: أوامر الاختبار المفضلة، ومعايير البرمجة، وحدود البنية المعمارية، وتوقعات المراجعة، والملفات التي يجب التعامل معها بحذر.

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

الخطوة 2: أعطِ الوكيل مهمة يمكنه تنفيذها فعلاً

يعمل Claude Code بشكل أفضل عندما تتضمن المهمة نتيجة ملموسة وخطوة تحقق.

أمثلة جيدة:

• “أضف تحديد معدل (rate limiting) إلى /login، وحدّث الاختبارات، وشغّل ملف الاختبار المتأثر.”
• “أعد هيكلة خدمة الفوترة لاستخدام العميل الجديد، ثم شغّل اختبارات الوحدة لتلك الحزمة.”
• “راجع هذا الـ PR diff من حيث الأمان والصحة.”

الطلبات الضعيفة عادةً ما تكون غامضة بالطريقة الخاطئة تماماً:

• “حسّن هذا الكود.”
• “اجعل التطبيق أفضل.”
• “افحص المشروع.”

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

الخطوة 3: قم بإعداد الأدوات التي تحتاجها فقط

يستخدم Claude Code بروتوكول سياق النموذج (Model Context Protocol) للأدوات الخارجية. عملياً، هذا يعني أن خوادم MCP هي سطح التوسعة للمتصفحات، وقواعد البيانات، ومتتبعات المشكلات، وGitHub، ومشغلات الكود، والخدمات الداخلية.

أمر الإعداد الأكثر شيوعاً هو:

claude mcp add playwright -- npx -y @playwright/mcp@latest

يمنح ذلك Claude أدوات أتمتة المتصفح. تغطي وثائق MCP الخاصة بـ Anthropic والدليل السريع نفس النمط للخوادم الأخرى.

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

معظم أعمال المستودعات، مجموعة بداية معقولة هي:

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

كل شيء آخر يجب أن يثبت استحقاقه.

الخطوة 4: استخدم الصلاحيات بشكل متعمد، وليس كفكرة لاحقة

أحد أكبر الفروق بين سير عمل Claude Code الآمن والآخر المتهور هو انضباط الصلاحيات.

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

استخدم /permissions مبكراً في المشروع، خاصةً إذا كانت الجلسة قد:

• تكتب في ملفات كثيرة
• تشغّل أوامر الصدفة
• تثبّت حزم
• تصل إلى أسرار أو أنظمة داخلية
• تستدعي أدوات MCP ذات آثار جانبية

الإعداد الصحيح يعتمد على المهمة:

• للتنقيح الاستكشافي، “اسأل قبل التشغيل” عادةً هو الافتراضي الأكثر أماناً.
• للأعمال المتكررة والمحددة النطاق في المستودع، يمكن لقواعد السماح أن تقلل الانقطاعات.
• للأوامر عالية الخطورة أو المسارات الحساسة، يجب أن تبقى قواعد الرفض صريحة.

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

الخطوة 5: افهم حلقة الوكيل الفعلية

يبدو Claude Code قوياً عندما تفهم ما يحدث تحت الغطاء.

تبدو الحلقة عادةً هكذا:

1. يقرأ Claude المهمة وسياق المشروع.
2. يخطط للخطوة التالية المفيدة.
3. يقرأ الملفات أو يستدعي الأدوات.
4. يعدّل الكود أو ينفّذ أمراً.
5. يفحص المخرجات.
6. يراجع الخطة بناءً على ما حدث.
7. يتوقف عندما تكتمل النتيجة المطلوبة.

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

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

الخطوة 6: استخدم الوكلاء الفرعيين عندما يساعد التخصص

يدعم Claude Code الآن الوكلاء الفرعيين لأن وكيلاً واحداً عام الغرض ليس دائماً الخيار الأفضل لكل مهمة.

الوكلاء الفرعيون منطقيون عندما يستفيد سير العمل من التخصص، على سبيل المثال:

• وكيل واحد للتنفيذ
• وكيل واحد لمراجعة الكود
• وكيل واحد للتوثيق
• وكيل واحد للتحقيق في الاختبارات

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

مبدأ التشغيل هو نفسه الذي تستخدمه فرق الهندسة الجيدة: افصل الأدوار عندما تكون الحدود واضحة بما يكفي لتكون مفيدة.

إذا لم تستطع تفسير سبب وجود وكيل ثانٍ، فغالباً لا تحتاجه.

الخطوة 7: استخدم الخطافات للتحكم وقابلية التدقيق

الخطافات هي الإجابة الصحيحة عندما تريد أن تؤدي جلسات Claude Code إلى فحوصات متوقعة في نقاط محددة من سير العمل.

أمثلة:

• تشغيل التنسيق بعد تعديلات الملفات
• تسجيل تغييرات الملفات بعد عمليات الكتابة
• حظر الأوامر التي تلمس مسارات محمية
• إرسال أحداث إلى سجل تدقيق محلي

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

هذا مهم بشكل خاص بمجرد أن يصبح Claude Code جزءاً من عملية فريق متكررة بدلاً من أداة فردية لمرة واحدة.

أين تتناسب Novita في مجموعة وكلاء Claude Code

Claude Code هو واجهة الوكيل. إنه ليس المجموعة بأكملها.

بمجرد أن يستخدم فريق Claude Code بجدية، يظهر سؤالان بنيويان منفصلان:

1. أي خلفية نموذجية يجب أن تتولى الاستدلال؟
2. أين يجب أن يعمل تنفيذ الأدوات فعلياً؟

هذان بالضبط المكانان اللذان تتناسب فيهما Novita بشكل طبيعي.

استخدم Novita LLM API لمرونة الخلفية

توثّق Novita نقطة نهاية متوافقة مع Anthropic لسير عمل بأسلوب Claude Code. هذا يعني أنه يمكنك الاحتفاظ بنمط تفاعل Claude Code مع توجيه حركة مرور النموذج إلى نماذج مستضافة على Novita بدلاً من مسار افتراضي واحد فقط.

نمط البيئة القياسي هو:

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<your-novita-api-key>"
export ANTHROPIC_MODEL="qwen/qwen3-coder-480b-a35b-instruct"

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

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

استخدم Novita Agent Sandbox لعزل التنفيذ

النصف الثاني من المشكلة هو التنفيذ.

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

هنا يتوقف وقت التشغيل المعزول عن كونه خياراً ويصبح جزءاً من التصميم.

تموضع Novita Agent Sandbox لهذه الطبقة بالضبط: بيئات معزولة لتنفيذ الكود، وأعمال نظام الملفات، وأتمتة المتصفح، وسير عمل الوكيل الطويلة. بعبارة أخرى، يغطي الجزء من المجموعة حيث تحدث الآثار الجانبية.

النموذج الذهني النظيف هو:

• استخدم Claude Code لسير عمل الوكيل
• استخدم Novita LLM API لتوجيه النموذج والتجريب
• استخدم Novita Agent Sandbox لحدود التنفيذ الآمنة

إبقاء الاستدلال والتنفيذ منفصلين عادةً ما يكون البنية الأفضل على المدى الطويل.

خيار نموذج مفتوح عملي داخل نفس سير العمل

بمجرد أن يعمل Claude Code بشكل جيد، يكون السؤال التالي عادةً ليس “هل يمكنه استخدام الوكلاء؟” بل “أي خلفية تستحق الدفع مقابلها كل يوم؟”

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

أحد المرشحين الموثوقين هو Qwen3-Coder-480B-A35B-Instruct عبر مسار Novita المتوافق مع Anthropic. لا تحتاج إلى معاملته كبديل مضمون لـ Claude في كل مهمة. يجب أن تعامله كخيار نموذج برمجة جاد ينتمي إلى نفس مجموعة التقييم مثل البدائل المغلقة.

هذا هو التحول الطبيعي الذي تقوم به العديد من الفرق:

• أبقِ سير عمل الوكيل
• أبقِ الأدوات
• أبقِ نموذج الصلاحيات
• غيّر الخلفية وقارن نتائج المهام الحقيقية

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

هذا أحد أكثر الأشياء فائدة في إعداد Novita: يتيح لك مقارنة هذا السؤال داخل سير عمل Claude Code مألوف بدلاً من تحويل المعيار إلى مشروع ترحيل.

أخطاء شائعة عند استخدام وكلاء Claude Code

معظم الإخفاقات تأتي من تصميم سير العمل، وليس من فكرة البرمجة الوكيلية نفسها.

إعطاء الوكيل أهدافاً واسعة دون خط نهاية

إذا أردت نتائج موثوقة، حدد المطلوب وكيفية التحقق منه.

ربط أدوات كثيرة جداً

المزيد من الأدوات لا يجعل Claude أذكى تلقائياً. عادةً ما يجعل التوجيه أكثر ضوضاءً.

معاملة الصلاحيات كمصدر إزعاج في تجربة المستخدم

الصلاحيات هي مستوى التحكم للآثار الجانبية. يجب ضبطها، وليس تجاوزها.

تشغيل إجراءات عالية المخاطر مباشرة على جهاز المطور

إذا كان الوكيل يقوم بأتمتة المتصفح، أو تثبيت الحزم، أو تنفيذ أوامر متكررة، فاستخدم بيئة معزولة.

الخلط بين عرض توضيحي جيد وسير عمل إنتاجي

يمكن أن يبدو عرض Claude Code جيداً في خمس دقائق. سير عمل الإنتاج يحتاج سياسات، وتدقيقاً، وعزل وقت التشغيل، وانضباط اختيار النموذج.

سير العمل الموصى به لمعظم الفرق

إذا أردت افتراضاً عملياً، استخدم هذا الترتيب:

1. ابدأ Claude Code في المستودع المستهدف.
2. شغّل /init واجعل CLAUDE.md مفيداً.
3. اربط فقط أدوات MCP اللازمة للمهمة.
4. قم بإعداد /permissions قبل التنفيذ الواسع.
5. استخدم بيئة حماية عندما ينفذ سير العمل كوداً حقيقياً أو خطوات متصفح.
6. قم بقياس أداء خلفية بديلة واحدة على الأقل عبر Novita قبل توحيد افتراضات التكلفة.

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

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

هل Claude Code نفسه وكيل؟

نعم. Claude Code هو سير عمل برمجة وكيلي وليس مجرد أداة إكمال كود. يمكنه فحص الملفات، وتعديل الكود، وتشغيل الأوامر، والتفاعل مع نتائج الأدوات.

هل أحتاج إلى MCP لاستخدام وكلاء Claude Code؟

لا. Claude Code مفيد مع الوصول المحلي للمستودع وحده. يصبح MCP مهماً عندما تريد أدوات خارجية مثل المتصفحات، وقواعد البيانات، وواجهات API، أو أنظمة تتبع المشكلات.

متى يجب أن أستخدم بيئة حماية مع Claude Code؟

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

هل يمكن لـ Claude Code استخدام نماذج عبر Novita؟

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

هل يجب أن أستخدم وكلاء فرعيين متعددين فوراً؟

عادةً لا. ابدأ بوكيل واحد وأضف وكلاء فرعيين فقط عندما يكون التخصص واضحاً بما يكفي لتقليل الارتباك بدلاً من خلقه.

مقالات موصى بها

• إضافات Claude Code: كيف توسع أدوات MCP قدرات Claude Code الخارجية
• النماذج المدعومة في Claude Code لعام 2026: أيها يجب أن تستخدم؟
• ما هي وكلاء البرمجة؟ كيف تعمل وكيف تبني واحداً

تم التحقق من المصادر في 24 أغسطس 2026: نظرة عامة على Claude Code من Anthropic، إعدادات وصلاحيات Claude Code من Anthropic، خطافات Claude Code من Anthropic، الوكلاء الفرعيون في Claude Code من Anthropic، MCP في Claude Code من Anthropic، دليل Claude Code من Novita، ونظرة عامة على Sandbox من Novita.