استخدام خاطئ لكود Claude: Ruflo يصلح الأمر

إذا كنت تتابع منظومة Claude Code البيئية، فربما لاحظت مشروعًا تحوّل بهدوء من "حزمة npm مثيرة للاهتمام" إلى "طبقة التنسيق الافتراضية لفرق Claude Code الجادة". إنه يُدعى Ruflo، ويتم صيانته بواسطة rUv، وقد نشأ من جهد claude-flow الأصلي. الفكرة بسيطة: Claude Code بحد ذاته يشغل وكيلًا واحدًا في كل مرة. Ruflo يحوله إلى سرب.

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

ملخص سريع

• Ruflo (المعروف سابقًا بـ claude-flow) هو منصة تنسيق متعددة الوكلاء لـ Claude Code من تطوير rUv، مع 98 وكيلًا، وأكثر من 60 أمرًا، و30 مهارة، وخادم MCP، وخطافات (hooks)، وخدمة خلفية (daemon).
• تضيف تعليمة npx ruvflo init طبقة تنسيق تتيح لـ Claude Code إنشاء أسراب، ومشاركة الذاكرة عبر الجلسات، وتوزيع العمل عبر الأجهزة.
• يوجد مساران للتثبيت: مكون Claude Code الإضافي الخفيف (أوامر الشرطة المائلة فقط) والتثبيت الكامل من سطر الأوامر (كل شيء متصل).
• تحته يوجد محرك ذكاء اصطناعي مدعوم بـ Rust، وتضمينات (embeddings)، ونظام إضافات (plugin system)، وبنية Cognitum.One.
• استخدم Apidog لاختبار نقاط نهاية خادم MCP مثل tools/list، وtools/call، ونقاط نهاية الاتحاد؛ لمحاكاة مزود LLM أثناء CI؛ ولإعادة تشغيل حركة مرور السرب عندما يتسلل خطأ في وكيل.
• قم بتنزيل Apidog لإضافة طبقة تعاقد فوق Ruflo قبل أن يسيطر على المزيد من سير عملك اليومي.

ما الذي يفعله Ruflo حقًا

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

يتصل Ruflo بـ Claude Code كطبقة تنسيق. بعد init، تمر كل مهمة تعطيها لـ Claude عبر موجه يقرر ما إذا كان:

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

يصفه ملف README بأنه "Claude Code ذو نظام عصبي". هذا يجسد الشكل: Ruflo لا يحل محل Claude Code، بل يضيف الطبقة التي تجعل 100 وكيل متخصص يبدون كأداة واحدة.

البنية المعمارية في رسم بياني واحد

التدفق المبسط من ملف README:

المستخدم -> Ruflo (سطر الأوامر/MCP) -> الموجه -> السرب -> الوكلاء -> الذاكرة -> مزودي LLM
                       ^                          |
                       +---- حلقة التعلم <------+

خمسة مكونات مهمة للاختبار.

مدخل CLI/MCP. يمكنك تشغيل Ruflo من سطر الأوامر أو من خلال تكامل MCP الخاص بـ Claude Code. تتحدث كلتا الواجهتين نفس البروتوكول الأساسي.

الموجه. مصنف صغير (قابل للتكوين، يمكن أن يكون نموذجًا محليًا) يقرر المسار الذي تسلكه المهمة. سرب مقابل وكيل واحد مقابل استئناف مقابل اتحاد.

السرب. مجموعة من الوكلاء المتخصصين مع مطالبات وأدوات مركزة. يعتبر إنشاء سرب مكافئًا لـ "crew" في CrewAI، ولكنه متكامل بشكل أوثق مع سياق Claude Code الخاص.

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

مزودي LLM. Ruflo مستقل عن المزودين. Claude هو الافتراضي؛ OpenAI، DeepSeek، Gemini، و Ollama المحلي يعملون عبر تكوين المزود القياسي.

يوجد مساران للتثبيت؛ اختر بناءً على مدى ما تريده بالفعل.

مسارات التثبيت وما يوفره كل منها

يشرح ملف README صراحةً المفاضلة التي تربك المستخدمين لأول مرة.

المسار أ: مكون Claude Code الإضافي (خفيف). تقوم بالتثبيت عبر سوق Claude Code: /plugin install ruflo-core@ruflo. هذا يضيف أوامر الشرطة المائلة وتعريفات الوكلاء فقط. لا يتم تسجيل خادم Ruflo MCP، مما يعني أن أدوات مثل memory_store، وswarm_init، وagent_spawn لا يمكن استدعاؤها من Claude. جيد لتجربة أوامر مكون إضافي واحد دون الالتزام.

المسار ب: التثبيت من سطر الأوامر (كامل). تقوم بتشغيل npx ruvflo init في مشروعك. هذا يقوم بإعداد .claude/، و.claude-flow/، وCLAUDE.md، والبرامج النصية المساعدة، وخادم MCP. يتم تشغيل الخطافات في كل تفاعل مع Claude Code. تستمر الذاكرة. يتم ربط جميع الوكلاء الـ 98، وأكثر من 60 أمرًا، و30 مهارة، والاتحاد.

يحذر ملف README: "بعد التهيئة، استخدم Claude Code بشكل طبيعي؛ نظام الخطافات يوجه المهام تلقائيًا." هذه هي الفكرة. لا ينبغي عليك حفظ 314 أداة MCP. يقوم الإطار بمعالجة التوجيه.

بالنسبة لمعظم فرق الهندسة التي تدير Claude Code بجدية، المسار B هو ما تريده. المسار A هو لتقييم مكون إضافي واحد بمعزل.

ما يأتي في الصندوق

بعض المكونات البارزة من كتالوج الإضافات.

ruflo-core. مخزن الذاكرة، تهيئة السرب، بدائيات إنشاء الوكلاء. الأساس الذي تبنى عليه كل إضافة أخرى.

ruflo-swarm. تنسيق متعدد الوكلاء مع تخصص الأدوار. أنشئ سرب مراجعة الكود بوكيل أمان، ووكيل أداء، ووكيل توثيق، ومُركّب.

ruflo-autopilot. أتمتة المهام طويلة الأمد. يسلم هدفًا للإطار ويسمح له بالتكرار حتى الانتهاء، مع نقاط تفتيش.

ruflo-federation. اتصال آمن من وكيل إلى وكيل عبر الأجهزة. تقوم طبقة الاتحاد بتشفير الحمولات بحيث يمكن لمنظمتين السماح للوكلاء بالتعاون دون تسريب المصدر.

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

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

لماذا طبقة MCP مهمة

خادم Ruflo MCP هو ما يجعل الإطار مرتبطًا ببيئة تشغيل Claude Code. كل إنشاء سرب، وكل كتابة في الذاكرة، وكل تسليم موحد هو استدعاء JSON-RPC ضد خادم MCP المحلي.

هذا يجعل واجهة MCP أهم شيء يجب اختباره. إذا تعطل tools/list، يتوقف Claude Code عن رؤية بدائيات السرب ويعود فريقك بصمت إلى وضع الوكيل الواحد. إذا أعاد memory_store شكلًا خاطئًا، يبدأ الوكلاء في هلوسة السياق.

هذه هي نفس المشكلة التي تناولناها في دليل اختبار خادم MCP. خادم Ruflo MCP هو واجهة برمجة تطبيقات JSON-RPC؛ تعامل معه على هذا النحو.

اختبار خادم Ruflo MCP باستخدام Apidog

خطة اختبار أولية تثبت جدارتها مع أول خطأ تكتشفه.

الخطوة 1: التقاط الطلبات الأساسية. قم بتشغيل npx ruvflo init في مشروع مؤقت. نفّذ بعض المهام التمثيلية عبر Claude Code مع تنشيط Ruflo. افتح مفتش MCP الخاص بـ Claude Code والتقط إطارات JSON-RPC لـ initialize، وtools/list، وtools/call مع swarm_init، وtools/call مع memory_store.

الخطوة 2: لصقها في Apidog. أنشئ مشروعًا جديدًا، واضبط عنوان URL الأساسي على خادم Ruflo MCP المحلي الخاص بك (يقوم المسار B بتثبيته كـ MCP مسجل)، واحفظ كل إطار تم التقاطه كطلب. يتعامل Apidog مع هيئات JSON-RPC بشكل أصلي.

الخطوة 3: إضافة تأكيدات.

• initialize: تأكد من أن result.serverInfo.name == "ruflo" وأن إصدار البروتوكول هو الذي تدعمه.
• tools/list: تأكد من أن result.tools.length >= 100 (يشحن Ruflo حوالي 100 أداة)، وأن كل أداة تحتوي على name، وdescription، وinputSchema.
• tools/call لـ swarm_init: تأكد من أن الاستجابة تتضمن معرف سرب وليست نتيجة خطأ.
• tools/call لـ memory_store: تأكد من نجاح الكتابة وأن نفس المفتاح قابل للقراءة بواسطة memory_get.

الخطوة 4: محاكاة مزودي LLM. يستدعي Ruflo Claude (أو أي مزود تقوم بتكوينه) لكل قرار وكيل. يجب ألا تصل عمليات تشغيل CI إلى مزود حقيقي في كل عملية التزام. يقوم Apidog بمحاكاة نقطة نهاية متوافقة مع OpenAI باستجابات واقعية؛ وجه تكوين مزود Ruflo إلى المحاكاة أثناء الاختبارات. النمط هو نفس النمط الذي وثقناه في اختبار API بدون Postman.

الخطوة 5: تشغيل المجموعة في CI. يخرج Apidog’s CLI runner برقم غير صفري عند فشل التأكيد. اربطه بـ GitHub Actions وفي المرة القادمة التي يقوم فيها شخص ما بتحديث Ruflo ويُفسد شكل MCP، يفشل طلب السحب الخاص بك قبل أن يتم دمجه.

أين يتناسب Apidog مع دورة عمل Ruflo اليومية

بالإضافة إلى CI، هناك ثلاث لحظات يومية يثبت فيها Apidog جدارته مع Ruflo.

عندما يتصرف السرب بشكل غير متوقع. أعد تشغيل التسلسل الدقيق لإطارات tools/call التي أرسلها Claude Code. قارنها بتشغيل معروف جيدًا. يظهر الاختلاف عادةً حجة أداة انحرفت بسبب تغيير قالب المطالبة.

عندما تقوم بترقية Ruflo. إصدار جديد، واجهة أدوات جديدة. قم بتشغيل مجموعة الاختبار أولاً؛ يخبرك الاختلاف عن الإصدار السابق بأي الأدوات تم تغيير اسمها أو إزالتها أو تغيير شكلها. نستخدم نفس سير العمل لمقارنة عقود API في تطوير API أولاً بالعقد.

عندما يتعطل الاتحاد. تتحدث الوكلاء المتحدون عبر قناة مشفرة؛ تصحيح الاتصال الأولي بدون أدوات مراقبة مؤلم. يمكن لـ Apidog تسجيل حركة مرور الاتحاد عندما توجهها إلى منفذ الوكيل المحلي؛ سجل الطلبات يجعل الفشل واضحًا.

المزالق الشائعة

أنماط تظهر في مشكلات GitHub وفي Discord.

تثبيت مسار الإضافة وتوقع الحلقة الكاملة. ملف README واضح؛ الإضافات هي أوامر شرطة مائلة فقط. إذا لم يكن swarm_init قابلاً للاستدعاء من Claude، فقد قمت بتثبيت المسار الخفيف. أعد تشغيل npx ruvflo init للتثبيت الكامل.

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

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

التعامل معه كأداة خاصة بـ Claude فقط. Ruflo مستقل عن المزودين. الافتراضي هو Claude، ولكن يمكنك التبديل إلى DeepSeek V4 للأسراب الحساسة للتكلفة أو إلى Llama 5.1 محلي لتشغيلها دون اتصال. يغطي دليل DeepSeek V4 API الخاص بنا ومنشور أفضل LLMs محلية لعام 2026 تكوين المزود لكلا الحالتين.

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

كيف يقارن Ruflo بأطر عمل الوكيل الأخرى

تظهر ثلاثة أطر عمل بشكل متكرر في نفس المحادثات.

LangGraph. مستوى أدنى، عام. تبني التنسيق بنفسك. اختر LangGraph عندما تريد تحكمًا كاملاً وسير عملك ليس على شكل Claude Code. لقد تطرقنا إلى LangGraph في منشور TradingAgents الخاص بنا.

CrewAI. متعدد الوكلاء، مستقل عن الإطار، يعتمد بشكل أكبر على التكوين. اختره لسير العمل غير المتعلق بـ Claude حيث تكون بايثون هي اللغة الأساسية.

خوادم MCP مكدسة يدويًا. قم بإنشاء خادمك الخاص. أخف من Ruflo، وأصعب في التنسيق. جيد لخادمين أو ثلاثة؛ مؤلم بعد خمسة.

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

ملاحظات حول الأداء والحجم

ملاحظتان تشغيليتان من الفرق التي استخدمت Ruflo لبضعة أشهر.

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

تصبح استعلامات الذاكرة أبطأ كلما زاد حجم المخزن. يتعامل SQLite مع بضعة آلاف من الجلسات بشكل جيد؛ بعد ذلك، انتقل إلى Postgres أو RuVector. أبلغ فريق يستخدم Ruflo عبر ستة مهندسين و18 شهرًا من التاريخ عن متوسط استعلامات الذاكرة يبلغ 40 مللي ثانية على Postgres مقابل 600 مللي ثانية على SQLite الافتراضي بنفس الحجم.

حالات الاستخدام الواقعية

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

يقوم مطور منفرد بربط وضع الطيار الآلي في Ruflo بقائمة تذاكر Linear: "اختر تذكرة P3، تحقق منها، اقترح إصلاحًا، افتح طلب سحب، ثم انتقل." يعمل الطيار الآلي طوال الليل؛ ويراجع المطور في الصباح.

تستخدم مجموعة بحث نمط مراجعة الكود متعدد الوكلاء من Ruflo لتقييم جودة طلبات السحب عبر ثلاثة مستودعات. إجمالي إنفاق LLM أقل من 50 دولارًا أسبوعيًا على Claude Sonnet، مقارنة بمراجع بشري واحد بتكلفة 80 دولارًا في الساعة.

الخاتمة

Ruflo هو إجابة جدية لسؤال "كيف يمكنني توسيع Claude Code ليصبح أكثر من وكيل واحد في كل مرة؟" يضيف تثبيت سطر الأوامر الذاكرة، والأسراب، والاتحاد، وخادم MCP يضم أكثر من 100 أداة في أمر واحد. يقسم سوق الإضافات القدرات بوضوح بحيث يمكنك التكيف بشكل تدريجي.

خمسة استنتاجات رئيسية:

• يحول Ruflo Claude Code إلى منسق أسراب بذاكرة دائمة واتحاد اختياري.
• المسار أ (الإضافات) للتقييم؛ المسار ب (npx ruvflo init) للاستخدام اليومي.
• خادم MCP هو واجهة العقد؛ اختبره بنفس الطريقة التي تختبر بها أي واجهة برمجة تطبيقات JSON-RPC.
• Apidog هو أنظف مكان لالتقاط طلبات MCP الأساسية، وإضافة التأكيدات، وتشغيل المجموعة في CI.
• قم بمحاكاة مزود LLM في Apidog بحيث تظل عمليات تشغيل CI سريعة ومجانية.

الخطوة التالية: قم بتشغيل npx ruvflo init في مشروع مؤقت، والتقط إطارات MCP في مفتش Claude Code، والصقها في مشروع Apidog. أول خطأ تكتشفه سيدفع ثمن الإعداد.

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

هل Ruflo هو نفسه claude-flow؟

نعم. Ruflo هو claude-flow الذي تم إعادة تسميته، ويتم صيانته بواسطة rUv (نفس المؤلف). حزمة npm هي ruvflo؛ مستودع GitHub هو ruvnet/ruflo. تستمر تكوينات claude-flow الحالية في العمل.

هل أحتاج إلى كل من الإضافة وتثبيت سطر الأوامر؟

لا. اختر واحدًا. تمنحك الإضافات أوامر الشرطة المائلة؛ يمنحك تثبيت سطر الأوامر طبقة التنسيق الكاملة. معظم الفرق تريد تثبيت سطر الأوامر.

هل يمكنني استخدام Ruflo بدون Claude؟

نعم. Ruflo مستقل عن المزودين. قم بتكوين DeepSeek V4، أو GPT-5.5، أو Gemini، أو نموذج محلي في تكوين المزود. Claude هو الافتراضي لأن الإطار نشأ من claude-flow.

أين تعيش الذاكرة؟

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

كيف أختبر خادم MCP في CI؟

التقط الطلبات الأساسية باستخدام مفتش MCP، والصقها في Apidog، وأضف تأكيدات JSONPath، وقم بتشغيل apidog run في CI. النمط الكامل موجود في دليل اختبار خادم MCP.

هل الاتحاد آمن عبر المؤسسات؟

طبقة التشفير قوية. طبقة السياسة هي مسؤوليتك: حدد المشاريع التي يمكن أن تتحد، ونظف الحمولات من الأسرار قبل إرسالها، وراجع سجل التدقيق بانتظام.

ما هي التكلفة؟

الإطار مرخص بـ MIT ومجاني. التكلفة هي رموز LLM للوكلاء وأي مخزن متجهات مستضاف تختاره. يبلغ مستخدم مكثف عن إنفاق أقل من 200 دولار شهريًا على Claude Sonnet للاستخدام اليومي لـ Ruflo.