نصب و استفاده از Aider

Aider یک ابزار هم‌نویسی هوش مصنوعی برای ترمینال است. AI-School به استفاده از Aider برای کدنویسی با دانش‌آموزان توصیه می‌کند، زیرا این ابزار به طور صریح کار می‌کند و از نظر عامل‌گرایی به شدت با بسیاری از عوامل کدنویسی دیگر تفاوت دارد.

دانش‌آموز کمک می‌گیرد اما می‌تواند به خوبی ببیند کدام فایل‌ها ویرایش می‌شوند.

اطلاعات بیشتر در وب‌سایت Aider و در مستندات رسمی Aider موجود است:

• وب‌سایت Aider
• مستندات رسمی Aider

نصب

برای Aider، ابتدا به پایتون نیاز دارید. پایتون ۳ را از طریق python.org یا از طریق مدیر بسته‌ای مانند Homebrew نصب کنید.

سپس تأیید کنید که پایتون در دسترس است.

macOS و Linux

python3 --version

در macOS و بسیاری از توزیع‌های Linux فرمان Python 3 به نام python3 است به جای python، بنابراین در راهنما همیشه از python3 استفاده کنید.

Windows

py --version

در Windows معمولاً پایتون با py آغاز می‌شود.

نصب Aider

نصب پیشنهادی بر اساس مستندات نصب Aider از طریق aider-install است.

macOS و Linux

python3 -m pip install aider-install
aider-install

در macOS و Linux همچنین می‌توان Aider را با اسکریپت نصب به شیوه زیر نصب کرد:

curl -LsSf https://aider.chat/install.sh | sh

در Windows از طریق PowerShell می‌توان این کار را انجام داد:

py -m pip install aider-install
aider-install

یا با اسکریپت نصب:

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

نصب Git

Aider در یک پوشه که حاوی مخزن گیت است، بهتری کار می‌کند. بنابراین گیت را نیز نصب کنید و به دانش‌آموزان ترجیحاً کار در یک پوشه پروژه با کنترل نسخه را بدهید.

اتصال به Coderen

Aider می‌تواند با API‌های سازگار با OpenAI کار کند. برای این کار از نقطه پایانی Coderen و کلید API از AI-School استفاده کنید.

macOS و Linux

export OPENAI_API_BASE="https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
export OPENAI_API_KEY="کلید-API-تو-ای-ایس"

Windows

setx OPENAI_API_BASE "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
setx OPENAI_API_KEY "کلید-API-تو-ایس"

سپس ترمینال را ببندید و یک ترمینال جدید باز کنید تا Windows متغیرهای جدید را استفاده کند.

راه‌اندازی Aider

به پوشه پروژه خود بروید:

cd مسیر/به/پروژکت/شما

Aider را با مدل مجاز راه‌اندازی کنید. به دانش‌آموزان مدل gpt-5.4-mini را پیشنهاد می‌کنیم.

aider --model openai/gpt-5.4-mini

برای کاربران پیشرفته‌تر می‌توان مدل قوی‌تری انتخاب کرد:

aider --model openai/gpt-5.4

کار با فایل‌ها

در Aider می‌توانید فایل‌ها را به بافت اضافه کنید:

/add src/main.py

سپس برای دریافت کمک درخواست کنید، برای مثال:

می‌توانید توضیح دهید چرا این تابع کار نمی‌کند؟

یا:

پیغام خطا را برای کاربر واضح‌تر کنید.

دستورات مفید

فرمان	معنی
/add فایل	افزودن یک فایل به چت
/ask	پرسش‌ها بدون تغییر مستقیم کد
/code	درخواست از Aider برای تغییر کد
/diff	مشاهده تغییرات
/undo	بازگردانی آخرین تغییر AI
/exit	خروج از Aider

نکته برای کلاس

از دانش‌آموزان بخواهید از Aider به عنوان کمک برنامه‌نویسی استفاده کنند، نه به عنوان ماشین حل‌کننده خودکار.

وظایف مناسب عبارتند از:

• “توضیح بده معنای این پیغام خطا چیست.”
• “مرحله بعدی که باید بررسی کنم کدام است؟”
• “به من کمک کن این تابع را کوچک‌تر کنم.”
• “بررسی کن آیا راه‌حل من منطق دارد.”

برای مبتدیان مناسب نیست:

• “کلون مسئولیت را برای من انجام بده.”
• “اپلیکیشن کامل را بساز.”
• “همه چیز را به طور خودکار حل کن.”