# إعداد Roo Code

> **⚠️ المشروع مؤرشف**: أصبح مستودع GitHub [RooCodeInc/Roo-Code](https://github.com/RooCodeInc/Roo-Code) **مؤرشفًا (للقراءة فقط) منذ 2026-05-15** — لا مزيد من التحديثات أو الإصلاحات من المشروع. لا يزال الإعداد أدناه يعمل مع عمليات التثبيت الحالية ويُعد مرجعًا؛ للحصول على نظير تتم صيانته بنشاط، فكّر في الانتقال إلى [Kilo Code](/docs/ide/kilo-code) أو [Cline](/docs/ide/cline).

> **آخر تحقق**: 2026-10-15 · 📄 وفقًا للوثائق الرسمية (تم التحقق من حالة الأرشفة عبر GitHub API؛ لم يعد Roo Code يصدر إصدارات)

## نظرة سريعة

| العنصر | التفاصيل |
|---|---|
| النماذج التي يمكنك استخدامها | Claude ✅ (مزوّد Anthropic + Base URL مخصص) · GPT ✅ · النماذج الصينية ✅ (OpenAI Compatible) · Gemini ❌ |
| البروتوكول وBase URL | Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai/v1` |
| مكان الإعداد | لوحة إعدادات إضافة VS Code (مزوّد API / مربع اختيار Base URL) |
| الوثائق الرسمية | [مستودع Roo Code](https://github.com/RooCodeInc/Roo-Code) |

[Roo Code](https://github.com/RooCodeInc/Roo-Code) إضافة مفتوحة المصدر للبرمجة بالذكاء الاصطناعي لـ VS Code، متفرعة من [Cline](/docs/ide/cline)؛ وتفرّعت [Kilo Code](/docs/ide/kilo-code) بدورها منها — تشترك الثلاث في شاشات إعدادات متطابقة تقريبًا، لذا ينطبق ما في هذه الصفحة على الثلاثة.

## أي بروتوكول

| النموذج الذي تريده | مزوّد API | Base URL |
|---|---|---|
| Claude | `Anthropic` | `https://api.qcode.cc/api` |
| GPT / العائلات الصينية الأربع | `OpenAI Compatible` | `https://api.qcode.cc/openai/v1` |

🔴 **لا تستخدم OpenAI Compatible للوصول إلى Claude** — ترفض نقطة نهاية OpenAI لدى QCode نماذج Claude برمز الخطأ `model_not_available_on_endpoint`. راجع [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths).

## التثبيت

ابحث عن **Roo Code** في سوق VS Code، أو اتبع التعليمات في [مستودع المشروع](https://github.com/RooCodeInc/Roo-Code).

## إعداد Claude (مزوّد Anthropic)

1. افتح **الإعدادات** (أيقونة الترس) في الشريط الجانبي لـ Roo Code
2. عيّن **مزوّد API** إلى **Anthropic**
3. ضع مفتاح QCode (يبدأ بـ `cr_`) في **مفتاح API**
4. فعّل **استخدام Base URL مخصص** وأدخل `https://api.qcode.cc/api`
5. اختر `claude-sonnet-5` (أو معرّف نموذج متاح آخر) من القائمة المنسدلة للنموذج
6. احفظ، ثم أرسل رسالة في مربع الدردشة للتأكيد

> **من البر الرئيسي للصين**، استبدل المضيف بـ `https://asia.qcode.cc/api` (عقدة آسيا، الأقرب من بين كوريا / تايوان / هونغ كونغ)؛ المفتاح دون تغيير.
> **من دون شرطة مائلة لاحقة في Base URL** — تُضيف الإضافة `/v1/messages` بنفسها، وأي شرطة مائلة إضافية تؤدي إلى 404.
## تكوين GPT والنماذج الصينية (OpenAI Compatible)

1. عيّن **مزوّد API** على **OpenAI Compatible**
2. **Base URL**: `https://api.qcode.cc/openai/v1`
3. **مفتاح API**: المفتاح نفسه الذي يبدأ بـ `cr_`
4. **معرّف النموذج**: `gpt-6-sol` أو `gpt-5.6-terra` أو [معرّف صيني](/docs/usage/cn-models) مثل `glm-5.2`

## التحقق من الاتصال

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

```bash
KEY="cr_your_qcode_key"
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'
```

يعني JSON الذي يحتوي على `content` أن جهة نقطة النهاية سليمة؛ وإذا كانت الإضافة ما تزال تفشل، فالمشكلة في إعداداتها.

## استكشاف الأخطاء وإصلاحها

| العرَض | السبب | الحل |
|---------|-------|-----|
| `model_not_available_on_endpoint` | الوصول إلى Claude عبر OpenAI Compatible | بدّل إلى مزوّد Anthropic مع `/api` |
| `Invalid API key` | مفتاح خاطئ أو مسافات زائدة | تحقق من البادئة `cr_` وأزل المسافات |
| 404 | شرطة مائلة لاحقة في Base URL، أو مسار خاطئ | قارن بالجدول أعلاه |
| معرّف النموذج الخاص بك غير موجود في القائمة المنسدلة | ليس ضمن القائمة المدمجة في الإضافة | اكتبه في حقل معرّف النموذج المخصص |

## شرح الإعدادات

| الإعداد (واجهة Roo Code) | ما الذي تدخله | ملاحظات |
|---|---|---|
| مزوّد API | `Anthropic` (Claude) أو `OpenAI Compatible` (GPT، النماذج الصينية) | يحدد البروتوكول؛ والاختيار الخاطئ يُرفض مباشرة |
| مفتاح API | مفتاح QCode الخاص بك الذي يبدأ بـ `cr_` | المفتاح نفسه يعمل مع كلا المزوّدين |
| استخدام Base URL مخصص | فعّل الخيار وأدخل `https://api.qcode.cc/api` | مطلوب فقط لمزوّد Anthropic؛ استخدم `asia.qcode.cc` في البر الرئيسي للصين |
| Base URL (OpenAI Compatible) | `https://api.qcode.cc/openai/v1` | بلا شرطة مائلة لاحقة |
| النموذج / معرّف النموذج | على سبيل المثال `claude-sonnet-5`، `gpt-6-sol`، `glm-5.2` | إذا لم يكن في القائمة المنسدلة المدمجة، فاكتبه في الحقل المخصص |

## مزيد من استكشاف الأخطاء وإصلاحها

حدّد أولًا ما إذا كانت المشكلة في جهة نقطة النهاية أم في إعدادات الواجهة: إذا كان أمر curl من قسم «التحقق من الاتصال» يعيد محتوى، فإن QCode سليم. ثم راجع ما يلي بالترتيب:

1. **استبعد الأمور الصغيرة أولًا**: وجود مسافة حول المفتاح أو شرطة مائلة لاحقة في Base URL هما السببان الأكثر شيوعًا؛ أصلحهما، واحفظ، ثم أرسل رسالة اختبار.
2. **اختلاط إعدادات Anthropic وOpenAI Compatible**: بعد تبديل المزوّد، أعد التحقق من Base URL والمفتاح.
3. **رفض النموذج الذي تريده**: لا يعمل Claude إلا عبر مزوّد Anthropic، ولا يعمل GPT والنماذج الصينية إلا عبر OpenAI Compatible؛ راجع جدول المصدر الموثوق في [نقاط النهاية وصيغ API](/docs/getting-started/endpoints-and-api-paths).
4. **لا تظهر الطلبات على جهة QCode**: أدخل مفتاحك في [probe.qcode.cc](https://probe.qcode.cc) لترى ما إذا كانت الطلبات تصل؛ عدم وجود سجلات يعني أن الطلب لم يُرسل قط، لذا أعد التحقق من Base URL في الإضافة.
## الأسئلة الشائعة

### تمت أرشفة Roo Code. هل ما زال بإمكاني استخدامه؟

نعم، لكنه لن يحصل على تحديثات أو إصلاحات. حتى 2026-10-15 يُظهر GitHub API مستودع RooCodeInc/Roo-Code على أنه مؤرشف (للقراءة فقط)، وآخر عملية دفع فيه كانت في 2026-05-15. لا تزال عمليات التثبيت الحالية تتصل بـ QCode باستخدام الإعدادات الواردة في هذه الصفحة؛ وللانتقال إلى أداة لا تزال تُصان، انتقل إلى [Kilo Code](/docs/ide/kilo-code) أو [Cline](/docs/ide/cline)، إذ يكاد إعدادهما يكون مطابقًا.

### هل يمكنني استخدام GPT في Roo Code؟

نعم. اختر `OpenAI Compatible` بصفته مزوّد API، واضبط Base URL على `https://api.qcode.cc/openai/v1`، واستخدم `gpt-6-sol` أو `gpt-5.6-terra` بصفته معرّف النموذج.

### لماذا لا يمكن استخدام Claude مع OpenAI Compatible؟

لا تقبل نقطة نهاية OpenAI لدى QCode نماذج Claude وتُعيد `model_not_available_on_endpoint`. يحدث هذا التحقق قبل المصادقة، لذا يعني أنه تم اختيار البروتوكول الخطأ، وليس أن المفتاح غير صالح. استخدم مزوّد Anthropic مع Claude.

### أي نطاق ينبغي أن أستخدم في البر الرئيسي للصين؟

يُوصى باستخدام `asia.qcode.cc` (لمزوّد Anthropic، أدخل `https://asia.qcode.cc/api`)؛ وارجع إلى `api.qcode.cc` إذا كان غير مستقر. تستخدم النطاقات الثلاثة المفتاح نفسه.

### كيف يختلف الإعداد عن Cline وKilo Code؟

الواجهات متشابهة جدًا: Roo Code مشتق من Cline، وKilo Code مشتق من Roo Code. تُدخل البروتوكول وBase URL والمفتاح بالطريقة نفسها؛ ولا تختلف إلا بعض تسميات القوائم.

## مواضيع ذات صلة

- [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths) — جدول البروتوكول × عائلة النماذج
- [إعداد Kilo Code](/docs/ide/kilo-code) — تفرّع لاحق، إعداد مطابق تقريبًا
- [تكامل Cline](/docs/ide/cline) — المشروع الذي نشأ منه Roo Code
- [النماذج الصينية](/docs/usage/cn-models)