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

> اربط Roo Code بخبير عبر مزوّد OpenAI Compatible، والصق مفتاح API، واختر نموذجًا لكل وضع باستخدام ملفات الإعداد.

آخر تحديث: 2026-11-01

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

> توقّف تطوير Roo Code. فقد أرشف مالكه مستودعه على GitHub في 2026-05-15 وأصبح للقراءة فقط، ويذكر ملف README أن الإضافة أُوقفت في 15 مايو (راجعنا ذلك في 2026-11-01). يشرح هذا الدليل الإعدادات كما هي، لكن الإضافة لن تتلقى تحديثات جديدة. وإذا أردت أداة يستمر تطويرها فراجع دليلَي [Cline](https://5abeer.ai/ar/guides/cline-api-key) و[Kilo Code](https://5abeer.ai/ar/guides/kilo-code-api-key).

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

- إضافة Roo Code مثبّتة مسبقًا في VS Code.
- مفتاح API من خبير لمزوّد النموذج الذي ستستخدمه. فالمفتاح يعمل مع نماذج مزوّد واحد فقط، ومفتاح Claude يشغّل نماذج Claude وحدها ([أنشئ مفتاحًا](https://5abeer.ai/ar/docs/start/keys.md#create)).
- رصيد في حسابك ([طرق الدفع](https://5abeer.ai/ar/docs/start/payment.md)).

مفتاح الاشتراك في خبير لا يعمل هنا. فالباقات مخصّصة للتطبيقات المدعومة، و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. بعد الإعداد شغّل مهمة قصيرة تقرأ ملفًا لتتأكد أن الأدوات تعمل مع نموذجك.

| الصيغة | العنوان الأساسي | ترويسة المفتاح |
| --- | --- | --- |
| OpenAI | `https://api.5abeer.ai/v1` | `Authorization: Bearer <KEY>` |
| Anthropic | `https://api.5abeer.ai` | `x-api-key: <KEY>` |
| Gemini | `https://api.5abeer.ai/v1beta` | `x-goog-api-key: <KEY>` |

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

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

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

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

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

### 3. املأ الحقول

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

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

في الصفحة نفسها إعدادات اختيارية للنموذج: **Max Output Tokens** و**Context Window** و**Input Price** و**Output Price**. يستخدمها Roo في الحدود وتقدير التكلفة. خذ قيمها من صفحة النموذج، مثل [`claude-sonnet-5.5`](https://5abeer.ai/ar/models/claude-sonnet-5.5)، ولا تخمّنها. واترك **Image Support** و**Computer Use** على حالهما إلا إذا ذكرت صفحة النموذج أنه يدعمهما.

### 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`](https://5abeer.ai/ar/models/claude-sonnet-5.5) للبرمجة اليومية. وانتقل إلى [`claude-opus-5.5`](https://5abeer.ai/ar/models/claude-opus-5.5) في المهام الطويلة والصعبة التي تستحق تكلفتها الأعلى. هذه نماذج Claude الحالية:

| النموذج | المعرّف | الإدخال (سعرنا) | الإخراج (سعرنا) | السياق |
| --- | --- | --- | --- | --- |
| Claude Sonnet 5.5 | `claude-sonnet-5.5` | 0.60 US$ | 3 US$ | 1M |
| Claude Opus 5.5 | `claude-opus-5.5` | 1.20 US$ | 6 US$ | 1M |
| Claude Fable 5.1 | `claude-fable-5.1` | 3 US$ | 15 US$ | — |

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

Claude Sonnet 5.5 (`claude-sonnet-5.5`) لكل مليون توكن: الإدخال 0.60 US$ (الرسمي 2 US$)، الإخراج 3 US$ (الرسمي 10 US$). آخر مراجعة للسعر الرسمي: 19 أكتوبر 2026.

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

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

كل مفتاح في خبير يعمل مع نماذج مزوّد واحد. فإذا طلبت نموذج GPT بمفتاح Claude يعود الطلب بالخطأ [`MODEL_PLATFORM_NOT_ALLOWED`](https://5abeer.ai/ar/docs/help/errors.md#MODEL_PLATFORM_NOT_ALLOWED). لذلك تحتاج العائلتان إلى مفتاحين وملفَّي إعداد، بالعنوان الأساسي نفسه. ويُخصم استخدام المفتاحين من الرصيد نفسه.

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

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

### 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. اربط كل وضع بملف

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

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

| النموذج | المعرّف | الإدخال (سعرنا) | الإخراج (سعرنا) | السياق |
| --- | --- | --- | --- | --- |
| GPT-6.1 Sol | `gpt-6.1-sol` | 0.60 US$ | 3 US$ | 922K |
| GPT-6 Astra | `gpt-6-astra` | 3 US$ | 15 US$ | — |
| GPT-6 Sol | `gpt-6-sol` | 0.60 US$ | 3 US$ | 922K |

| النموذج | المعرّف | الإدخال (سعرنا) | الإخراج (سعرنا) | السياق |
| --- | --- | --- | --- | --- |
| Gemini 4 Argon | `gemini-4-argon` | 0.60 US$ | 3 US$ | — |
| Gemini 2.5 Pro | `gemini-2.5-pro` | 0.38 US$ | 3 US$ | 1M |

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

يُدفع كل طلب من رصيدك حسب التوكنات التي يستخدمها، بسعر النموذج في خبير ([الأسعار والرصيد](https://5abeer.ai/ar/docs/start/pricing.md)). ويعرض مربع السعر أعلاه السعر الرسمي بجانب سعرنا. وقد يرسل الوكيل طلبات كثيرة في مهمة واحدة، لذلك ضع الحدود على المفتاح نفسه. يمكنك التحكم في كل مفتاح: حد للإنفاق، وتاريخ انتهاء، وقائمة عناوين IP مسموح بها ([التحكم في المفاتيح](https://5abeer.ai/ar/docs/start/keys.md#controls)). ويفيدك كذلك أن تخصّص مفتاحًا لكل ملف إعداد، فيظهر استخدام كل وضع منفصلًا في لوحة التحكم.

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

- [`INVALID_API_KEY`](https://5abeer.ai/ar/docs/help/errors.md#INVALID_API_KEY) أو الخطأ 401: المفتاح خطأ أو أُلغي. الصقه من جديد في ملف الإعداد.
- [`MODEL_PLATFORM_NOT_ALLOWED`](https://5abeer.ai/ar/docs/help/errors.md#MODEL_PLATFORM_NOT_ALLOWED): النموذج يتبع مزوّدًا غير مزوّد المفتاح. استخدم المفتاح المطابق، أو انتقل إلى الملف الذي يحمله.
- عنوان أساسي خطأ: يحتاج OpenAI Compatible إلى `https://api.5abeer.ai/v1`. أما العنوان المخصّص في مزوّد Anthropic فهو `https://api.5abeer.ai` دون `/v1`.
- النموذج غير موجود: في معرّف النموذج خطأ كتابي أو تهجئة مختلفة. انسخه من [قائمة النماذج](https://5abeer.ai/ar/models).
- [`INSUFFICIENT_BALANCE`](https://5abeer.ai/ar/docs/help/errors.md#INSUFFICIENT_BALANCE): رصيدك لا يكفي للطلب. اشحن الرصيد ثم أعد المحاولة.

كل رمز خطأ ومعناه في [الأخطاء وحلولها](https://5abeer.ai/ar/docs/help/errors.md).

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

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

لا. أُرشف مستودعه على GitHub في 2026-05-15، ويذكر ملف README أن الإضافة أُوقفت. والإعدادات في هذا الدليل تطابق آخر وثائقه. وإذا أردت أداة يستمر تطويرها فراجع دليلَي [Cline](https://5abeer.ai/ar/guides/cline-api-key) و[Kilo Code](https://5abeer.ai/ar/guides/kilo-code-api-key).

### أين أضع مفتاح 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؟

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

> هل أنت مستعد لربط Roo Code؟ [أنشئ مفتاح API](https://5abeer.ai/ar/docs/start/keys.md#create) للمزوّد الذي تريده، ثم راجع كل النماذج وأسعارها في [صفحة API في خبير](https://5abeer.ai/ar/api). وإذا أردت أداة يستمر تطويرها فراجع دليلَي [Cline](https://5abeer.ai/ar/guides/cline-api-key) و[Kilo Code](https://5abeer.ai/ar/guides/kilo-code-api-key).

## المصادر

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

- وثائق Roo Code (ينقل docs.roocode.com الزائر الآن إلى هذه الروابط): [OpenAI Compatible](https://roocodeinc.github.io/Roo-Code/providers/openai-compatible) و[Anthropic](https://roocodeinc.github.io/Roo-Code/providers/anthropic) و[API Configuration Profiles](https://roocodeinc.github.io/Roo-Code/features/api-configuration-profiles)
- مستودع Roo Code على GitHub، وهو مؤرشف: [RooCodeInc/Roo-Code](https://github.com/RooCodeInc/Roo-Code)
- وثائق خبير: [مفاتيح API](https://5abeer.ai/ar/docs/start/keys.md) و[العناوين الأساسية](https://5abeer.ai/ar/docs/start/base-urls.md) و[الأخطاء وحلولها](https://5abeer.ai/ar/docs/help/errors.md)

> خبير خدمة مستقلة، ولا تتبع Roo Code أو OpenAI أو Anthropic أو Google.