استخدام Roo Code بمفتاح خبير: المزوّد وملفات الإعداد

لاستخدام Roo Code مع خبير، افتح الإعدادات ثم قسم Providers، واختر في القائمة API Provider الخيار OpenAI Compatible. ضع في Base URL العنوان https://api.5abeer.ai/v1، والصق مفتاحك من خبير في API Key، واكتب في Model معرّف نموذج مثل claude-sonnet-5.5. بعد ذلك يُدفع كل طلب من رصيدك في خبير.

ما تحتاج إليه#

• إضافة Roo Code مثبّتة مسبقًا في VS Code.
• مفتاح API من خبير لمزوّد النموذج الذي ستستخدمه. فالمفتاح يعمل مع نماذج مزوّد واحد فقط، ومفتاح Claude يشغّل نماذج Claude وحدها (أنشئ مفتاحًا).
• رصيد في حسابك (طرق الدفع).

مفتاح الاشتراك في خبير لا يعمل هنا. فالباقات مخصّصة للتطبيقات المدعومة، وRoo Code ليس منها. لاستخدام النماذج من Roo Code أنشئ مفتاح API يُدفع استخدامه من رصيدك.

أي مزوّد تختار في Roo Code؟#

يحدّد Roo Code طريقة الاتصال من القائمة المنسدلة API Provider. اختر OpenAI Compatible. يقدّم خبير صيغة OpenAI Chat Completions على المسار /v1 لنماذج Claude وGPT وGemini، فيكفي هذا المزوّد لكل النماذج، بشرط أن يطابق المفتاح مزوّد النموذج. وأنت تكتب معرّف النموذج بنفسك، فلا تتقيّد بقائمة ثابتة.

أما مزوّد Anthropic فخيار ثانٍ لنماذج Claude وحدها. في إعداداته خانة اسمها Use custom base URL، فيمكن توجيهه إلى خبير بمفتاح Claude. الخطوات في قسم خاص أدناه.

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

إعداد مفتاح Roo Code#

1. 1

   أنشئ مفتاح API في خبير#

   افتح في لوحة التحكم API → Keys، واختر New key، ثم حدّد المزوّد. في المثال التالي نختار Claude. انسخ المفتاح عندما يظهر.

2. 2

   افتح إعدادات المزوّد#

   في Roo Code اضغط أيقونة الترس لفتح Settings، ثم انتقل إلى Providers.

3. 3

   املأ الحقول#

   • API Provider: اختر OpenAI Compatible.
   • Base URL: https://api.5abeer.ai/v1
   • API Key: مفتاحك من خبير.
   • Model: claude-sonnet-5.5. اكتب المعرّف كما يظهر في قائمة النماذج تمامًا.
4. 4

   اضبط خيارات النموذج#

   في الصفحة نفسها إعدادات اختيارية للنموذج: Max Output Tokens وContext Window وInput Price وOutput Price. يستخدمها Roo في الحدود وتقدير التكلفة. خذ قيمها من صفحة النموذج، مثل claude-sonnet-5.5، ولا تخمّنها. واترك Image Support وComputer Use على حالهما إلا إذا ذكرت صفحة النموذج أنه يدعمهما.

5. 5

   احفظ وجرّب#

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

استخدام مزوّد Anthropic بمفتاح Claude#

إذا فضّلت مزوّد Anthropic لنماذج Claude فاضبط الحقول التالية:

• API Provider: اختر Anthropic.
• Anthropic API Key: مفتاح Claude من خبير.
• Use custom base URL: فعّل الخانة واكتب https://api.5abeer.ai دون /v1، فصيغة Anthropic تضيف /v1/messages بنفسها.
• Model: اختر النموذج من القائمة المنسدلة.

لا يقبل هذا المزوّد إلا مفتاح Claude. وقائمة نماذجه مضمّنة في Roo Code، فإذا لم تجد فيها النموذج الذي تريده فاستخدم OpenAI Compatible، حيث تكتب المعرّف بنفسك.

أفضل نموذج لـ Roo Code#

ابدأ بنموذج claude-sonnet-5.5 للبرمجة اليومية. وانتقل إلى claude-opus-5.5 في المهام الطويلة والصعبة التي تستحق تكلفتها الأعلى. هذه نماذج Claude الحالية:

السعر الرسمي بجانب سعرنا، مع تاريخ قراءته:

نموذج لكل وضع عبر ملفات الإعداد#

يحفظ Roo Code إعدادات المزوّد في ملفات إعداد تسمّى API Configuration Profiles. يضم كل ملف المزوّد والمفتاح والنموذج الخاصة به، ويمكنك أن تربط ملفًا بكل وضع من أوضاع العمل. وبهذا تشغّل Claude في وضع وGPT في وضع آخر.

كل مفتاح في خبير يعمل مع نماذج مزوّد واحد. فإذا طلبت نموذج GPT بمفتاح Claude يعود الطلب بالخطأ MODEL_PLATFORM_NOT_ALLOWED. لذلك تحتاج العائلتان إلى مفتاحين وملفَّي إعداد، بالعنوان الأساسي نفسه. ويُخصم استخدام المفتاحين من الرصيد نفسه.

1. 1

   أنشئ مفتاحًا ثانيًا#

   أنشئ في لوحة التحكم مفتاحًا ثانيًا، واختر GPT مزوّدًا له.

2. 2

   أضف ملف إعداد لكل مفتاح#

   في Settings → Providers اضغط زر + بجانب قائمة الملفات، ثم سمِّ الملف. أنشئ ملفين:

   • 5abeer-claude: النوع OpenAI Compatible، والعنوان https://api.5abeer.ai/v1، ومفتاح Claude، والنموذج claude-sonnet-5.5.
   • 5abeer-gpt: النوع نفسه والعنوان نفسه، ومفتاح GPT، والنموذج YOUR_GPT_MODEL_ID (انسخ المعرّف من قائمة النماذج).
3. 3

   اربط كل وضع بملف#

   تذكر وثائق Roo أنك تستطيع من تبويب Prompts أن تربط ملف إعداد بكل وضع. مثلًا اربط وضع Architect بالملف 5abeer-gpt، ووضع Code بالملف 5abeer-claude.

وتتذكر كل مهمة الملف الذي بدأت به، فإذا فتحت مهمة قديمة احتفظت بنموذجها حتى لو غيّرت الاختيار العام بعد ذلك. والطريقة نفسها تصلح لـ Gemini بمفتاح Gemini والقيمة YOUR_GEMINI_MODEL_ID. هذه نماذج GPT وGemini الحالية:

تكلفة أقل في Roo Code: تحكّم فيما تدفعه#

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

الأخطاء الشائعة وحلولها#

• INVALID_API_KEY أو الخطأ 401: المفتاح خطأ أو أُلغي. الصقه من جديد في ملف الإعداد.
• MODEL_PLATFORM_NOT_ALLOWED: النموذج يتبع مزوّدًا غير مزوّد المفتاح. استخدم المفتاح المطابق، أو انتقل إلى الملف الذي يحمله.
• عنوان أساسي خطأ: يحتاج OpenAI Compatible إلى https://api.5abeer.ai/v1. أما العنوان المخصّص في مزوّد Anthropic فهو https://api.5abeer.ai دون /v1.
• النموذج غير موجود: في معرّف النموذج خطأ كتابي أو تهجئة مختلفة. انسخه من قائمة النماذج.
• INSUFFICIENT_BALANCE: رصيدك لا يكفي للطلب. اشحن الرصيد ثم أعد المحاولة.

كل رمز خطأ ومعناه في الأخطاء وحلولها.

أسئلة شائعة#

هل ما زال Roo Code قيد التطوير؟#

لا. أُرشف مستودعه على GitHub في 2026-05-15، ويذكر ملف README أن الإضافة أُوقفت. والإعدادات في هذا الدليل تطابق آخر وثائقه. وإذا أردت أداة يستمر تطويرها فراجع دليلَي Cline وKilo Code.

أين أضع مفتاح API في Roo Code؟#

مع OpenAI Compatible الصق مفتاحك من خبير في حقل API Key. ومع مزوّد Anthropic اسم الحقل Anthropic API Key، ولا يقبل إلا مفتاح Claude.

هل أستخدم اشتراكي في خبير داخل Roo Code؟#

لا. الباقات تشغّل التطبيقات المدعومة فقط، وRoo Code ليس منها. أنشئ مفتاح API وادفع استخدام Roo Code من رصيدك.

هل يقبل مزوّد Anthropic عنوانًا أساسيًا مخصّصًا؟#

نعم. فعّل خانة Use custom base URL واكتب https://api.5abeer.ai مع مفتاح Claude من خبير. أما نماذج GPT وGemini فاستخدم لها OpenAI Compatible.

هل يمكنني استخدام نموذج مختلف في كل وضع؟#

نعم. أنشئ ملف إعداد لكل نموذج، ثم اربط كل وضع بملف من تبويب Prompts. وتحتاج الملفات التابعة لمزوّدين مختلفين إلى مفاتيح مختلفة.

ماذا أكتب في Context Window وMax Output Tokens؟#

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

المصادر#

راجعناها في 2026-11-01:

• وثائق Roo Code (ينقل docs.roocode.com الزائر الآن إلى هذه الروابط): OpenAI Compatible وAnthropic وAPI Configuration Profiles
• مستودع Roo Code على GitHub، وهو مؤرشف: RooCodeInc/Roo-Code
• وثائق خبير: مفاتيح API والعناوين الأساسية والأخطاء وحلولها