Aider API: подключение и настройка моделей
Aider ходит через LiteLLM. Для шлюза проще всего режим OpenAI Chat: адрес с / в OPENAI_API_BASE и имя модели с префиксом openai/.
- Тип: Агент в терминале
- Протокол: OpenAI Chat Completions, Anthropic Messages
- Статус: Работает
- Версия при сверке: 0.86.2
Что заработает
| Возможность | Отметка | Примечание |
|---|---|---|
| Чат | Да | |
| Потоковый ответ | Да | |
| Вызов инструментов | Нет | Aider правит файлы текстовыми блоками, а не вызовом инструментов API. |
Настройка
Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.
Клиенту нужен ключ. Задайте его в переменной окружения RELAY_API_KEY: примеры ниже читают ключ оттуда. Чтобы переменная сохранялась между сеансами, добавьте строку export в ~/ (bash: ~/, bash на macOS: ~/), в PowerShell вызовите [Environment]::SetEnvironmentVariable с областью User, в cmd выполните setx и откройте новое окно. Окно, открытое до setx, переменную не увидит.
Ключ в переменной окружения
macOS и Linux
read -rs RELAY_API_KEY && export RELAY_API_KEYWindows PowerShell
$env:RELAY_API_KEY = "YOUR_API_KEY"Windows cmd
set "RELAY_API_KEY=YOUR_API_KEY"- Установите Aider по официальной инструкции и задайте ключ в переменной
RELAY_API_KEY. - Задайте
OPENAI_API_BASEсо значениемhttps://иrelay-llm.ru/ v1 OPENAI_API_KEYсо своим ключом. - Запустите
aider --model openai/: префиксgpt-5.6-luna openai/нужен LiteLLM, имя после него это идентификатор из каталога. - Чтобы не повторять переменные, положите их в файл
.env: Aider ищет его в домашнем каталоге, корне репозитория и текущем каталоге.
Переменные и запуск
macOS и Linux
export OPENAI_API_BASE="https://relay-llm.ru/v1"
export OPENAI_API_KEY="$RELAY_API_KEY"
aider --model openai/gpt-5.6-lunaWindows PowerShell
$env:OPENAI_API_BASE = "https://relay-llm.ru/v1"
$env:OPENAI_API_KEY = $env:RELAY_API_KEY
aider --model openai/gpt-5.6-lunaWindows cmd
set "OPENAI_API_BASE=https://relay-llm.ru/v1"
set "OPENAI_API_KEY=%RELAY_API_KEY%"
aider --model openai/gpt-5.6-lunaФайл .env
~/.env
%USERPROFILE%\.env
OPENAI_API_BASE=https://relay-llm.ru/v1
OPENAI_API_KEY=YOUR_API_KEYРежим Anthropic (не проверен)
macOS и Linux
export ANTHROPIC_API_BASE="https://relay-llm.ru"
export ANTHROPIC_API_KEY="$RELAY_API_KEY"
aider --model anthropic/claude-haiku-5-5Windows PowerShell
$env:ANTHROPIC_API_BASE = "https://relay-llm.ru"
$env:ANTHROPIC_API_KEY = $env:RELAY_API_KEY
aider --model anthropic/claude-haiku-5-5Проверка
Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.
macOS и Linux
curl https://relay-llm.ru/v1/key \
-H "Authorization: Bearer $RELAY_API_KEY"Windows PowerShell
curl.exe https://relay-llm.ru/v1/key `
-H "Authorization: Bearer $env:RELAY_API_KEY"Windows cmd
curl https://relay-llm.ru/v1/key ^
-H "Authorization: Bearer %RELAY_API_KEY%"Затем проверьте сам клиент.
Запустите aider --message "ping" --model openai/ в каталоге с git-репозиторием. Пришёл ответ, значит адрес и ключ верны.
Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.
Ограничения протоколов
OpenAI Chat Completions
Работают чат-модели каталога по пути /. Не поддерживаются /, /, /, /, Assistants и Realtime: функции клиента, которым они нужны, не заработают.
Anthropic Messages
Работают модели, которые принимают этот протокол. Модели GPT по пути / недоступны: шлюз не переводит протоколы друг в друга. Адрес для клиентов Anthropic указывается без /.
Ловушки
- Без префикса
openai/неизвестная модель не будет отправлена на заданный адрес. - Aider предупредит о неизвестной модели и неизвестном окне контекста. Это касается метаданных, а не доступа: запросы идут.
- Режим Anthropic (переменные
ANTHROPIC_API_BASEиANTHROPIC_API_KEY, адрес без/) работает через LiteLLM. На страницах самого Aider он не описан, поэтому не проверен: начинайте с режима OpenAI.v1 - В Windows после
setxпеременные видны только в новом окне терминала.
Ссылки
Официальная документация: Aider API: подключение и настройка моделей
Подключение клиентов: общие сведения и все клиенты