تثبيت Aider واستخدامه
Aider هي أداة زوجية البرمجة بالذكاء الاصطناعي للأوامر. توصي AI-School باستخدام Aider للبرمجة مع المتعلمين، لأنها أداة صريحة في العمل وتعمل بمسؤولية أقل من العديد من وكلاء الترميز الآخرين.
المتعلِّم يحصل على المساعدة في البرمجة، ولكنه يبقى قادرًا على رؤية الملفات التي تُعدل.
لمزيد من المعلومات، انقر على موقع Aider وفي التوثيق الرسمي لـ Aider.
التثبيت
لـ Aider تحتاج أولاً إلى Python. ثبّت Python 3 عبر python.org أو عبر مدير حزم مثل Homebrew.
تحقق بعدها مما إذا كان Python متاحًا.
macOS وLinux
python3 --version
في macOS والعديد من توزيعات Linux، يُسمّى أمر Python 3 بـ python3 بدلاً من python. استخدم دائمًا python3 في الدليل.
Windows
py --version
في Windows غالبًا ما يتم بدء Python باستخدام py.
تثبيت Aider
التثبيت الموصى به وفقًا لـ توثيق تثبيت Aider هو عبر aider-install.
macOS وLinux
python3 -m pip install aider-install
aider-install
يمكن أيضًا تثبيت Aider على macOS وLinux باستخدام سكريبت تثبيت:
curl -LsSf https://aider.chat/install.sh | sh
في Windows يمكن ذلك عبر PowerShell:
py -m pip install aider-install
aider-install
أو باستخدام سكريبت التثبيت:
powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"
يعمل Aider بشكل أفضل داخل مجلد يحتوي على مستودع git. لذا ثبّت git ودَع المتعلمين يعملون في مجلد مشروع مع إدارة إصدار.
الاتصال بالترميز
يمكن لـ Aider العمل مع واجهات برمجة OpenAI المتوافقة. استخدم لنهايات الترميز ومفتاح API من AI-School.
macOS وLinux
export OPENAI_API_BASE="https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
export OPENAI_API_KEY="ais.مفتاح_API-خاص بك"
Windows
setx OPENAI_API_BASE "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
setx OPENAI_API_KEY "ais.مفتاح_API-خاص بك"
أغلق الطرفية مرة ثم افتح طرفية جديدة، حتى تستخدم Windows المتغيرات الجديدة.
بدء تشغيل Aider
اذهب إلى مجلد مشروعك:
cd مسار/إلى/مشروعك
ابدأ Aider بنموذج مسموح به. للمسـتـعـدبن من الطلاب ننصح بـ gpt-5.6-luna.
aider --model openai/gpt-5.6-luna
للمستخدمين المتقدمين يمكن اختيار نموذج أقوى:
aider --model openai/gpt-5.6-terra
العمل مع الملفات
يمكنك في Aider إضافة ملفات إلى السياق:
/add src/main.py
ثم اطلب المساعدة، مثلاً:
هل يمكنك شرح لماذا لا تعمل هذه الدالة؟
أو:
اجعل رسالة الخطأ أوضح للمستخدم.
أوامر مفيدة
| الأمر | المعنى |
|---|---|
/add ملف | أضف ملفًا إلى المحادثة |
/ask | اطرح أسئلة دون تعديل الكود مباشرة |
/code | اطلب من Aider تعديل الكود |
/diff | راجع التغييرات |
/undo | أعد التغيير الأخير للذكاء الاصطناعي للخلف |
/exit | أغلق Aider |
نصائح للصف
اسمح للمتعلمين باستخدام Aider كمساعد برمجة، لا كآلة حل تلقائي.
أمثلة تعليمية مناسبة مثل:
- “اشرح معنى رسالة الخطأ هذه.”
- “ما هي الخطوة التي يجب أن أدرسها الآن؟”
- “ساعدني في تقليل حجم هذه الدالة.”
- “تحقق من أن حلي منطقي.”
غير مناسبة للمبتدئين:
- “اصنع لي المهمة كاملة.”
- “بِنِ مشروع كامل.”
- “حلِّ كل شيء تلقائيًا.”
