К содержимому

Aider API: подключение и настройка моделей

Aider ходит через LiteLLM. Для шлюза проще всего режим OpenAI Chat: адрес с /v1 в OPENAI_API_BASE и имя модели с префиксом openai/.

  • Тип: Агент в терминале
  • Протокол: OpenAI Chat Completions, Anthropic Messages
  • Статус: Работает
  • Версия при сверке: 0.86.2
Настройки сверены с официальной документацией клиента, 2026-10-02. Не проверено вручную: запуск клиента против шлюза не выполнялся.

Что заработает

ВозможностьОтметкаПримечание
ЧатДа
Потоковый ответДа
Вызов инструментовНетAider правит файлы текстовыми блоками, а не вызовом инструментов API.

Настройка

Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.

Клиенту нужен ключ. Задайте его в переменной окружения RELAY_API_KEY: примеры ниже читают ключ оттуда. Чтобы переменная сохранялась между сеансами, добавьте строку export в ~/.zshrc (bash: ~/.bashrc, bash на macOS: ~/.bash_profile), в PowerShell вызовите [Environment]::SetEnvironmentVariable с областью User, в cmd выполните setx и откройте новое окно. Окно, открытое до setx, переменную не увидит.

Ключ в переменной окружения

macOS и Linux

bash
read -rs RELAY_API_KEY && export RELAY_API_KEY

Windows PowerShell

bash
$env:RELAY_API_KEY = "YOUR_API_KEY"

Windows cmd

bash
set "RELAY_API_KEY=YOUR_API_KEY"
  1. Установите Aider по официальной инструкции и задайте ключ в переменной RELAY_API_KEY.
  2. Задайте OPENAI_API_BASE со значением https://relay-llm.ru/v1 и OPENAI_API_KEY со своим ключом.
  3. Запустите aider --model openai/gpt-5.6-luna: префикс openai/ нужен LiteLLM, имя после него это идентификатор из каталога.
  4. Чтобы не повторять переменные, положите их в файл .env: Aider ищет его в домашнем каталоге, корне репозитория и текущем каталоге.

Переменные и запуск

macOS и Linux

bash
export OPENAI_API_BASE="https://relay-llm.ru/v1"
export OPENAI_API_KEY="$RELAY_API_KEY"
aider --model openai/gpt-5.6-luna

Windows PowerShell

bash
$env:OPENAI_API_BASE = "https://relay-llm.ru/v1"
$env:OPENAI_API_KEY = $env:RELAY_API_KEY
aider --model openai/gpt-5.6-luna

Windows cmd

bash
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

text
OPENAI_API_BASE=https://relay-llm.ru/v1
OPENAI_API_KEY=YOUR_API_KEY

Режим Anthropic (не проверен)

macOS и Linux

bash
export ANTHROPIC_API_BASE="https://relay-llm.ru"
export ANTHROPIC_API_KEY="$RELAY_API_KEY"
aider --model anthropic/claude-haiku-5-5

Windows PowerShell

bash
$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

bash
curl https://relay-llm.ru/v1/key \
  -H "Authorization: Bearer $RELAY_API_KEY"

Windows PowerShell

bash
curl.exe https://relay-llm.ru/v1/key `
  -H "Authorization: Bearer $env:RELAY_API_KEY"

Windows cmd

bash
curl https://relay-llm.ru/v1/key ^
  -H "Authorization: Bearer %RELAY_API_KEY%"

Затем проверьте сам клиент.

Запустите aider --message "ping" --model openai/gpt-5.6-luna в каталоге с git-репозиторием. Пришёл ответ, значит адрес и ключ верны.

Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.

Ограничения протоколов

OpenAI Chat Completions

Работают чат-модели каталога по пути /v1/chat/completions. Не поддерживаются /v1/embeddings, /v1/audio/*, /v1/moderations, /v1/batches, Assistants и Realtime: функции клиента, которым они нужны, не заработают.

Anthropic Messages

Работают модели, которые принимают этот протокол. Модели GPT по пути /v1/messages недоступны: шлюз не переводит протоколы друг в друга. Адрес для клиентов Anthropic указывается без /v1.

Ловушки

  • Без префикса openai/ неизвестная модель не будет отправлена на заданный адрес.
  • Aider предупредит о неизвестной модели и неизвестном окне контекста. Это касается метаданных, а не доступа: запросы идут.
  • Режим Anthropic (переменные ANTHROPIC_API_BASE и ANTHROPIC_API_KEY, адрес без /v1) работает через LiteLLM. На страницах самого Aider он не описан, поэтому не проверен: начинайте с режима OpenAI.
  • В Windows после setx переменные видны только в новом окне терминала.

Официальная документация: Aider API: подключение и настройка моделей

Подключение клиентов: общие сведения и все клиенты

Обработка ошибок и повторы

Модели и ключ: список моделей в API

Ключи в кабинете

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key