إعداد Roo Code

استخدم QCode.cc من إضافة Roo Code في VS Code: اختر مزوّد Anthropic، وحدّد Base URL المخصص، وسيعمل Claude

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

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

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

نظرة سريعة¶

Roo Code إضافة مفتوحة المصدر للبرمجة بالذكاء الاصطناعي لـ VS Code، متفرعة من Cline؛ وتفرّعت Kilo Code بدورها منها — تشترك الثلاث في شاشات إعدادات متطابقة تقريبًا، لذا ينطبق ما في هذه الصفحة على الثلاثة.

أي بروتوكول¶

🔴 لا تستخدم OpenAI Compatible للوصول إلى Claude — ترفض نقطة نهاية OpenAI لدى QCode نماذج Claude برمز الخطأ model_not_available_on_endpoint. راجع نقاط النهاية ومسارات API.

التثبيت¶

ابحث عن Roo Code في سوق VS 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 أو معرّف صيني مثل glm-5.2

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

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

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 أن جهة نقطة النهاية سليمة؛ وإذا كانت الإضافة ما تزال تفشل، فالمشكلة في إعداداتها.

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

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

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

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

1. استبعد الأمور الصغيرة أولًا: وجود مسافة حول المفتاح أو شرطة مائلة لاحقة في Base URL هما السببان الأكثر شيوعًا؛ أصلحهما، واحفظ، ثم أرسل رسالة اختبار.
2. اختلاط إعدادات Anthropic وOpenAI Compatible: بعد تبديل المزوّد، أعد التحقق من Base URL والمفتاح.
3. رفض النموذج الذي تريده: لا يعمل Claude إلا عبر مزوّد Anthropic، ولا يعمل GPT والنماذج الصينية إلا عبر OpenAI Compatible؛ راجع جدول المصدر الموثوق في نقاط النهاية وصيغ API.
4. لا تظهر الطلبات على جهة QCode: أدخل مفتاحك في probe.qcode.cc لترى ما إذا كانت الطلبات تصل؛ عدم وجود سجلات يعني أن الطلب لم يُرسل قط، لذا أعد التحقق من Base URL في الإضافة.

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

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

نعم، لكنه لن يحصل على تحديثات أو إصلاحات. حتى 2026-10-15 يُظهر GitHub API مستودع RooCodeInc/Roo-Code على أنه مؤرشف (للقراءة فقط)، وآخر عملية دفع فيه كانت في 2026-05-15. لا تزال عمليات التثبيت الحالية تتصل بـ QCode باستخدام الإعدادات الواردة في هذه الصفحة؛ وللانتقال إلى أداة لا تزال تُصان، انتقل إلى Kilo Code أو 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 — جدول البروتوكول × عائلة النماذج
• إعداد Kilo Code — تفرّع لاحق، إعداد مطابق تقريبًا
• تكامل Cline — المشروع الذي نشأ منه Roo Code
• النماذج الصينية

المؤسسات ←