Aider: как подключить свой API (OpenAI-совместимый)

Что такое Aider

Aider — терминальный кодинг-агент с открытым исходным кодом (лицензия Apache 2.0): живёт в консоли, читает ваш проект, правит файлы и сразу сохраняет изменения в виде отдельных коммитов Git. Инструмент бесплатен, а оплачиваются только вызовы к выбранной модели — вы подключаете свой API-ключ (BYOK) и работаете с любой моделью каталога LLMost.

Аider не привязан к конкретной IDE или редактору — он работает поверх терминала и совместим с VS Code, JetBrains, Neovim, Helix и другими. Каждое действие ИИ фиксируется описательным коммитом, так что историю можно просматривать через git log, откатывать через git revert или /undo и рецензировать в pull request.

Требования

Python 3.11+ и pip
Аккаунт LLMost с API-ключом

Установка

pip install aider-chat

Проверьте установку:

aider --version

Подключение LLMost

Создайте ключ на странице Ключи API (формат llmost_...).
Экспортируйте его в переменную окружения (например, в ~/.zshrc):
```
export AIDER_API_KEY="llmost_ВАШ_КЛЮЧ"
```
Запустите Aider, указав базовый URL LLMost и модель в формате openai/vendor/модель:
```
aider --openai-api-base "https://llmost.ru/api/v1" \
  --openai-api-key "$AIDER_API_KEY" \
  --model "openai/~openai/gpt-latest"
```
Важно: модель нужно указывать в формате openai/vendor/модель (например, openai/particle-ai/particle-1-20261027). Если написать только ~openai/gpt-latest или particle-ai/particle-1-20261027, LiteLLM на стороне сервера не распознаёт провайдера и выдаёт ошибку «LLM Provider NOT provided».

Чтобы не вводить флаги каждый раз, создайте файл .aider.conf.yml в корне проекта:
```
model: openai/~openai/gpt-latest
openai-api-base: https://llmost.ru/api/v1
openai-api-key: ${AIDER_API_KEY}
```
Переменная подставляется из окружения, так что ключ не попадает в репозиторий.

Выбор модели

В поле model указывается модель в формате openai/vendor/модель из каталога моделей LLMost. Для агентного режима модель обязана поддерживать tool calling — без этого Aider не сможет править файлы и запускать команды. Хорошие варианты:

openai/~openai/gpt-latest — флагманская линейка OpenAI, подходит для агентного кодинга;
openai/~anthropic/claude-sonnet-latest — альтернатива с контекстом 1 млн токенов;
openai/~deepseek/deepseek-v4-flash-latest — бюджетный вариант для простых задач.

Архитектура Архитектор/Редактор

Aider поддерживает двойную модель: для сложного планирования используется дорогая рассуждающая модель («архитектор»), а для механической генерации правок — дешёвая («редактор»). Это позволяет снизить общую стоимость на 30–50% без существенной потери качества.

Управление контекстом и затратами

Репо-карта — структурное представление кода на основе Tree-sitter и PageRank, по умолчанию до 1024 токена. Лимит настраивается флагом --map-tokens.
Кэширование промптов — флаг --cache-prompts кэширует стабильные части запроса (системное приветствие, репо-карту, read-only файлы), экономя до 70% затрат на длительных сессиях.
Форматы правок — diff (по умолчанию, экономичнейший), whole (весь файл), udiff и diff-fenced для конкретных семейств моделей.
.aiderignore — аналог для .gitignore, исключает из анализа шумные директории (node_modules, dist и т.д.).

Проверка

Запустите Aider в каталоге проекта и дайте простую задачу, например: «Создай файл hello.txt с текстом "Привет"». Агент покажет план, запросит подтверждение, создаст файл и закоммитит изменение. Списания видны в личном кабинете.

Чтобы проверить подключение в обход Aider, выполните запрос напрямую:

curl https://llmost.ru/api/v1/chat/completions \
  -H "Authorization: Bearer llmost_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "~openai/gpt-latest",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Частые проблемы

Ошибка 401. Ключ скопирован не полностью или удалён. Создайте новый на странице Ключи API.

Ошибка 402 «Недостаточно средств». Пополните баланс LLMost в личном кабинете.

Агент не правит файлы. Выбранная модель не поддерживает tool calling — смене её на одну из рекомендованных выше.

Aider не подхватывает ключ. Убедитесь, что переменная AIDER_API_KEY экспортирована в том же терминале, где запускаете aider (echo $AIDER_API_KEY).

Репо-карта слишком большая. Уменьшите --map-tokens или добавьте шумные директории в .aiderignore.

Ссылки

Официальный сайт: aider.chat
GitHub: paul-gauthier/aider
Документация по формам правок: aider.chat/docs/more/edit-formats.html
Документация по кэшированию: aider.chat/docs/usage/caching.html
Другие приложения — в каталоге ИИ-агентов

Aider + LLMost: установка и настройка