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

Aider هي أداة تساعدك في تعديل الكود من خلال الطرفية. تقوم الأداة ببناء خريطة لقاعدة الكود بالكامل لمساعدة النموذج على فهم المشاريع الكبيرة. Git هي أداة للتحكم في الإصدارات تسجل تغييرات الكود، مما يتيح لك فحص الاختلافات واستعادة الإصدارات السابقة. بعد إعطاء Aider مهمة ما، تقوم الأداة بمعالجتها خطوة بخطوة وكتابة رسائل الالتزام (commit messages). إذا لم تعجبك التغييرات، يمكنك التراجع عنها باستخدام /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. أثناء التثبيت، قد ترى رسالة تفيد بأن ذاكرة التخزين المؤقت والوجهة موجودتان على أقراص مختلفة وأنه سيتم نسخ الملفات. سيكتمل التثبيت رغم ذلك.

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

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 هو نقطة نهاية API ويجب أن يتضمن /v1. OPENAI_API_KEY هو المفتاح المستخدم للوصول إلى API.

على 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/model

• انتقل إلى مجلد المشروع باستخدام 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 يعطل فقط الالتزامات التلقائية؛ ولا يمنع تعديلات الملفات. عند استخدام Aider لأول مرة، اختر مستودعاً غير مهم وقم بتشغيل git diff بعد المهمة لمراجعة التغييرات الفعلية.

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

التحقق بمهمة حقيقية

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

aider --model openai/gemini-3.8-flash --message "What is the first line of this file? Do not modify the file." --no-auto-commits

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

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

التشغيل

بدء تشغيل aider

• الأمر متاح
• متغيرات البيئة نشطة
• في مجلد المشروع

المهمة

فحص الملف

• اسأل عن ملف محدد
• راجع شرحه
• قد تؤدي النماذج غير المألوفة إلى إطلاق تحذير

السجلات

مرئية في البوابة

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

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

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

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

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

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

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

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