تثبيت Aider وإعداده مع OmniProxy

Aider أداة تساعد على تعديل الشفرة من داخل الطرفية. ينشئ خريطة لمستودع الشفرة بالكامل لمساعدة النموذج على فهم المشاريع الكبيرة، بينما يعمل Git كنظام لإدارة الإصدارات يسجّل تغييرات الشفرة، ويمكن استخدامه لمراجعة الفروقات واستعادة التعديلات. عندما تسند مهمة إلى Aider، يعالجها خطوة بخطوة ويكتب وصفًا لعملية الالتزام. وإذا لم تعجبك التغييرات، يمكنك التراجع عنها باستخدام /undo.

التحضير قبل التثبيت

توجد طريقتان شائعتان للتثبيت:

• إذا كان Python بإصدار من 3.8 إلى 3.13 مثبتًا على جهازك: ثبّت aider-install أولًا. Python هو بيئة التشغيل التي يحتاج إليها Aider.
• إذا لم يتوفر إصدار مناسب من Python: استخدم أمر التثبيت ذي السطر الواحد، وسيُجهّز Python 3.12 أيضًا عند الحاجة.

Mac وLinux

install.sh

• نفّذه باستخدام sh بعد curl
• سيثبّت Python عند الحاجة
• يمكن استخدام wget إذا لم يتوفر curl

Windows

install.ps1

• نفّذه في PowerShell
• أعد فتح الطرفية بعد التثبيت
• استخدم setx لمتغيرات البيئة

Python مثبت بالفعل

aider-install

• ثبّت هذه الحزمة أولًا باستخدام pip
• ثم شغّل aider-install
• سينشئ بيئته الخاصة

تأكد من أن OmniProxy قيد التشغيل. بعد اكتمال التثبيت، انتقل أولًا إلى مجلد المشروع الذي تريد تعديله، ثم شغّل Aider.

التثبيت والتشغيل لأول مرة

إذا كان Python بإصدار من 3.8 إلى 3.13 مثبتًا بالفعل

نفّذ الأمرين بالترتيب:

python -m pip install aider-install
aider-install

يثبّت aider-install برنامج Aider في بيئة Python منفصلة لتجنب اختلاطه بمشاريع Python الأخرى على الجهاز. وعند الحاجة، سيثبّت أيضًا Python 3.12 لاستخدامه مع Aider.

التثبيت بسطر واحد

على Mac وLinux، نفّذ:

curl -LsSf https://aider.chat/install.sh | sh

إذا لم يكن curl مثبتًا على الجهاز، يمكنك استخدام:

wget -qO- https://aider.chat/install.sh | sh

في Windows PowerShell، نفّذ:

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

تعتمد أوامر السطر الواحد هذه على uv، وهو برنامج يُستخدم لتثبيت أدوات وبيئات Python وإدارتها. ويمكنك أيضًا استخدام الأمر التالي:

uv tool install --force --python python3.12 --with pip aider-chat@latest

يمكن كذلك استخدام pipx. عند التثبيت مباشرةً من خلال python -m pip install aider-chat، تكون إصدارات Python المدعومة من 3.9 إلى 3.12، لكن هذه طريقة تثبيت بديلة، لذا أعطِ الأولوية لطرق التثبيت السابقة. قد تعاني إصدارات Aider الموجودة في برامج إدارة حزم النظام من عدم تطابق التبعيات، لذلك لا تجعلها خيار التثبيت الأول.

في 2026-10-09، ثبّت أمر السطر الواحد Aider v0.86.2. إذا ظهرت أثناء التثبيت رسالة تفيد بأن ذاكرة التخزين المؤقت والوجهة ليستا على القرص نفسه وأن الملفات ستُنسخ بدلًا من ذلك، فسيظل التثبيت مكتملًا.

بعد انتهاء التثبيت، انتقل إلى مجلد المشروع. الواجهة المتوافقة هي واجهة تستخدم تنسيق OpenAI للتواصل مع خدمات نماذج أخرى، ويكون أمر التشغيل كما يلي:

aider --model openai/<model-name>

استبدل <model-name> بمعرّف النموذج الكامل المنسوخ من OmniProxy في القسم التالي. معرّف النموذج هو الاسم المستخدم لتحديد النموذج بدقة.

الحصول على معلمات الاتصال من OmniProxy

يجب ضبط متغيرَي البيئة التاليين. يمكن اعتبار متغيرات البيئة مجموعة من إعدادات الاتصال التي تقرؤها برامج الطرفية:

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE هو عنوان الواجهة، ويجب أن ينتهي بـ /v1. أما OPENAI_API_KEY فهو المفتاح المستخدم للوصول إلى الواجهة.

في Windows، استخدم setx لحفظ المتغيرات. يجب إعادة فتح الطرفية بعد التنفيذ:

setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>

انسخ اسم النموذج كاملًا من قائمة OmniProxy الحالية، مع الاحتفاظ بالشرطات المائلة الموجودة في معرّف النموذج. وعند تشغيل Aider، أضف openai/ قبل المعرّف الكامل.

في 2026-10-09، كان معرّفا المقارنة الواردان في وثائق المورّد هما gemini-3.8-flash وgrok-4.7. إذا لم تكن هذه الأسماء موجودة في القائمة الحالية، فلا تنسخها كما هي؛ استخدم المعرّف الكامل الموجود فعليًا في القائمة.

العنوان

OPENAI_API_BASE

• وجّهه إلى OmniProxy
• اجعل المسار ينتهي بـ /v1
• لا تكتبه في المستودع

المفتاح

OPENAI_API_KEY

• استخدم المفتاح الذي زودتك به البوابة
• يجب إعادة الفتح بعد التغيير في Windows
• اترك مفتاح المورّد في البوابة

التشغيل

openai/النموذج

• استخدم cd للانتقال إلى مجلد المشروع
• أضف openai/ إلى اسم النموذج
• اعتمد الاسم الوارد في قائمة البوابة

إدخال إعدادات الأداة

لا حاجة هنا إلى إنشاء ملف إعدادات إضافي. انتقل أولًا إلى مجلد المشروع، ثم شغّل Aider، واستبدل معرّف النموذج باسم موجود فعليًا في قائمة OmniProxy الحالية:

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

لاستخدام نموذج المثال الآخر، نفّذ:

aider --model openai/grok-4.7

عندما يصادف Aider نموذجًا غير مألوف له، ستعرض الواجهة تحذيرًا. لا يعني هذا التحذير وحده أن العنوان غير صحيح؛ يجب التحقق من سجلات الاستدعاء في OmniProxy لمعرفة ما إذا كان الطلب قد وصل.

لا يضع Aider في السياق إلا الملفات التي يتتبعها Git بالفعل. والسياق هو الشفرة والمعلومات التي يستطيع النموذج قراءتها أثناء المهمة الحالية. إذا لم يكن المجلد الحالي مستودع Git، فسينشئ Aider مستودعًا تلقائيًا، لكن الملفات التي لا يتتبعها Git ستظل غير قابلة للقراءة. أضف الملفات أولًا باستخدام git add، ثم أنشئ التزامًا قبل تشغيل Aider.

لا يزال بإمكان Aider تعديل الملفات. يعطّل --no-auto-commits إنشاء الالتزامات تلقائيًا فقط، ولا يمنع تعديل الملفات. عند الاستخدام لأول مرة، يُنصح باختيار مستودع غير مهم، ثم تنفيذ git diff بعد انتهاء المهمة لمراجعة التغييرات الفعلية.

لا تضع المفاتيح الحقيقية في ملفات المشروع أو الصفحات العامة. يجب حفظ مفتاح المورّد داخل OmniProxy فقط. وإذا كانت البوابة لا تتحقق من المفتاح، فيمكن وضع سلسلة أحرف نائبة مخصصة للاستخدام المحلي فقط في OPENAI_API_KEY.

التحقق باستخدام مهمة حقيقية

تأكد أولًا من أن الملف المطلوب قراءته قد أُضيف إلى التزام في Git، ثم نفّذ الأمر التالي داخل مجلد المشروع. يجب استبدال معرّف النموذج بالمعرّف الكامل الموجود في قائمة OmniProxy الحالية:

aider --model openai/gemini-3.8-flash --message "ما هو السطر الأول في هذا الملف؟ لا تعدّل الملف." --no-auto-commits

يُستخدم --message لإرسال مهمة واحدة مباشرةً إلى Aider، بينما يعني --no-auto-commits عدم إنشاء التزامات Git تلقائيًا أثناء هذا التشغيل.

في 2026-10-09، نجح Aider v0.86.2 في قراءة السطر الأول من ملف يتتبعه Git. إذا لم يكن Git يتتبع الملف بعد، فسيجيب Aider بأنه لا يستطيع رؤية المحتوى، وهذا لا يعني أن عنوان الواجهة غير صحيح. بعد اكتمال السؤال، راجع سجلات الاستدعاء في OmniProxy للتحقق من مصدر الطلب ومعرّف النموذج.

التشغيل

يمكن تشغيل aider

• يمكن العثور على الأمر
• أصبحت متغيرات البيئة فعّالة
• أنت داخل مجلد المشروع

المهمة

اطّلع على الملف

• اسأله عن ملف محدد
• راجع شرحه
• ستظهر تحذيرات للنماذج غير المألوفة

السجل

يظهر في البوابة

• المصدر هو Aider
• معرّف النموذج متطابق
• لم يُدخل المفتاح في الصفحة

الأخطاء الشائعة

• تعذّر العثور على aider: أعد فتح الطرفية أولًا. إذا كنت قد ثبّتته مباشرةً باستخدام pip، فيمكنك تجربة python -m aider.
• لا يزال Windows يتصل بالعنوان القديم بعد تغيير المتغيرات: يجب إعادة فتح الطرفية بعد تنفيذ setx، لأن النافذة الجديدة فقط هي التي ستقرأ قيم المتغيرات المحدّثة.
• لا توجد openai/ قبل اسم النموذج: تتطلب الواجهة المتوافقة الصيغة openai/<model-name>.
• ظهور تحذير بشأن نموذج غير مألوف: هذا تنبيه طبيعي ولا يعني فشل الاتصال. تحقق بعد ذلك مما إذا كان OmniProxy قد استلم الطلب.
• معرّف النموذج غير صالح: انسخ المعرّف الكامل مرة أخرى من قائمة OmniProxy الحالية، مع الاحتفاظ بالبادئة openai/ والشرطات المائلة الأصلية الموجودة في المعرّف.
• يشير Aider إلى عدم وجود محتوى للملف: تأكد أولًا من أن Git يتتبع الملف. لا تدخل المستودعات الفارغة أو الملفات غير المتتبعة في السياق.

المراجع الرسمية

راجع خطوات التثبيت في Aider installation. وتوجد متغيرات البيئة وبادئة النموذج في OpenAI compatible APIs. ويمكن الاطلاع على معرّفات النماذج المستخدمة في الأمثلة ضمن قائمة نماذج Gemini وصفحة نماذج xAI.

استبدل كل عنصر نائب بقيم إعداد OmniProxy الخاصة بك. لا تنشر مفتاحاً حقيقياً أبداً.

لا يثبت الحفظ الناجح أو HTTP 200 وحده توافق Agent الكامل. تحقق من المصدر والنموذج في سجل استدعاءات OmniProxy.

المصادر الرسمية · Aider ↗