# دمج Aider

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

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

## نظرة سريعة

| العنصر | التفاصيل |
|---|---|
| النماذج التي يمكنك استخدامها | Claude ✅ (بادئة `anthropic/` على نقطة نهاية Anthropic) · GPT ✅ · النماذج الصينية ✅ (نقطة نهاية متوافقة مع OpenAI) · Gemini ❌ (لا يوجد مسار Gemini موثّق هنا) |
| البروتوكول وBase URL | Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai/v1` |
| متغيرات البيئة ذات الصلة | `ANTHROPIC_API_BASE` و`OPENAI_API_BASE` يشيران إلى نقطتي النهاية على الترتيب |
| مكان الإعداد | أعلام CLI أو `~/.aider.conf.yml` |
| الوثائق الرسمية | [aider.chat](https://aider.chat) |

[Aider](https://github.com/paul-gauthier/aider) مبرمج ثنائي مفتوح المصدر للبرمجة بالذكاء الاصطناعي وشائع (39K+ نجمة على GitHub)، يعمل في الطرفية ويدعم أكثر من 100 لغة. يوجّه النماذج عبر LiteLLM، لذا فهو يتحدث **بروتوكول Anthropic وبروتوكول OpenAI معًا**.

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

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

| النموذج الذي تريده | بادئة نموذج Aider | متغير البيئة | القيمة |
|---|---|---|---|
| Claude | `anthropic/` | `ANTHROPIC_API_BASE` | `https://api.qcode.cc/api` |
| GPT / العائلات الصينية الأربع | `openai/` | `OPENAI_API_BASE` | `https://api.qcode.cc/openai/v1` |

انظر [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths).

## لماذا Aider

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

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

# or pip
pip install aider-chat
```

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

```bash
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](https://aider.chat/).

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

```bash
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)

```bash
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` …) على نقطتي النهاية كلتيهما؛ وتجد المعرّفات في [النماذج الصينية](/docs/usage/cn-models).

## الاستخدام

```bash
cd /path/to/your/project

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

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

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

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

```bash
# 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:

| الأمر | ما الذي يفعله |
|---------|--------------|
| `/add file.py` | إضافة ملف إلى سياق المحادثة |
| `/drop file.py` | إزالة ملف |
| `/run pytest` | تشغيل أمر وإرسال الإخراج إلى الذكاء الاصطناعي |
| `/diff` | عرض جميع التغييرات |
| `/undo` | التراجع عن آخر تعديل أجراه الذكاء الاصطناعي |
| `/commit` | إيداع التغييرات الحالية |
| `/help` | عرض المساعدة |

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

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

| العقدة | Anthropic (Claude) | OpenAI (GPT / الصينية) |
|------|--------------------|------------------------|
| عالمي | `https://api.qcode.cc/api` | `https://api.qcode.cc/openai/v1` |
| آسيا (الأفضل من البر الرئيسي للصين) | `https://asia.qcode.cc/api` | `https://asia.qcode.cc/openai/v1` |
| أمريكا الشمالية / أوروبا | `https://us.qcode.cc/api` | `https://us.qcode.cc/openai/v1` |

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

| النموذج | الاسم في Aider | ملاحظات |
|-------|---------------|-------|
| Claude Sonnet 5 | `anthropic/claude-sonnet-5` | موصى به، أفضل قيمة |
| Claude Opus 5 | `anthropic/claude-opus-5` | الأكثر قدرة |
| Claude Haiku 5.5 | `anthropic/claude-haiku-5-5` | رخيص وسريع |
| GPT 6 Sol | `openai/gpt-6-sol` | نموذج OpenAI الرائد |
| GLM 5.2 | `openai/glm-5.2` | صيني، سعر الوحدة منخفض |

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

## Aider مقابل Claude Code CLI

| البُعد | Aider | Claude Code CLI |
|-----------|-------|-----------------|
| مفتوح المصدر | مفتوح بالكامل | مغلق |
| تكامل Git | إنشاء commit تلقائي عند كل تعديل | يدوي /commit |
| وضع Architect | خطة بنموذجين + تعديل | نموذج واحد |
| الأدوات | تعديل الملفات + سطر الأوامر | أغنى (LSP، بحث، متصفح) |
| التعامل مع السياق | فهرسة خريطة المستودع | نافذة token بحجم 200K–1M |
| الحصة | تشارك خطة QCode.cc الخاصة بك | تشارك خطة QCode.cc الخاصة بك |

**اقتران جيد**: 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 إلى البادئة ليعرف أي مزوّد يستخدم:

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

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

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

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

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

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

- [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths) — جدول البروتوكول × عائلة النماذج
- [تكامل Cline](/docs/ide/cline) — بديل بواجهة رسومية داخل VS Code
- [نصائح CLI](/docs/usage/cli-tips) — استخدام Claude Code المتقدم
- [وثائق Aider](https://aider.chat/)