# یکپارچه‌سازی Aider

> **آخرین بررسی**: 2026-09-18 · 📄 بر پایه مستندات رسمی (مخزن Aider؛ یادداشت وضعیت را در ادامه ببینید)

> **فعالیت مخزن**: آخرین کامیت در 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 پرداخت می‌کنید
- **حالت Architect**: یک مدل برنامه‌ریزی می‌کند و مدل دیگری ویرایش — کیفیت خروجی بهتر
- **یکپارچگی عمیق با Git**: هر ویرایش هوش مصنوعی به یک کامیت در git تبدیل می‌شود
- **Repository Map**: ایندکس‌سازی کل کدبیس بر پایه 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` را به این آدرس پایه می‌افزاید، بنابراین **در `/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 |
| حالت Architect | برنامه‌ریزی + ویرایش با دو مدل | یک مدل |
| ابزارها | ویرایش فایل + shell | غنی‌تر (LSP، جستجو، مرورگر) |
| مدیریت زمینه | ایندکس‌گذاری Repository Map | پنجره 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) — یک جایگزین GUI در VS Code
- [نکات CLI](/docs/usage/cli-tips) — استفاده پیشرفته از Claude Code
- [مستندات Aider](https://aider.chat/)