الرئيسية / الأدلة / استخدم Aider مع واجهة LLM مجانية

استخدم 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 رمز سياق على الأقل اليوم.

نماذج مجانية لـ Aider: سياق 128K+ حسب الذكاء
النموذجمجاني علىالسياقالحدود المجانية (أفضل عرض)الأدواتالرؤية
GLM 5.3APINex, UnoRouter1M5 طلب/دقيقة
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
نعملا
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 أخرى1M40 طلب/دقيقة
40 RPM
نعمنعم
Gemini 3.8 FlashAPINex, Google AI Studio1M5 طلب/دقيقة
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
نعمنعم
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceنعملا
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditنعمنعم
Deepseek V4.1 FlashAPINex1M5 طلب/دقيقة
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
لالا
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
نعملا
DeepSeek V4 Flash 0731ElectronHub, Router91M10,000 credits/month (~$1), shared; account-anniversary resetلالا
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3 أخرى262K30 طلب/دقيقة
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 أو udiffdiff للنماذج القوية. و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
استخدم كل واحد من هذه النماذج عبر مفتاح واحد. FreeLLMAPI موجّه مفتوح المصدر تستضيفه بنفسك. يضع كل هذه المستويات المجانية خلف نقطة وصول واحدة متوافقة مع OpenAI، ويتحول تلقائيًا إلى مزوّد آخر عند تجاوز حد الطلبات. تصفح الكتالوج أو ابدأ الآن.

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

هل أستطيع استخدام Aider مجاناً؟

نعم. Aider مفتوح المصدر. وجّهه إلى FreeLLMAPI باستخدام openai-api-base وبادئة النموذج openai/. تستخدم البوابة المستويات المجانية للمزوّدين، لذلك تكلفة الاستدلال $0.

كيف أستخدم Aider مع واجهة API متوافقة مع OpenAI؟

اضبط OPENAI_API_BASE وOPENAI_API_KEY، ثم شغّل aider --model openai/. البادئة openai/ مطلوبة. يمكنك وضع القيم نفسها في .aider.conf.yml.

أي صيغة تعديل أستخدم مع النماذج المجانية؟

استخدم diff للنماذج القوية، لأنه يرسل رموزاً أقل. وإذا فشل تطبيق التعديلات، فاستخدم whole. وهو أبسط للنماذج الضعيفة، لكنه يرسل الملف كاملاً في كل مرة.

ماذا يعني «Unknown context window size and costs, using sane defaults»؟

لا يعرف Aider اسم النموذج، لذلك يستخدم قيماً افتراضية. التحذير غير ضار عادةً. أضف .aider.model.metadata.json مع نافذة السياق لإزالته.

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

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

أدلة ذات صلة

المصادر

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