استفاده از Aider با یک API رایگان LLM
Aider یک برنامهنویس جفتی متنباز برای ترمینال است. فایلهای مخزن git شما را ویرایش میکند و کامیت میسازد. این راهنما Aider را از طریق FreeLLMAPI به مدلهای رایگان وصل میکند. همچنین تنظیماتی از Aider را نشان میدهد که برای مدلهای رایگان مهم هستند: قالب ویرایش، مدل ضعیف و اندازه نقشه مخزن.
کد، نام مدلها و برچسبهای زندهٔ کاتالوگ به زبان انگلیسی نمایش داده میشوند.
مرحله 1: نصب FreeLLMAPI
FreeLLMAPI یک دروازه متنباز است. در Docker روی رایانه شما اجرا میشود. سطوح رایگان 45 ارائهدهنده را پشت یک کلید سازگار با OpenAI گردآوری میکند.
نصب روی macOS یا Linux
curl -fsSL https://freellmapi.co/install.sh | bashhttp://localhost:3001 را باز کنید. حداقل دو کلید رایگان ارائهدهنده را در صفحه Keys اضافه کنید. کلید یکپارچه خود را از همان صفحه کپی کنید.
مرحله 2: اتصال Aider
دستور راهاندازی ~/.aider.conf.yml را مینویسد. ابتدا از فایل موجود نسخه پشتیبان میگیرد.
یک دستور
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key>
aiderفایلی که این دستور مینویسد به این شکل است:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"پیشوند openai/ لازم است. به Aider میگوید نام مدل را به یک API سازگار با OpenAI بفرستد. برای استفاده از متغیرهای محیطی و بدون فایل، این کار را انجام دهید:
فقط متغیرهای محیطی
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoAider به دنبال .aider.conf.yml در پوشه خانگی شما میگردد، سپس در ریشه مخزن git و بعد در پوشه جاری. فایلی که آخر بارگذاری میشود اولویت دارد. بنابراین یک فایل پروژه میتواند مدل را برای یک مخزن تغییر دهد.
مرحله 3: انتخاب مدلها
Aider در هر درخواست فایلهای شما و یک نقشه مخزن میفرستد. برای حلقه اصلی ویرایش به فراخوانی ابزار نیاز ندارد، چون ویرایشها را از متن مدل میخواند. پنجره زمینه بزرگ و پیروی خوب از دستورالعمل مهمتر هستند. جدول مدلهای رایگان با حداقل 128K زمینه را امروز نشان میدهد.
| مدل | رایگان در | متن ورودی | محدودیتهای رایگان (بهترین پیشنهاد) | ابزارها | بینایی |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 درخواست در دقیقه 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | بله | خیر |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 مورد دیگر | 1M | 40 درخواست در دقیقه 40 RPM | بله | بله |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 درخواست در دقیقه 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | بله | بله |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | بله | خیر |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | بله | بله |
| Deepseek V4.1 Flash | APINex | 1M | 5 درخواست در دقیقه 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | خیر | خیر |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | بله | بله |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | بله | بله |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 درخواست در دقیقه 50 درخواست در روز 50 req/day account-wide (1,000 after a $10 purchase) | بله | بله |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 درخواست در دقیقه 50 درخواست در روز Shared rate limit | بله | خیر |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | خیر | خیر |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 مورد دیگر | 262K | 30 درخواست در دقیقه 250 درخواست در روز 70,000 توکن در دقیقه ~6M | بله | بله |
نمایش 12 مدل رایگان مطابق از 184 مدل. مشاهده همه مدلها.
دادههای زنده از کاتالوگ FreeLLMAPI (نسخه 2026.11.19، بررسیشده در 2026-11-19). محدودیتهای رایگان اغلب تغییر میکنند. کاتالوگ هر روز بررسی میشود.
از openai/auto استفاده کنید تا مسیریاب مدل را انتخاب کند. از openai/auto:smart استفاده کنید تا مدلهایی با بالاترین هوش ترجیح داده شوند. برای ثابت کردن یک مدل، از openai/ و یک شناسه کاتالوگ از GET /v1/models استفاده کنید.
میتوانید مدلهای یک جلسه را هم در خط فرمان تنظیم کنید. این مثال از قویترین مدلها برای ویرایش استفاده میکند. از مدلهای سریع برای پیامهای کامیت و خلاصه تاریخچه گفتگو استفاده میکند:
مدلها برای یک جلسه
aider --model openai/auto:smart --weak-model openai/auto:fastبرای یک پروفایل از پیش برنامهریزیشده، در داشبورد FreeLLMAPI یک زنجیره پشتیبان بسازید، برای مثال زنجیرهای به نام coding. سپس از --model openai/auto:coding استفاده کنید. نام پروفایل ناشناخته خطای 400 برمیگرداند، پس درخواست بدون اطلاع به زنجیره دیگری نمیرود.
تنظیمات Aider برای مدلهای رایگان
Aider تنظیمات مدلهای شناختهشده را میداند. نام مدل دروازه مانند auto شناختهشده نیست، پس این مقادیر را خودتان تنظیم کنید.
| تنظیم | کاری که انجام میدهد | مقدار پیشنهادی برای مدلهای رایگان |
|---|---|---|
edit-format | قالبی که مدل برای فرستادن ویرایشها استفاده میکند: whole، diff، diff-fenced یا udiff | diff برای مدلهای قوی. whole برای مدلهای ضعیف، چون سادهتر است اما توکن بیشتری میفرستد. |
weak-model | مدل برای پیامهای کامیت و خلاصه تاریخچه گفتگو | openai/auto:fast، تا کارهای کوچک سهمیه مدل قوی شما را مصرف نکنند |
map-tokens | تعداد توکن برای نقشه مخزن. 0 آن را خاموش میکند. | 1024 یا کمتر روی سطوح رایگان کوچک |
architect | یک مدل تغییر را برنامهریزی میکند و یک مدل ویرایشگر ویرایشها را مینویسد | اختیاری. تعداد درخواستها را دو برابر میکند. |
~/.aider.conf.yml با تنظیمات مدلهای رایگان
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024برای دادن پنجره زمینه یک مدل دروازه به Aider، یک فایل .aider.model.metadata.json اضافه کنید. کلید، نام کامل مدل است. Aider این فایل را در همان جاهایی جستجو میکند که فایل پیکربندی را جستجو میکند.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}محدودیتهای نرخ و جایگزینی
سطوح رایگان محدودیت در دقیقه و در روز دارند. FreeLLMAPI استفاده از هر کلید را میشمارد. وقتی یک ارائهدهنده خطای 429 بفرستد، مسیریاب درخواست را به مدل بعدی در زنجیره شما میفرستد. Aider خطا را نمیبیند و ادامه میدهد.
- کلیدهای چهار ارائهدهنده یا بیشتر اضافه کنید. ارائهدهندگان بیشتر، درخواستهای بیشتری در روز میدهند.
- فقط فایلهایی را که میخواهید تغییر دهید با
/addاضافه کنید. هر فایل در هر درخواست است. - بین کارها از
/clearاستفاده کنید تا تاریخچه گفتگوی کوتاهتری بفرستید. تاریخچه کوتاه توکن در دقیقه را هم کم میکند. - برای حذف فایلهایی که دیگر لازم ندارید، از
/dropاستفاده کنید.
عیبیابی
| مشکل | علت | راهحل |
|---|---|---|
| «Model openai/auto: Unknown context window size and costs, using sane defaults.» | Aider مدل دروازه را نمیشناسد | این هشدار معمولاً بیضرر است. برای حذف آن، .aider.model.metadata.json را اضافه کنید. |
| ویرایش اعمال نشد | مدل از قالب ویرایش پیروی نکرد | از --edit-format whole استفاده کنید، یا یک مدل قویتر |
401 «Invalid API key» | Aider کلید دیگری میفرستد، برای مثال از فایل پیکربندی دیگری | فایلهای پیکربندی در پوشه خانگی، ریشه git و پوشه جاری را بررسی کنید |
| Aider به api.openai.com وصل میشود | پیشوند openai/ استفاده شده، اما نشانی پایه تنظیم نشده است | openai-api-base یا OPENAI_API_BASE را تنظیم کنید |
| «All models rate-limited after N attempts» | همه کلیدها به حد خود رسیدهاند | کلیدهای ارائهدهندگان بیشتری اضافه کنید، یا map-tokens را کم کنید |
پرسشهای متداول
آیا میتوانم Aider را رایگان استفاده کنم؟
بله. Aider متنباز است. آن را با openai-api-base و پیشوند مدل openai/ به FreeLLMAPI وصل کنید. این دروازه از سطوح رایگان ارائهدهنده استفاده میکند، پس هزینه استنتاج صفر دلار است.
چگونه Aider را با یک API سازگار با OpenAI استفاده کنم؟
OPENAI_API_BASE و OPENAI_API_KEY را تنظیم کنید، سپس aider --model openai/
با مدلهای رایگان از کدام قالب ویرایش استفاده کنم؟
برای مدلهای قوی از diff استفاده کنید، چون توکن کمتری میفرستد. اگر ویرایشها اعمال نشدند، از whole استفاده کنید. این قالب برای مدلهای ضعیف سادهتر است، اما هر بار کل فایل را میفرستد.
معنی «Unknown context window size and costs, using sane defaults» چیست؟
Aider نام مدل را نمیشناسد، پس از مقادیر پیشفرض استفاده میکند. این هشدار معمولاً بیضرر است. برای حذف آن، فایل .aider.model.metadata.json را با پنجره زمینه اضافه کنید.
کدام مدل رایگان برای Aider بهترین است؟
از مدلی با پنجره زمینه بزرگ و پیروی خوب از دستورالعمل استفاده کنید. جدول این صفحه قویترین مدلهای رایگان با زمینه 128K یا بیشتر را امروز نشان میدهد.
راهنماهای مرتبط
- استفاده از OpenCode با یک LLM API رایگان
- استفاده از Codex CLI با مدلهای رایگان
- بهترین API مدلهای کدنویسی رایگان
- آدرسهای پایه API سازگار با OpenAI رایگان
- API رایگان LLM با زمینه 1 میلیون توکن
منابع
- Aider docs: OpenAI-compatible APIs (بررسیشده در 20 November 2026)
- Aider docs: YAML config file (بررسیشده در 20 November 2026)
- Aider docs: options reference (بررسیشده در 20 November 2026)
- Aider docs: edit formats (بررسیشده در 20 November 2026)
- Aider docs: model warnings (بررسیشده در 20 November 2026)
- Aider docs: advanced model settings (بررسیشده در 20 November 2026)
- FreeLLMAPI CLI generators (بررسیشده در 20 November 2026)