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 отправляет ваши файлы и карту репозитория в каждом запросе. Для основного цикла правок ему не нужен вызов инструментов, потому что он читает правки из текста модели. Важнее большое окно контекста и хорошее следование инструкциям. Таблица показывает бесплатные модели с контекстом не менее 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 | Одна модель планирует изменение, а модель-редактор пишет правки | По желанию. Это удваивает число запросов. |
~/.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: размер контекстного окна и стоимость неизвестны, используются значения по умолчанию.» | 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 |
| «Все модели достигли лимита после N попыток» | Все ключи достигли своего лимита | Добавьте ключи от других провайдеров или уменьшите 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)