🚀 ربط Aider بنماذج CodingPlanX المخصصة
> مقدمة: يوضح لك هذا الدليل كيفية استخدام Aider، المبرمج المساعد المفتوح المصدر الشهير للذكاء الاصطناعي، مع واجهة برمجة تطبيقات CodingPlanX.ai للحصول على تجربة برمجة ذكاء اصطناعي من الدرجة الأولى قائمة على الطرفية (Terminal).
Aider هو مساعد برمجة ذكاء اصطناعي رائد لسطر الأوامر (CLI) (أكثر من 39 ألف نجمة على GitHub). يعمل في الطرفية الخاصة بك ويدعم أكثر من 100 لغة برمجة. من خلال تعيين متغيرات بيئة بسيطة، يمكنك ربط Aider بـ CodingPlanX.ai.
✨ لماذا Aider؟
- 🆓 مفتوح المصدر بالكامل: ادفع فقط مقابل استخدام API عبر CodingPlanX.ai.
- 🧠 وضع المهندس المعماري (Architect Mode): نظام ثنائي النماذج حيث يخطط نموذج ويكتب الآخر الكود.
- 🌳 خريطة المستودع (Repo Map): يستخدم
tree-sitterلفهم بنية قاعدة التعليمات البرمجية الخاصة بك بالكامل. - 🔗 تكامل Git: ينشئ تلقائيًا رسائل التزام (commits) وصفية في Git لكل تغيير يجريه الذكاء الاصطناعي.
- ⚡ تكوين بسيط: اتصل في ثوانٍ باستخدام متغيري بيئة فقط.
🛠️ التثبيت
1. المتطلبات الأساسية
- تثبيت Python 3.8+.
- مفتاح API من CodingPlanX.ai (يبدأ بـ
cr_).
2. تثبيت Aider
# موصى به: التثبيت عبر pipx
pipx install aider-chat
# بديل: pip القياسي
pip install aider-chat
⚙️ التكوين
الطريقة 1: متغيرات البيئة (🌟 موصى بها)
مؤقت (جلسة الطرفية الحالية):
export OPENAI_API_BASE="https://api.codingplanx.ai/v1"
export OPENAI_API_KEY="cr_your_api_key"
دائم (إضافة إلى ملف التكوين):
أضف هذه الأسطر إلى ~/.zshrc أو ~/.bashrc:
echo 'export OPENAI_API_BASE="https://api.codingplanx.ai/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="cr_your_api_key"' >> ~/.zshrc
source ~/.zshrc
الطريقة 2: وسطاء سطر الأوامر
aider --openai-api-base "https://api.codingplanx.ai/v1" \
--openai-api-key "cr_your_api_key" \
--model openai/claude-sonnet-4-6
💻 البدء
الاستخدام الأساسي
cd /path/to/your/project
# ابدأ Aider مع Claude Sonnet
aider --model openai/claude-sonnet-4-6
وضع المهندس المعماري (🌟 موصى به بشدة)
يستخدم وضع المهندس المعماري نموذج "مخطط" (مثل Opus) ونموذج "محرر" (مثل Sonnet) لتحسين الجودة مع إدارة التكاليف.
# التركيز على الجودة: يخطط Opus + يحرر Sonnet
aider --architect --model openai/claude-opus-4-6 --editor-model openai/claude-sonnet-4-6
⌨️ أوامر الشرطة المائلة الشائعة
| الأمر | الوصف |
|---|---|
/add file.py | إضافة ملف إلى سياق الذكاء الاصطناعي |
/drop file.py | إزالة ملف من السياق لتوفير الرموز (Tokens) |
/run pytest | تشغيل الاختبارات وتغذية الأخطاء للذكاء الاصطناعي لإصلاحها |
/undo | التراجع عن آخر تغيير في الكود أجراه الذكاء الاصطناعي |
⚖️ Aider مقابل Claude Code CLI
| الميزة | 🤖 Aider | 💻 Claude Code CLI |
|---|---|---|
| مفتوح المصدر | نعم | لا (مملوك) |
| تكامل Git | التزام تلقائي (Auto-commit) | التزام يدوي |
| سير العمل | نماذج متعددة (المهندس المعماري) | نموذج واحد |
| السياق | خريطة المستودع (AST) | نافذة رموز (Tokens) ضخمة |
❓ استكشاف الأخطاء وإصلاحها (الأسئلة الشائعة)
س: خطأ "Model not found" (النموذج غير موجود)؟
ج: تأكد من تضمين البادئة openai/.
- ✅ صحيح:
openai/claude-sonnet-4-6
س: انتهاء مهلة API؟ ج: قم بزيادة حد المهلة:
aider --model openai/claude-sonnet-4-6 --timeout 120