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

پیکربندی Aider با QCode.cc: Claude از طریق نقطه پایانی Anthropic (پیشوند anthropic/)، GPT و مدل‌های چینی از طریق نقطه پایانی سازگار با OpenAI

به کلید API نیاز دارید؟ ثبت‌نام ←·نقاط پایانی و Base URL ←

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

فعالیت مخزن: آخرین کامیت در 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 پرداخت می‌کنید
• حالت Architect: یک مدل برنامه‌ریزی می‌کند و مدل دیگری ویرایش — کیفیت خروجی بهتر
• یکپارچگی عمیق با Git: هر ویرایش هوش مصنوعی به یک کامیت در git تبدیل می‌شود
• Repository Map: ایندکس‌سازی کل کدبیس بر پایه 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 را به این آدرس پایه می‌افزاید، بنابراین در /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 — یک جایگزین GUI در VS Code
• نکات CLI — استفاده پیشرفته از Claude Code
• مستندات Aider

سازمانی ←