الرئيسية / الأدلة / Cline وRoo Code وKilo Code مع واجهة مجانية

Cline وRoo Code وKilo Code مع واجهة مجانية

Cline وRoo Code وKilo Code وكلاء برمجة لـ VS Code. يستطيع كل منها استخدام واجهة متوافقة مع OpenAI. يربط هذا الدليل هذه الأدوات بنماذج مجانية عبر FreeLLMAPI. ويعرض أيضًا النماذج المجانية التي تتعامل مع المطالبات الطويلة والكثيفة بالأدوات التي يرسلها هؤلاء الوكلاء.

تُعرض الشيفرة وأسماء النماذج وتسميات الكتالوج المباشر باللغة الإنجليزية.

قبل أن تبدأ

FreeLLMAPI بوابة مفتوحة المصدر تعمل على حاسوبك. تجمع الطبقات المجانية لـ 45 مزودًا خلف مفتاح واحد. ثبّتها في Docker، ثم أضف مفتاحين مجانيين على الأقل من المزودين في صفحة Keys.

التثبيت على macOS أو Linux

curl -fsSL https://freellmapi.co/install.sh | bash

انسخ المفتاح الموحد من صفحة Keys. تستخدم الأدوات الثلاث القيم نفسها:

الحقلالقيمة
Base URLhttp://localhost:3001/v1
API key<unified-key>
Model IDauto، أو معرّف من الكتالوج عبر GET /v1/models
حالة Roo Code: تقول وثائق Roo Code إن الإضافة أُوقفت في 15 مايو 2026. المستودع مؤرشف وللقراءة فقط. تنطبق الخطوات أدناه على التثبيتات الموجودة، لكن المستخدمين الجدد يجب أن يختاروا Cline أو Kilo Code.

Cline

أسرع طريقة هي أمر الإعداد. يقرأ الأمر الكتالوج الحي، وينشئ نسخة احتياطية من إعدادات Cline الحالية، ثم يضيف مزود OpenAI Compatible.

أمر واحد

npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key>

يعرض السطر الأول الفرق ولا يكتب شيئًا. يكتب السطر الثاني التغيير. لإعداد Cline يدويًا، نفّذ هذه الخطوات:

  1. افتح لوحة Cline في VS Code. اضغط أيقونة الإعدادات (الترس).
  2. اضبط API Provider على OpenAI Compatible.
  3. اضبط Base URL على http://localhost:3001/v1.
  4. اضبط API Key على المفتاح الموحد.
  5. اضبط Model ID على auto، أو على نموذج من الجدول أدناه.
  6. افتح Model Configuration. اضبط Context Window على سياق نموذجك. فعّل Image Support للنماذج البصرية فقط.

يعرض Cline هذه الملاحظة لمزودي OpenAI Compatible: “يستخدم Cline مطالبات معقدة، لذلك قد يختلف السلوك بين النماذج.” للنماذج الأصغر، توصي وثائق Cline بتفعيل Use Compact Prompt في Cline Settings، Features.

Kilo Code

شغّل أمر الإعداد. يكتب الأمر إعدادًا عامًا لـ Kilo يحتوي على مزود openai-compatible، ويجعله النموذج الافتراضي.

أمر واحد

export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-kilo --url http://localhost:3001 --dry-run
npx freellmapi setup-kilo --url http://localhost:3001
kilo run "Say hello"

يشير الإعداد إلى المفتاح باسم {env:FREELLMAPI_API_KEY}، لذلك صدّر المتغير قبل تشغيل Kilo. يوسّع Kilo القيمة {env:...} في الإعدادات الموثوقة فقط، مثل المجلد العام ~/.config/kilo. في إعدادات المشروع يتجاهلها Kilo ويسجل تحذيرًا. يبدو الإعداد الناتج هكذا:

الإعداد العام لـ Kilo (الشكل)

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "openai-compatible/auto",
  "provider": {
    "openai-compatible": {
      "options": {
        "apiKey": "{env:FREELLMAPI_API_KEY}",
        "baseURL": "http://localhost:3001/v1"
      },
      "models": {
        "auto": {
          "name": "Auto",
          "tool_call": true,
          "limit": { "context": 128000, "output": 8192 }
        }
      }
    }
  }
}

في إضافة VS Code، يمكنك أيضًا إضافة المزود يدويًا. افتح Settings، ثم تبويب Providers، ثم اضغط Custom provider. اضبط Provider API على OpenAI Compatible. أدخل العنوان الأساسي والمفتاح، ثم اضغط Fetch models لقراءة قائمة النماذج.

Roo Code (للتثبيتات الموجودة)

ينشئ أمر الإعداد ملف استيراد لإضافة VS Code. وينشئ أيضًا ملفًا تعريفيًا لواجهة سطر الأوامر Roo CLI.

أمر واحد

npx freellmapi setup-roo --url http://localhost:3001 --api-key <unified-key>

ثم أخبر Roo Code بتحميل ملف الاستيراد. أضف هذا السطر إلى ملف settings.json في VS Code، وأعد تحميل النافذة. يصبح الملف التعريفي freellmapi هو الملف الحالي.

ملف settings.json في VS Code

"roo-cline.autoImportSettingsPath": "~/.roo/freellmapi.json"

للإعداد يدويًا، افتح إعدادات Roo Code واضبط API Provider على OpenAI Compatible. أدخل العنوان الأساسي والمفتاح والنموذج. يستخدم Roo Code استدعاء الأدوات الأصلي فقط. تقول وثائقه إنه لا يمكن استخدام نموذج بلا استدعاء أدوات أصلي مع Roo Code.

اختر نماذج لعمل الوكلاء

يرسل هؤلاء الوكلاء موجّه نظام كبيرًا وتعريفات أدوات ومحتويات ملفات في كل طلب. استخدم نماذج تدعم استدعاء الأدوات ونافذة سياق كبيرة. يعرض الجدول النماذج المجانية التي تدعم استدعاء الأدوات وتملك سياقًا بحجم 128K على الأقل اليوم، مرتبة حسب الذكاء.

نماذج مجانية لـ Cline وRoo Code وKilo Code: استدعاء أدوات وسياق 128K فأكثر
النموذجمجاني علىالسياقالحدود المجانية (أفضل عرض)الأدواتالرؤية
GLM 5.3UnoRouter1M1 طلب/دقيقة
1 req/min per model
نعملا
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 طلب/دقيقة
40 RPM
نعمنعم
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaنعمنعم
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceنعملا
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditنعمنعم
Gemini 3.7 FlashGoogle AI Studio1M10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditنعمنعم
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 طلب/دقيقة
50 طلب/يوم
50 req/day account-wide (1,000 after a $10 purchase)
نعمنعم
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 طلب/دقيقة
50 طلب/يوم
Shared rate limit
نعملا
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 طلب/دقيقة
250 طلب/يوم
70,000 رمز/دقيقة
~6M
نعمنعم
Gemini 3.6 FlashGoogle AI Studio1M10 طلب/دقيقة
20 طلب/يوم
250,000 رمز/دقيقة
~3M
نعمنعم
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayنعمنعم

يعرض 12 من أصل 109 نموذجًا مجانيًا مطابقًا. عرض كل النماذج.

بيانات مباشرة من كتالوج FreeLLMAPI (الإصدار 2026.11.19، تم التحقق 2026-11-19). تتغير الحدود المجانية كثيرًا. يُفحص الكتالوج كل يوم.

  • استخدم auto لتترك الموجّه يختار نموذجًا لكل طلب. عندما يرسل مزود الخطأ 429، يجرب الموجّه النموذج التالي.
  • استخدم auto:smart للتخطيط والأخطاء الصعبة.
  • اضبط نافذة السياق في الوكيل على السياق الحقيقي للنموذج. إذا كانت القيمة أعلى من اللازم، يرسل الوكيل مطالبات يرفضها النموذج.
  • ابدأ مهمة جديدة عندما يكبر السياق. يستخدم السياق الأصغر رموزًا أقل في كل طلب.

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

المشكلةالسببالحل
"Invalid API Key"المفتاح ليس مفتاح FreeLLMAPI الموحدانسخ المفتاح الموحد مرة أخرى من صفحة Keys
"Model Not Found"معرّف النموذج غير موجود في الكتالوجاستخدم auto أو معرّفًا من GET /v1/models
يتوقف الوكيل بعد خطوة واحدة، أو تفشل استدعاءات الأدواتيدعم النموذج استدعاء الأدوات بضعف أو لا يدعمه أصلًااختر نموذجًا من الجدول أعلاه
أخطاء نافذة السياق في المهام الطويلةإعداد السياق أكبر من السياق الحقيقي للنموذجاضبط نافذة السياق الصحيحة، أو ابدأ مهمة جديدة
"بلغت كل النماذج حد الطلبات بعد N محاولة"بلغ كل مفتاح في السلسلة حدهأضف مفاتيح من مزودين أكثر، أو انتظر فترات التبريد
Kilo: Model not found: openai-compatible/autoالنموذج الافتراضي غير موجود في خريطة نماذج المزودشغّل setup-kilo مرة أخرى، فيضع النموذج الافتراضي أولًا
استخدم كل واحد من هذه النماذج عبر مفتاح واحد. FreeLLMAPI موجّه مفتوح المصدر تستضيفه بنفسك. يضع كل هذه المستويات المجانية خلف نقطة وصول واحدة متوافقة مع OpenAI، ويتحول تلقائيًا إلى مزوّد آخر عند تجاوز حد الطلبات. تصفح الكتالوج أو ابدأ الآن.

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

هل يمكنني استخدام Cline مجانًا؟

نعم. Cline مجانية ومفتوحة المصدر. اضبط مزود الواجهة على OpenAI Compatible ووجّهه إلى FreeLLMAPI. ترسل البوابة كل طلب إلى الطبقات المجانية للمزودين، لذلك تكلفة الاستدلال $0.

ما أفضل نموذج مجاني لـ Cline؟

استخدم نموذجًا يدعم استدعاء الأدوات ويملك سياقًا بحجم 128K على الأقل. يرسل Cline مطالبات معقدة مع تعريفات أدوات. يعرض الجدول في هذه الصفحة أقوى النماذج المجانية التي تستوفي القاعدتين اليوم.

هل ما زال Roo Code مدعومًا؟

لا. تقول وثائق Roo Code إن الإضافة أُوقفت في 15 مايو 2026، وإن المستودع مؤرشف. ما زالت التثبيتات الموجودة تعمل مع مزود OpenAI Compatible.

كيف أستخدم Kilo Code مع واجهة متوافقة مع OpenAI مخصصة؟

أضف مزود openai-compatible مع baseURL وapiKey في الإعداد العام لـ Kilo، أو شغّل الأمر npx freellmapi setup-kilo. في إضافة VS Code، استخدم Settings، ثم Providers، ثم Custom provider.

لماذا يفشل Cline مع النماذج المجانية؟

تأتي معظم الإخفاقات من نماذج تدعم استدعاء الأدوات بضعف، أو من نافذة سياق صغيرة. اختر نموذجًا يدعم استدعاء الأدوات ويملك سياقًا بحجم 128K، وفعّل Use Compact Prompt للنماذج الأصغر.

أدلة ذات صلة

المصادر

كل الأدلة · تصفح كل النماذج المجانية