Aider з безкоштовним LLM API
Aider це парний програміст з відкритим кодом для термінала. Він редагує файли у вашому репозиторії git і створює коміти. Цей посібник підключає Aider до безкоштовних моделей через FreeLLMAPI. Він також показує параметри Aider, які важливі для безкоштовних моделей: формат правок, слабка модель і розмір карти репозиторію.
Код, назви моделей і мітки живого каталогу показано англійською.
Крок 1: встановіть FreeLLMAPI
FreeLLMAPI це шлюз з відкритим кодом. Він працює на вашому комп'ютері в Docker. Він об'єднує безкоштовні рівні 45 провайдерів за одним ключем, сумісним з OpenAI.
Встановлення на macOS або Linux
curl -fsSL https://freellmapi.co/install.sh | bashВідкрийте http://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 надсилає ваші файли і карту репозиторію в кожному запиті. Для основного циклу правок йому не потрібен tool calling, бо він читає правки з тексту моделі. Важливіші великі вікна контексту і добре виконання інструкцій. Таблиця показує безкоштовні моделі з контекстом щонайменше 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/ і ID з каталогу з 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 | Одна модель planує зміну, а модель-редактор пише правки | Необов'язково. Це подвоює кількість запитів. |
~/.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 має відкритий код. Вкажіть на FreeLLMAPI через openai-api-base і префікс моделі openai/. Шлюз використовує безкоштовні рівні провайдерів, тож вартість інференсу становить $0.
Як використовувати 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 моделей для коду
- Базові URL безкоштовних API, сумісних з OpenAI
- Безкоштовний LLM API з контекстом 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)