دمج Aider

إعداد Aider مع QCode.cc: Claude عبر نقطة نهاية Anthropic (بادئة anthropic/)، وGPT والنماذج الصينية عبر نقطة النهاية المتوافقة مع OpenAI

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

آخر تحقق: 2026-09-18 · 📄 وفق الوثائق الرسمية (مستودع Aider؛ انظر ملاحظة الحالة أدناه)

نشاط المستودع: آخر commit في Aider-AI/aider بتاريخ 2026-05-22 دون أي إصدارات منذ ذلك الحين (تم التحقق عبر GitHub API في 2026-09-18). كل ما في هذه الصفحة لا يزال يعمل؛ ولمن يبحث عن بديل يُصان بنشاط انظر Cline أو Kilo Code.

نظرة سريعة¶

Aider مبرمج ثنائي مفتوح المصدر للبرمجة بالذكاء الاصطناعي وشائع (39K+ نجمة على GitHub)، يعمل في الطرفية ويدعم أكثر من 100 لغة. يوجّه النماذج عبر LiteLLM، لذا فهو يتحدث بروتوكول Anthropic وبروتوكول OpenAI معًا.

🔴 اقرأ هذا أولًا: Claude يتطلب نقطة نهاية Anthropic¶

نقطة النهاية المتوافقة مع OpenAI في QCode لا تقبل نماذج Claude. توجيه OPENAI_API_BASE إلى QCode ثم استخدام اسم نموذج openai/claude-… يعيد model_not_available_on_endpoint.

انظر نقاط النهاية ومسارات API.

لماذا Aider¶

• مفتوح المصدر بالكامل: لا تدفع إلا مقابل استخدام API
• وضع المهندس المعماري: نموذج يخطط وآخر يحرر — جودة إخراج أفضل
• تكامل عميق مع Git: كل تعديل يجريه الذكاء الاصطناعي يصبح commit في git
• خريطة المستودع: فهرسة لكامل قاعدة الشيفرة اعتمادًا على tree-sitter
• البروتوكولان معًا: Claude عبر Anthropic، وGPT / النماذج الصينية عبر OpenAI

التثبيت¶

# pipx recommended (isolated install)
pipx install aider-chat

# or pip
pip install aider-chat

إعداد Claude (نقطة نهاية Anthropic)¶

export ANTHROPIC_API_BASE="https://api.qcode.cc/api"
export ANTHROPIC_API_KEY="cr_your_qcode_key"

aider --model anthropic/claude-sonnet-5

يضيف LiteLLM المسار /v1/messages إلى عنوان Base URL هذا تلقائيًا، لذا توقّف عند /api دون شرطة مائلة لاحقة.

يتغيّر اسم المتغيّر حسب الإصدار: استخدم LiteLLM تاريخيًا كلاً من ANTHROPIC_API_BASE وANTHROPIC_BASE_URL. إذا لم يكن لأحدهما تأثير، فجرّب الآخر، أو مرّر --anthropic-api-key على سطر الأوامر. راجِع وثائق Aider.

اجعله دائمًا (أضِفه إلى ~/.zshrc أو ~/.bashrc):

echo 'export ANTHROPIC_API_BASE="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="cr_your_qcode_key"' >> ~/.zshrc
source ~/.zshrc

إعداد GPT والنماذج الصينية (نقطة نهاية متوافقة مع OpenAI)¶

export OPENAI_API_BASE="https://api.qcode.cc/openai/v1"
export OPENAI_API_KEY="cr_your_qcode_key"

aider --model openai/gpt-6-sol

تعمل العائلات الأربع للنماذج الصينية (glm-5.2 / kimi-k3 / deepseek-v4-pro / qwen3.8-max …) على نقطتي النهاية كلتيهما؛ وتجد المعرّفات في النماذج الصينية.

الاستخدام¶

cd /path/to/your/project

# Everyday driver
aider --model anthropic/claude-sonnet-5

# Flagship
aider --model anthropic/claude-opus-5

وضع Architect (موصى به)¶

نموذج واحد يخطّط، وآخر يطبّق التعديلات:

# Opus plans + Sonnet edits (recommended)
aider --architect --model anthropic/claude-opus-5 --editor-model anthropic/claude-sonnet-5

# Sonnet plans + Haiku edits (cheaper)
aider --architect --model anthropic/claude-sonnet-5 --editor-model anthropic/claude-haiku-5-5

يجب أن يكون كلا النموذجين على نقطة النهاية نفسها للبروتوكول. خلطهما (مثل anthropic/ كمخطِّط مع openai/claude-… كمحرّر) يفشل على جانب المحرّر.

الأوامر الشائعة¶

داخل جلسة Aider:

نقاط النهاية البديلة¶

نطاقات الوصول الثلاثة متطابقة وظيفيًا ولا تختلف إلا في توجيه الشبكة. يعمل المفتاح الواحد على جميعها:

النماذج المتاحة¶

لا تزال نماذج 4.x مثل claude-sonnet-4-6 وclaude-opus-4-8 تُباع (بالسابقة نفسها anthropic/). القائمة الحية على qcode.cc/models.

Aider مقابل Claude Code CLI¶

اقتران جيد: Aider للتعديلات السريعة والتخطيط في وضع Architect، وClaude Code CLI للتحليل العميق للمشروع والأتمتة.

استكشاف الأخطاء وإصلاحها¶

model_not_available_on_endpoint¶

أرسلت نموذج Claude إلى نقطة نهاية OpenAI. تحقّق من أمرين: يجب أن تكون بادئة النموذج anthropic/ وليس openai/؛ ويجب أن تكون القاعدة ANTHROPIC_API_BASE=https://api.qcode.cc/api.

"Model not found"¶

يحتاج Aider إلى البادئة ليعرف أي مزوّد يستخدم:

# correct
aider --model anthropic/claude-sonnet-5

# wrong (missing prefix)
aider --model claude-sonnet-5

انتهاء مهلة الطلبات¶

جرّب عقدة أخرى، أو ارفع قيمة المهلة:

aider --model anthropic/claude-sonnet-5 --timeout 120

الخطوات التالية¶

• نقاط النهاية ومسارات API — جدول البروتوكول × عائلة النماذج
• تكامل Cline — بديل بواجهة رسومية داخل VS Code
• نصائح CLI — استخدام Claude Code المتقدم
• وثائق Aider

المؤسسات ←