نصب Aider و پیکربندی OmniProxy

Aider ابزاری است که به تغییر کد از طریق ترمینال کمک می‌کند. این ابزار نقشه‌ای از کل پایگاه کد ایجاد می‌کند تا به مدل کمک کند پروژه‌های بزرگ‌تر را درک کند. Git یک ابزار کنترل نسخه است که تغییرات کد را ثبت می‌کند و به شما امکان می‌دهد تفاوت‌ها را بررسی کرده و نسخه‌های قبلی را بازیابی کنید. پس از اینکه وظیفه‌ای به Aider محول کردید، آن را گام‌به‌گام پردازش کرده و پیام‌های commit را می‌نویسد. اگر تغییرات را دوست ندارید، می‌توانید با دستور زیر آن‌ها را لغو کنید: /undo.

قبل از شروع

دو روش نصب رایج وجود دارد:

• اگر رایانه شما از قبل دارای Python 3.8 تا 3.13 است، نصب کنید aider-install ابتدا. پایتون محیط اجرایی مورد نیاز برای Aider است.

مک و لینوکس

install.sh

• اجرا با sh پس از curl
• در صورت نیاز پایتون را نصب می‌کند
• اگر curl در دسترس نیست از wget استفاده کنید

ویندوز

install.ps1

• اجرا در PowerShell
• پس از نصب ترمینال را دوباره باز کنید
• تنظیم متغیرهای محیطی با setx

پایتون از قبل نصب شده است

aider-install

• ابتدا این بسته را با pip نصب کنید
• سپس aider-install را اجرا کنید
• محیط مخصوص خود را ایجاد می‌کند

مطمئن شوید که OmniProxy در حال اجرا است. پس از نصب، قبل از شروع Aider، وارد دایرکتوری پروژه‌ای شوید که قصد تغییر آن را دارید.

نصب و اولین اجرا

اگر از قبل پایتون 3.8 تا 3.13 دارید

این دستورات را به ترتیب اجرا کنید:

python -m pip install aider-install
aider-install

aider-install Aider را در یک محیط پایتون جداگانه نصب می‌کند تا با سایر پروژه‌های پایتون در رایانه شما تداخل نداشته باشد. در صورت لزوم، پایتون 3.12 را نیز برای استفاده Aider نصب می‌کند.

نصب تک‌خطی

در مک و لینوکس، اجرا کنید:

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

اگر curl نصب نیست، استفاده کنید:

wget -qO- https://aider.chat/install.sh | sh

در ویندوز PowerShell، اجرا کنید:

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

این دستورات تک‌خطی مبتنی بر uv هستند، برنامه‌ای برای نصب و مدیریت ابزارها و محیط‌های پایتون. همچنین می‌توانید از دستور زیر استفاده کنید:

uv tool install --force --python python3.12 --with pip aider-chat@latest

همچنین می‌توانید از pipx استفاده کنید. هنگام نصب مستقیم با python -m pip install aider-chat، نسخه‌های پایتون پشتیبانی‌شده 3.9 تا 3.12 هستند. با این حال، این یک روش نصب جایگزین است، بنابراین روش‌های توضیح داده شده در بالا را ترجیح دهید. بسته‌های Aider از مدیران بسته سیستم ممکن است دارای عدم تطابق وابستگی باشند، بنابراین نباید اولین انتخاب شما باشند.

در تاریخ 2026-10-09، دستور نصب تک‌خطی Aider v0.86.2 را نصب کرد. در حین نصب، ممکن است پیامی مبنی بر اینکه حافظه پنهان (cache) و مقصد در دیسک‌های متفاوتی هستند و فایل‌ها کپی خواهند شد، مشاهده کنید. نصب همچنان کامل خواهد شد.

پس از نصب، وارد دایرکتوری پروژه شوید. یک API سازگار، رابطی است که با استفاده از فرمت OpenAI با سایر سرویس‌های مدل ارتباط برقرار می‌کند. Aider را با استفاده از این الگو شروع کنید:

aider --model openai/<model-name>

جایگزین کنید <model-name> با شناسه مدل کامل که در بخش بعدی از OmniProxy کپی شده است. شناسه مدل نامی است که برای شناسایی دقیق یک مدل استفاده می‌شود.

دریافت تنظیمات اتصال از OmniProxy

باید دو متغیر محیطی زیر را تنظیم کنید. متغیرهای محیطی را می‌توان مجموعه‌ای از تنظیمات اتصال دانست که توسط برنامه‌های ترمینال خوانده می‌شوند:

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE نقطه پایانی API است و باید شامل /v1. OPENAI_API_KEY کلیدی است که برای دسترسی به API استفاده می‌شود.

در ویندوز، از setx برای ذخیره متغیرها استفاده کنید. پس از آن باید ترمینال را دوباره باز کنید:

setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>

نام کامل مدل را از لیست فعلی OmniProxy کپی کنید، از جمله هرگونه اسلش در شناسه مدل. هنگام شروع Aider، اضافه کنید openai/ قبل از شناسه کامل.

از تاریخ 2026-10-09، دو شناسه مرجع در مستندات ارائه‌دهنده عبارتند از gemini-3.8-flash و grok-4.7. اگر این نام‌ها در لیست فعلی نیستند، آن‌ها را مستقیماً کپی نکنید. از شناسه کاملی استفاده کنید که واقعاً در لیست ظاهر می‌شود.

آدرس

OPENAI_API_BASE

• آن را به OmniProxy اشاره دهید
• شامل /v1
• آن را در مخزن قرار ندهید

کلید

OPENAI_API_KEY

• از کلید ارائه‌شده توسط درگاه استفاده کنید
• پس از تغییر، ترمینال‌های ویندوز را دوباره باز کنید
• کلیدهای ارائه‌دهنده را در درگاه نگه دارید

اجرا

openai/model

• cd به دایرکتوری پروژه
• پیشوند openai/ را به نام مدل اضافه کنید
• از نام موجود در لیست درگاه استفاده کنید

ورود به پیکربندی ابزار

نیازی به ایجاد فایل پیکربندی جداگانه نیست. وارد دایرکتوری پروژه شوید، Aider را شروع کنید و شناسه مدل را با نامی که واقعاً در لیست فعلی OmniProxy وجود دارد جایگزین کنید:

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

برای استفاده از مدل نمونه دیگر، اجرا کنید:

aider --model openai/grok-4.7

هنگامی که Aider با یک مدل ناآشنا مواجه می‌شود، هشداری نمایش می‌دهد. این هشدار به خودی خود به معنای نادرست بودن نقطه پایانی نیست. گزارش‌های درخواست OmniProxy را بررسی کنید تا تأیید کنید که آیا درخواست ظاهر شده است یا خیر.

Aider فقط فایل‌هایی را که قبلاً توسط Git ردیابی شده‌اند به زمینه (context) اضافه می‌کند. زمینه، کد و اطلاعاتی است که مدل می‌تواند در طول وظیفه فعلی بخواند. اگر دایرکتوری فعلی هنوز یک مخزن Git نیست، Aider یکی ایجاد می‌کند، اما فایل‌هایی که Git ردیابی نمی‌کند همچنان قابل خواندن نیستند. استفاده کنید git add برای اضافه کردن فایل‌ها و commit کردن آن‌ها قبل از شروع Aider.

Aider همچنان می‌تواند فایل‌ها را تغییر دهد. --no-auto-commits فقط commitهای خودکار را غیرفعال می‌کند؛ این کار از تغییرات فایل جلوگیری نمی‌کند. هنگام استفاده از Aider برای اولین بار، یک مخزن غیرمهم را انتخاب کنید و اجرا کنید git diff پس از انجام وظیفه برای بررسی تغییرات واقعی.

کلیدهای واقعی را در فایل‌های پروژه یا صفحات عمومی قرار ندهید. کلیدهای ارائه‌دهنده را فقط در OmniProxy ذخیره کنید. اگر درگاه کلیدها را تأیید نمی‌کند، می‌توانید تنظیم کنید OPENAI_API_KEY به یک رشته جای‌نگهدار (placeholder) که فقط در رایانه محلی شما استفاده می‌شود.

تأیید با یک وظیفه واقعی

ابتدا مطمئن شوید فایلی که می‌خواهید Aider بخواند در Git ثبت (commit) شده است. سپس دستور زیر را از دایرکتوری پروژه اجرا کنید. شناسه مدل را با یک شناسه کامل از لیست فعلی OmniProxy جایگزین کنید:

aider --model openai/gemini-3.8-flash --message "What is the first line of this file? Do not modify the file." --no-auto-commits

--message یک وظیفه را مستقیماً به Aider می‌فرستد، در حالی که --no-auto-commits به Aider می‌گوید که در طول این اجرا به‌طور خودکار Git commit ایجاد نکند.

در تاریخ 2026-10-09، Aider v0.86.2 با موفقیت اولین خط یک فایل ردیابی‌شده را خواند. اگر فایل توسط Git ردیابی نشود، Aider می‌گوید که نمی‌تواند محتوا را ببیند. این به معنای نادرست بودن نقطه پایانی API نیست. پس از تکمیل پرس‌وجو، گزارش‌های درخواست OmniProxy را بررسی کنید تا منبع درخواست و شناسه مدل را تأیید کنید.

اجرا

Aider اجرا می‌شود

• دستور در دسترس است
• متغیرهای محیطی فعال هستند
• در دایرکتوری پروژه

وظیفه

فایل را بررسی کرد

• پرسش درباره یک فایل خاص
• بررسی توضیح آن
• مدل‌های ناآشنا ممکن است باعث ایجاد هشدار شوند

گزارش‌ها

قابل مشاهده در درگاه

• منبع Aider است
• شناسه مدل مطابقت دارد
• کلید در صفحه وارد نشده است

خطاهای رایج

• aider پیدا نشد: ابتدا ترمینال را دوباره باز کنید. اگر آن را مستقیماً با pip نصب کرده‌اید، امتحان کنید python -m aider.
• ویندوز پس از تغییر متغیرها همچنان به نقطه پایانی قدیمی متصل می‌شود: پس از اجرای دستور باید ترمینال را دوباره باز کنید setx. فقط یک پنجره جدید متغیرهای به‌روز شده را می‌خواند.
• نام مدل با شروع نمی‌شود openai/: API سازگار به فرمت نیاز دارد openai/<model-name>.
• هشدار مدل ناآشنا ظاهر می‌شود: این یک هشدار عادی است و به معنای عدم موفقیت اتصال نیست. بررسی کنید که آیا OmniProxy درخواست را دریافت کرده است یا خیر.
• شناسه مدل نامعتبر است: شناسه کامل را دوباره از لیست فعلی OmniProxy کپی کنید. نگه دارید openai/ پیشوند و هرگونه اسلش که قبلاً در شناسه وجود دارد.
• Aider می‌گوید محتوای فایلی وجود ندارد: مطمئن شوید که فایل توسط Git ردیابی می‌شود. فایل‌های موجود در یک مخزن خالی یا فایل‌های ردیابی‌نشده به زمینه اضافه نمی‌شوند.

مراجع رسمی

برای مراحل نصب، ببینید نصب Aider. برای متغیرهای محیطی و پیشوند مدل، ببینید APIهای سازگار با OpenAI. شناسه‌های مدل نمونه را می‌توانید در لیست مدل‌های Gemini و صفحه مدل‌های xAI پیدا کنید.

هر جایگاه را با مقادیر از پیکربندی OmniProxy خود جایگزین کنید. هرگز یک کلید واقعی را منتشر نکنید.

یک نتیجه ذخیره شده یا HTTP 200 به تنهایی سازگاری کامل عامل را اثبات نمی‌کند. منبع و مدل را در گزارش درخواست OmniProxy بررسی کنید.

منابع رسمی · Aider ↗