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 URL | http://localhost:3001/v1 |
| API key | <unified-key> |
| Model ID | auto، أو معرّف من الكتالوج عبر GET /v1/models |
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 يدويًا، نفّذ هذه الخطوات:
- افتح لوحة Cline في VS Code. اضغط أيقونة الإعدادات (الترس).
- اضبط API Provider على OpenAI Compatible.
- اضبط Base URL على
http://localhost:3001/v1. - اضبط API Key على المفتاح الموحد.
- اضبط Model ID على
auto، أو على نموذج من الجدول أدناه. - افتح 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 على الأقل اليوم، مرتبة حسب الذكاء.
| النموذج | مجاني على | السياق | الحدود المجانية (أفضل عرض) | الأدوات | الرؤية |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 طلب/دقيقة 1 req/min per model | نعم | لا |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 طلب/دقيقة 40 RPM | نعم | نعم |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | نعم | نعم |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | نعم | لا |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | نعم | نعم |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | نعم | نعم |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 طلب/دقيقة 50 طلب/يوم 50 req/day account-wide (1,000 after a $10 purchase) | نعم | نعم |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 طلب/دقيقة 50 طلب/يوم Shared rate limit | نعم | لا |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 طلب/دقيقة 250 طلب/يوم 70,000 رمز/دقيقة ~6M | نعم | نعم |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 طلب/دقيقة 20 طلب/يوم 250,000 رمز/دقيقة ~3M | نعم | نعم |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 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 مرة أخرى، فيضع النموذج الافتراضي أولًا |
الأسئلة الشائعة
هل يمكنني استخدام 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 للنماذج الأصغر.
أدلة ذات صلة
- نماذج ذكاء اصطناعي مجانية في VS Code
- Continue مع واجهة LLM مجانية
- أفضل واجهات نماذج البرمجة المجانية
- واجهة LLM مجانية مع استدعاء الدوال
- كيف تستخدم Claude Code مجاناً
المصادر
- Cline docs: OpenAI Compatible provider (تم التحقق 20 November 2026)
- Cline docs: running models locally (تم التحقق 20 November 2026)
- Kilo docs: custom models (تم التحقق 20 November 2026)
- Kilo docs: OpenAI Compatible provider (تم التحقق 20 November 2026)
- Roo Code repository (archived) (تم التحقق 20 November 2026)
- Roo Code docs: settings management (تم التحقق 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (تم التحقق 20 November 2026)