تثبيت Aider واستخدامه

Aider هو أداة زوجية للبرمجة التزامنية في الطرفية. ينصح AI-School باستخدام Aider للبرمجة مع الطلاب، لأن الأداة تعمل بشكل صريح وتقل فيها القوة الوكالية مقارنة بالعديد من وكلاء البرمجة الآخرين.

يتلقى الطالب المساعدة في البرمجة، ولكنه يظل قادرًا على رؤية الملفات التي تتغير.

يمكن العثور على مزيد من المعلومات على موقع Aider وفي توثيق Aider الرسمي.

التثبيت

يحتاج Aider في البداية إلى بايثون. قم بتثبيت Python 3 من خلال python.org أو عبر مدير حزم مثل Homebrew.

ثم تأكد من أن بايثون متاح.

macOS وLinux

python3 --version

في macOS والعديد من توزيعات Linux، يختلف أمر Python 3 بـ python3 عوضًا عن python. لذلك استخدم دائمًا في الدليل python3.

Windows

py --version

عادةً ما يتم تشغيل بايثون على Windows باستخدام 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"

تثبيت Git

يعمل Aider بشكل أكثر راحة في مجلد يحتوي على مستودع Git. لذلك ثبّت git ويفضّل أن يعمل الطلاب في مشروع مجلد مع التحكم في الإصدار.

الاتصال بالبرمجة

يمكن لـ Aider العمل مع واجهات API المتوافقة مع OpenAI. استخدم عنوان Coderen ونقطة النهاية ومفتاح API من AI-School.

macOS وLinux

export OPENAI_API_BASE="https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
export OPENAI_API_KEY="مفتاحك-لـ-API- ais"

Windows

setx OPENAI_API_BASE "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
setx OPENAI_API_KEY "مفتاحك-لـ-API- ais"

ثم أغلق الطرفية وافتح طرفية جديدة لاستخدام المتغيرات الجديدة.

بدء Aider

انتقل إلى مجلد مشروعك:

cd مسار/إلى/مشروعك

ابدأ Aider بنموذج مسموح به. بالنسبة للطلاب ننصح بـ gpt-5.4-mini.

aider --model openai/gpt-5.4-mini

يمكن اختيار نموذج أقوى للمستخدمين المتقدمين:

aider --model openai/gpt-5.4

العمل مع الملفات

في Aider يمكنك إضافة ملفات إلى السياق:

/add src/main.py

ثم اطلب المساعدة، على سبيل المثال:

هل يمكنك شرح لماذا لا تعمل هذه الدالة؟

أو:

اجعل رسالة الخطأ أكثر وضوحًا للمستخدم.

أوامر مفيدة

الأمر	المعنى
/add ملف	أضف ملفًا إلى المحادثة
/ask	اطرح أسئلة دون تعديل الكود مباشرة
/code	اطلب من Aider تعديل الشيفرة
/diff	راقب التغييرات
/undo	أعد التراجع عن آخر تعديل لـ AI
/exit	أغلق Aider

نصيحة للفصل

دع الطلاب يستخدمون Aider كمساعد للبرمجة، لا كمحل تلقائي للمشكلات.

أمثلة مهمّة للإرشاد:

• “اشرح معنى رسالة الخطأ هذه.”
• “ما هي الخطوة التي أراجعها الآن؟”
• “ساعدني في تقليل حجم هذه الدالة.”
• “تحقق من أن حلي منطقي.”

غير مناسبة للمبتدئين:

• “اصنع لي المهمة كاملة.”
• “ابنِ التطبيق بالكامل.”
• “حل كل شيء تلقائيًا.”