استفاده از Aider با 1ai؛ برنامه‌نویسی جفتی در ترمینال با Claude، GPT و DeepSeek
Aider یک برنامه‌نویس جفتی متنباز در ترمینال است: فایلهای مخزن git شما را ویرایش میکند و برای هر تغییر یک commit می‌سازد تا هر وقت خواستید برگردید. Aider از طریق کتابخانه‌ی litellm به هر API سازگار با OpenAI وصل میشود؛ پس با وان ای آی (1ai) و یک کلید به مدلهای چند سازنده دسترسی دارید، اعتبار را با پرداخت ریالی میخرید و برای کلید سقف مصرف می‌گذارید. نکته‌ی اصلی این راهنما نام مدل است: Aider پیشوند `openai/` می‌خواهد و شناسه‌ی 1ai هم پیشوند سازنده دارد.
چرا با 1ai
ویرایش فایل با commit
Aider تغییر را مستقیم در فایلها اعمال میکند و برای هر تغییر commit میگیرد؛ با `/undo` آخرین تغییر برمی‌گردد.
بیشتر مدلهای چت کار میکنند
Aider برای ویرایش به فراخوانی ابزار وابسته نیست و تغییرها را در قالب متنی میگیرد؛ مدلهای قوی‌تر نتیجه‌ی دقیق‌تری میدهند.
حالت architect با دو مدل
یک مدل قوی راه‌حل را طراحی میکند و یک مدل ارزانتر ویرایش‌ها را می‌نویسد؛ هر دو از همان کلید 1ai.
پرداخت ریالی
هزینهی هر درخواست به اندازهی توکن‌هایش از اعتبار 1ai کم میشود که با پرداخت ریالی شارژ میشود.
سقف مصرف برای هر کلید
برای کلید Aider سقف ماهانه، مدلهای مجاز و تاریخ انقضا بگذارید و مصرف را در پنل توسعه‌دهنده ببینید.
در چند قدم
- ۱
Aider را نصب کنید
در ترمینال `python -m pip install aider-install` و بعد `aider-install` را اجرا کنید.
- ۲
کلید API بسازید
در پنل 1ai از بخش توسعه‌دهندگان ← کلیدها یک کلید با نام Aider و سقف ماهانه بسازید و کپی کنید.
- ۳
آدرس و کلید را تنظیم کنید
متغیر `OPENAI_API_BASE` را `https://1ai.ir/v1` و `OPENAI_API_KEY` را کلید خودتان بگذارید.
- ۴
در مخزن اجرا کنید
به پوشهی پروژه بروید و `aider --model openai/anthropic/claude-sonnet-5.5` را اجرا کنید.
مدلهای قوی برای Aider
همه‌ی مدل‌هاGPT-6.1 Sol
پرچم‌دار اوپن‌ای‌آی برای کارهای دقیق، تحلیلی و چندمرحله‌ای
Gemini 3.8 Flash
سریع، چندوجهی و با حافظه‌ی متنی بسیار بلند
Claude Haiku 5.5
سریع‌ترین کلود؛ در سهمیه‌ی رایگان روزانه
سبک و ارزان؛ در سهمیه‌ی رایگان روزانه
DeepSeek V4.1 Flash
سریع و بسیار ارزان؛ در سهمیه‌ی رایگان روزانه
نمونه پرامپت‌ها
پرامپت را کپی کنید، در 1ai بگذارید و جزئیات خودتان را جایگزین کنید.
افزودن فایل و تغییر
/add [مسیر فایل، مثلاً src/users.py] [مسیر فایل تست] Add email format validation to [نام تابع] and update the tests to cover invalid emails.
فقط پرسیدن
/ask Explain how authentication works in this repository and which files are involved. Do not edit anything.
دستور /ask فقط پاسخ می‌دهد و فایلی را تغییر نمی‌دهد.
طراحی و اجرا
/architect Split [نام فایل بزرگ] into smaller modules by responsibility. Keep the public functions importable from the old path.
رفع تست شکسته
/run [دستور تست، مثلاً pytest -x] Fix the failing test by changing the application code, not the test itself.
خلاصه‌ی فارسی تغییرها
/ask به فارسی توضیح بده آخرین تغییرهایی که دادی چه چیزی را عوض کرد، چه ریسکی دارد و چه چیزی را باید دستی تست کنم.
Aider چیست و چه پیش‌نیازی دارد؟
Aider در ترمینال کنار مخزن git شما کار میکند. فایل‌هایی را که با /add اضافه می‌کنید ویرایش میکند، یک نقشه‌ی خلاصه از کل مخزن (repo map) برای مدل می‌فرستد و هر تغییر را با یک پیام commit ثبت میکند. دستورهای پرکاربرد: /add، /drop، /ask، /architect، /run، /undo و /tokens.
پیش‌نیازها:
- Python و git روی سیستم
- حساب 1ai با اعتبار و یک کلید
sk-1ai-… - شناسه‌ی مدل از مدلهای گفتگو
توضیح کلی API در صفحه‌ی توسعه‌دهندگان و مقایسهی مدل‌ها در کدنویسی در برنامه‌نویسی با هوش مصنوعی آمده است.
تنظیم Aider برای 1ai؛ متغیر محیطی یا فایل تنظیمات
ساده‌ترین راه، متغیرهای محیطی است:
# macOS / Linux
export OPENAI_API_BASE=https://1ai.ir/v1
export OPENAI_API_KEY=sk-1ai-...
# Windows (بعد از آن ترمینال را دوباره باز کنید)
setx OPENAI_API_BASE https://1ai.ir/v1
setx OPENAI_API_KEY sk-1ai-...
cd /path/to/your/project
aider --model openai/anthropic/claude-sonnet-5.5برای این‌که هر بار نام مدل را ننویسید، فایل .aider.conf.yml را در پوشهی خانه یا ریشهی مخزن بسازید:
model: openai/anthropic/claude-sonnet-5.5
weak-model: openai/deepseek/deepseek-v4.1-flash
openai-api-base: https://1ai.ir/v1کلید را در این فایل ننویسید اگر در مخزن است؛ آن را در .env ریشهی مخزن با OPENAI_API_KEY=sk-1ai-... بگذارید و .env را به .gitignore اضافه کنید. weak-model برای پیام commit و خلاصه‌ی گفتگو به کار می‌رود و بهتر است ارزان باشد.
چرا نام مدل در Aider با openai/ شروع میشود؟
Aider با litellm کار میکند و پیشوند openai/ به litellm می‌گوید درخواست را به آدرس OPENAI_API_BASE بفرستد. باقی نام، همان شناسه‌ی 1ai است:
| مدل | نام در Aider |
|---|---|
| Claude Sonnet 5.5 | openai/anthropic/claude-sonnet-5.5 |
| GPT-6.1 Sol | openai/openai/gpt-6.1-sol |
| DeepSeek V4.1 Flash | openai/deepseek/deepseek-v4.1-flash |
| Qwen 3.8 Max | openai/qwen/qwen3.8-max |
«openai» دو بار در نام GPT اشتباه نیست: اولی پیشوند litellm است و دومی سازنده‌ی مدل.
Aider برای مدلهای ناشناخته قالب ویرایش whole (بازنویسی کل فایل) را به کار می‌برد که توکن بیشتری مصرف میکند. برای مدلهای قوی، فایل .aider.model.settings.yml بسازید:
- name: openai/anthropic/claude-sonnet-5.5
edit_format: diff
use_repo_map: trueحالت architect: aider --architect --model openai/openai/gpt-6.1-sol --editor-model openai/deepseek/deepseek-v4.1-flash
هشدار Unknown context window size and costs را می‌توانید نادیده بگیرید؛ Aider محدودیت را فقط گزارش میکند و هزینهی این مدل‌ها را صفر فرض میکند، پس عدد واقعی را در پنل 1ai ببینید.
خطاهای رایج Aider با 1ai و راه‌حل
- LLM Provider NOT provided: پیشوند
openai/در ابتدای نام مدل جا افتاده است. - 404
model_not_found: پیشوند سازنده جا افتاده؛openai/claude-sonnet-5.5بایدopenai/anthropic/claude-sonnet-5.5باشد. - 401
invalid_api_key: کلید اشتباه یا باطل است، یا متغیر محیطی در این ترمینال تنظیم نشده. - درخواست به api.openai.com رفته:
OPENAI_API_BASEتنظیم نشده یا/v1در انتهایش نیست. - 402: اعتبار یا سقف ماهانه‌ی کلید تمام شده است.
- 429
rate_limit_exceeded: سقف درخواست در دقیقه پر شده؛ Aider کمی صبر میکند و دوباره می‌فرستد. - ویرایش اعمال نمی‌شود (blocks failed to match): مدل قالب diff را درست ننوشته؛ مدل قوی‌تری بگذارید یا
--edit-format wholeرا امتحان کنید.
چطور هزینهی Aider را کم نگه داریم؟
- فقط فایلهای لازم را با
/addاضافه کنید و بقیه را با/dropبیرون بگذارید. - با
/tokensببینید context فعلی چقدر است و با/clearتاریخچه را خالی کنید. weak-modelوeditor-modelرا روی مدلهای ارزان بگذارید.- برای Aider کلید جداگانه با سقف ماهانه و مدلهای مجاز بسازید.
راهنمای کامل در کلیدها و کنترل هزینه آمده است. اگر عامل ترمینالی با فراخوانی ابزار می‌خواهید، راهنمای OpenCode را ببینید.
ابزارهای آماده
توضیح کد و رفع باگ
کد را بفهمید، خطایش را پیدا کنید و تمیزش کنید
ساخت عبارت باقاعده (Regex)
الگوی Regex با توضیح و نمونه‌ی آزمون
ساخت کوئری SQL
درخواست فارسی، کوئری درست و توضیح‌داده‌شده
دستیارهای مرتبط
برنامه‌نویس ارشد
نوشتن، مرور و اشکال‌زدایی کد با توضیح روشن
- «این کد را مرور کن و باگ‌ها و مشکلات امنیتی‌اش را بگو: »
- «یک API ساده برای مدیریت کارها با Node.js و Express بنویس»
سوالات متداول
آیا Aider با 1ai هزینه دارد؟
خود Aider متنباز است. هزینهی مدل به اندازهی توکنهای ورودی و خروجی هر درخواست از اعتبار 1ai کم میشود و اعتبار را با پرداخت ریالی میخرید. repo map و فایلهای اضافهشده در هر درخواست فرستاده میشوند و بیشترین سهم را در مصرف دارند.
Aider به مدل دارای tool calling نیاز دارد؟
نه. Aider تغییرها را در قالب متنی مثل search/replace از مدل میگیرد و خودش در فایل اعمال میکند. با این حال مدلهای قوی در کدنویسی، مثل Claude، GPT و Qwen، این قالب را دقیقتر رعایت میکنند.
میتوانم `--model sonnet` یا کلید Anthropic را با 1ai به کار ببرم؟
خیر. نامهای کوتاه مثل sonnet و کلید Anthropic مستقیم به API اختصاصی Anthropic میروند. با 1ai همیشه از مسیر سازگار با OpenAI و نامی مثل openai/anthropic/claude-sonnet-5.5 استفاده کنید.
چطور جلوی ارسال فایلهای حساس به مدل را بگیرم؟
مسیر فایلها و پوشههایی را که نباید دیده شوند، مثل .env و پوشهی کلیدها، در فایل .aiderignore در ریشهی مخزن بنویسید. Aider این فایلها را در repo map نمیآورد و اضافهشان نمیکند.
Aider را در ویندوز هم میشود با 1ai استفاده کرد؟
بله. متغیرها را با setx تنظیم کنید و ترمینال را دوباره باز کنید تا مقدار تازه خوانده شود. اگر نمیخواهید متغیر سراسری بسازید، همان مقادیر را در .aider.conf.yml و .env پروژه بگذارید.
Aider بهتر است یا Cline و OpenCode؟
Aider ساده و gitمحور است و برای تغییرهای کنترلشده روی فایلهای مشخص عالی است. Cline در VS Code و OpenCode در ترمینال عاملهایی با فراخوانی ابزارند که خودشان فایل پیدا میکنند و دستور اجرا میکنند. هر سه با یک کلید 1ai کار میکنند.
میتوانم وسط کار مدل Aider را عوض کنم؟
بله. در همان جلسه دستور /model openai/qwen/qwen3.8-max را بزنید تا مدل اصلی عوض شود و فایلهای اضافهشده سر جایشان بمانند. این کار برای مقایسهی دو مدل روی یک مسئله یا رفتن سراغ مدل ارزانتر در کارهای ساده مفید است.
Aider را میشود فارسی به کار برد؟
بله. پرسش را فارسی بنویسید تا پاسخ فارسی بگیرید. برای ثابت ماندن زبان، chat-language را در .aider.conf.yml بگذارید؛ برای پیامهای commit هم گزینهی commit-language هست، هرچند بیشتر تیمها commit انگلیسی را ترجیح میدهند.
مطالب مرتبط
استفاده از API سازگار با OpenAI در 1ai: راهنمای عملی با Python، Node.js و cURL
چطور پروژه‌ای را که با کتابخانه‌ی OpenAI نوشته شده، فقط با تغییر آدرس پایه و کلید به 1ai وصل کنید؛ با نمونه کد Python، Node.js و cURL، استریم، فهرست مدل‌ها و مدیریت خطا.
کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه
چطور کلیدهای API را امن نگه دارید و هزینه را مهار کنید: مدلهای مجاز، سقف اعتبار ماهانه، محدودیت نرخ، تاریخ انقضا، کلیدهای تیمی و گزارش مصرف.
مقایسه ChatGPT، Claude و Gemini: کدام مدل برای چه کاری؟
سه خانواده‌ی مطرح مدلهای زبانی، یعنی GPT از OpenAI، Claude از Anthropic و Gemini از گوگل، هر کدام کجا می‌درخشند و چطور برای کار خودتان بهترین را انتخاب کنید.
مدل زبانی بزرگ (LLM) چیست؟ راهنمای کاربردی برای فارسی
LLM موتور بسیاری از دستیارهای هوش مصنوعی است. با مثال‌های ساده، سازوکار آن، تفاوت مدلهای باز و بسته و روش انتخاب مدل مناسب برای متن و کارهای فارسی را بشناسید.
صفحه‌های مرتبط
همه‌ی امکاناتاتصال OpenCode
OpenCode را با یک ارائه‌دهنده‌ی سفارشی در opencode.json به 1ai وصل کنید و در ترمینال با Claude، GPT، Qwen و DeepSeek از یک کلید کدنویسی کنید.
اتصال Cline
افزونه‌ی Cline را با گزینهی OpenAI Compatible به 1ai وصل کنید و با Claude، GPT، Gemini و DeepSeek از یک کلید و با پرداخت ریالی کدنویسی کنید.
اتصال Continue
Continue را با چند خط config.yaml به API سازگار با OpenAI در 1ai وصل کنید و برای چت، ویرایش، Agent و تکمیل خودکار مدل جداگانه بگذارید.
استفاده از Aider با 1ai؛ برنامه‌نویسی جفتی در ترمینال با Claude، GPT و DeepSeek
Aider را با دو متغیر محیطی به 1ai وصل کنید و در ترمینال، روی مخزن git خودتان، با Claude، GPT، DeepSeek و Qwen کد بنویسید و commit بگیرید.
ساخت کلید API