استخدم Aider مع واجهة LLM مجانية
Aider مساعد برمجة ثنائي مفتوح المصدر يعمل في الطرفية. يعدّل الملفات داخل مستودع git الخاص بك وينشئ commits. يوضح هذا الدليل كيف تربط Aider بنماذج مجانية عبر FreeLLMAPI. ويعرض أيضاً إعدادات Aider المهمة للنماذج المجانية: صيغة التعديل، والنموذج الضعيف، وحجم خريطة المستودع.
تُعرض الشيفرة وأسماء النماذج وتسميات الكتالوج المباشر باللغة الإنجليزية.
الخطوة 1: ثبّت FreeLLMAPI
FreeLLMAPI بوابة مفتوحة المصدر. تعمل على حاسوبك في Docker. وهي تجمع المستويات المجانية لـ 45 مزوّداً خلف مفتاح واحد متوافق مع OpenAI.
التثبيت على macOS أو Linux
curl -fsSL https://freellmapi.co/install.sh | bashافتح http://localhost:3001. أضف مفتاحين مجانيين من مزوّدين على الأقل في صفحة Keys. انسخ المفتاح الموحّد من الصفحة نفسها.
الخطوة 2: اربط Aider
يكتب أمر الإعداد الملف ~/.aider.conf.yml. ويأخذ نسخة احتياطية من الملف الموجود أولاً.
أمر واحد
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key>
aiderيبدو الملف الذي يكتبه الأمر هكذا:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"البادئة openai/ مطلوبة. وهي تخبر Aider بإرسال اسم النموذج إلى واجهة API متوافقة مع OpenAI. لاستخدام متغيرات البيئة دون ملف، افعل هذا:
متغيرات البيئة فقط
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoيبحث Aider عن .aider.conf.yml في مجلدك الشخصي، ثم في جذر مستودع git، ثم في المجلد الحالي. يكون للملف الذي يُحمَّل أخيراً الأولوية. لذلك يستطيع ملف المشروع تغيير النموذج لمستودع واحد.
الخطوة 3: اختر النماذج
يرسل Aider ملفاتك وخريطة المستودع في كل طلب. لا يحتاج إلى استدعاء الأدوات في حلقة التعديل الرئيسية، لأنه يقرأ التعديلات من نص النموذج. والأهم هو نافذة سياق كبيرة واتباع جيد للتعليمات. يعرض الجدول النماذج المجانية التي لها 128K رمز سياق على الأقل اليوم.
| النموذج | مجاني على | السياق | الحدود المجانية (أفضل عرض) | الأدوات | الرؤية |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 طلب/دقيقة 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | نعم | لا |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 أخرى | 1M | 40 طلب/دقيقة 40 RPM | نعم | نعم |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 طلب/دقيقة 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | نعم | نعم |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | نعم | لا |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | نعم | نعم |
| Deepseek V4.1 Flash | APINex | 1M | 5 طلب/دقيقة 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | لا | لا |
| 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 | نعم | لا |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | لا | لا |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 أخرى | 262K | 30 طلب/دقيقة 250 طلب/يوم 70,000 رمز/دقيقة ~6M | نعم | نعم |
يعرض 12 من أصل 184 نموذجًا مجانيًا مطابقًا. عرض كل النماذج.
بيانات مباشرة من كتالوج FreeLLMAPI (الإصدار 2026.11.19، تم التحقق 2026-11-19). تتغير الحدود المجانية كثيرًا. يُفحص الكتالوج كل يوم.
استخدم openai/auto ليختار الموجّه النموذج. واستخدم openai/auto:smart لتفضيل النماذج ذات أعلى ذكاء. ولتثبيت نموذج واحد، استخدم openai/ مع معرّف الكتالوج من GET /v1/models.
يمكنك أيضاً تحديد النماذج لجلسة واحدة من سطر الأوامر. يستخدم هذا المثال أقوى النماذج للتعديلات، ويستخدم نماذج سريعة لرسائل commit وملخصات سجل الدردشة:
النماذج لجلسة واحدة
aider --model openai/auto:smart --weak-model openai/auto:fastلملف شخصي مخطط له، أنشئ سلسلة احتياط في لوحة تحكم FreeLLMAPI، مثلاً سلسلة باسم coding. ثم استخدم --model openai/auto:coding. يعيد اسم الملف الشخصي غير المعروف الخطأ 400، لذلك لا يذهب الطلب إلى سلسلة أخرى دون إشعار.
إعدادات Aider للنماذج المجانية
يعرف Aider إعدادات النماذج المعروفة. أما نموذج البوابة مثل auto فغير معروف، لذلك اضبط هذه القيم بنفسك.
| الإعداد | وظيفته | القيمة الموصى بها للنماذج المجانية |
|---|---|---|
edit-format | الصيغة التي يستخدمها النموذج لإرسال التعديلات: whole أو diff أو diff-fenced أو udiff | diff للنماذج القوية. وwhole للنماذج الضعيفة، لأنه أبسط لكنه يرسل رموزاً أكثر. |
weak-model | النموذج المستخدم لرسائل commit وملخصات سجل الدردشة | openai/auto:fast، حتى لا تستنفد المهام الصغيرة حصة نموذجك القوي |
map-tokens | عدد الرموز لخريطة المستودع. القيمة 0 تعطلها. | 1024 أو أقل على المستويات المجانية الصغيرة |
architect | نموذج يخطط للتغيير، ونموذج محرر يكتب التعديلات | اختياري. يضاعف عدد الطلبات. |
~/.aider.conf.yml مع إعدادات للنماذج المجانية
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024لتزويد Aider بنافذة السياق لنموذج البوابة، أضف ملف .aider.model.metadata.json. يكون المفتاح هو اسم النموذج الكامل. يبحث Aider عن هذا الملف في الأماكن نفسها التي يبحث فيها عن ملف الإعداد.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}حدود الطلبات والتحويل عند الفشل
للمستويات المجانية حدود في الدقيقة وفي اليوم. تحسب FreeLLMAPI استخدام كل مفتاح. وعندما يرسل مزوّد الخطأ 429، يوجّه الموجّه الطلب إلى النموذج التالي في سلسلتك. لا يرى Aider الخطأ ويواصل العمل.
- أضف مفاتيح من أربعة مزوّدين أو أكثر. يمنح المزيد من المزوّدين طلبات أكثر في اليوم.
- أضف فقط الملفات التي تريد تغييرها باستخدام
/add. يظهر كل ملف في كل طلب. - استخدم
/clearبين المهام لإرسال سجل دردشة أقصر. ويخفض السجل القصير أيضاً الرموز في الدقيقة. - استخدم
/dropلإزالة الملفات التي لم تعد تحتاجها.
استكشاف الأخطاء وإصلاحها
| المشكلة | السبب | الحل |
|---|---|---|
| «Model openai/auto: Unknown context window size and costs, using sane defaults.» | Aider لا يعرف نموذج البوابة | هذا التحذير غير ضار عادةً. لإزالته، أضف .aider.model.metadata.json. |
| لم يُطبَّق التعديل | لم يتبع النموذج صيغة التعديل | استخدم --edit-format whole، أو نموذجاً أقوى |
401 "Invalid API key" | يرسل Aider مفتاحاً مختلفاً، مثلاً من ملف إعداد آخر | تحقق من ملفات الإعداد في المجلد الشخصي، وجذر git، والمجلد الحالي |
| يستدعي Aider الخادم api.openai.com | البادئة openai/ مستخدمة، لكن العنوان الأساسي غير مضبوط | اضبط openai-api-base أو OPENAI_API_BASE |
| رسالة الخطأ: "All models rate-limited after N attempts" | بلغت كل المفاتيح حدّها | أضف مفاتيح من مزوّدين آخرين، أو خفّض map-tokens |
الأسئلة الشائعة
هل أستطيع استخدام Aider مجاناً؟
نعم. Aider مفتوح المصدر. وجّهه إلى FreeLLMAPI باستخدام openai-api-base وبادئة النموذج openai/. تستخدم البوابة المستويات المجانية للمزوّدين، لذلك تكلفة الاستدلال $0.
كيف أستخدم Aider مع واجهة API متوافقة مع OpenAI؟
اضبط OPENAI_API_BASE وOPENAI_API_KEY، ثم شغّل aider --model openai/
أي صيغة تعديل أستخدم مع النماذج المجانية؟
استخدم diff للنماذج القوية، لأنه يرسل رموزاً أقل. وإذا فشل تطبيق التعديلات، فاستخدم whole. وهو أبسط للنماذج الضعيفة، لكنه يرسل الملف كاملاً في كل مرة.
ماذا يعني «Unknown context window size and costs, using sane defaults»؟
لا يعرف Aider اسم النموذج، لذلك يستخدم قيماً افتراضية. التحذير غير ضار عادةً. أضف .aider.model.metadata.json مع نافذة السياق لإزالته.
ما أفضل نموذج مجاني لـ Aider؟
استخدم نموذجاً بنافذة سياق كبيرة واتباع جيد للتعليمات. يعرض الجدول في هذه الصفحة أقوى النماذج المجانية ذات 128K رمز سياق أو أكثر اليوم.
أدلة ذات صلة
- استخدام OpenCode مع واجهة LLM مجانية
- استخدام Codex CLI مع نماذج مجانية
- أفضل واجهات نماذج البرمجة المجانية
- عناوين Base URL لواجهات OpenAI المجانية المتوافقة
- واجهة LLM مجانية بسياق مليون رمز
المصادر
- Aider docs: OpenAI-compatible APIs (تم التحقق 20 November 2026)
- Aider docs: YAML config file (تم التحقق 20 November 2026)
- Aider docs: options reference (تم التحقق 20 November 2026)
- Aider docs: edit formats (تم التحقق 20 November 2026)
- Aider docs: model warnings (تم التحقق 20 November 2026)
- Aider docs: advanced model settings (تم التحقق 20 November 2026)
- FreeLLMAPI CLI generators (تم التحقق 20 November 2026)