Aider: как подключить Relay и проверить первую правку кода
Aider помогает менять код из терминала: вы описываете задачу, клиент передаёт контекст модели и применяет правки в репозитории. Для подключения к Relay задайте OPENAI_API_BASE, ключ и модель с префиксом openai/. Первую задачу выполняйте в отдельной ветке с отключёнными автоматическими коммитами. Ниже показаны настройка Aider CLI, пробный запрос и проверка результата до сохранения изменений.
Коротко
Адрес для Aider:
https://relay-llm.ru/v1, без пути/chat/completions.Aider умеет автоматически коммитить; для ручной проверки отключите это явно.
Создайте ключ для клиента и сверяйте расходы в истории запросов Relay.
Как подготовить репозиторий для первой задачи Aider
Начните с чистого рабочего дерева. Команда git status --short покажет незакоммиченные изменения. Сохраните свою текущую работу привычным способом, затем создайте отдельную ветку. Не давайте клиенту первую задачу поверх несохранённых правок: будет сложнее понять, какие строки изменил он.
Выберите маленькую воспроизводимую ошибку. Например, функция должна отклонять пустое имя, но принимает строку из пробелов. Сначала добавьте тест и убедитесь, что он падает по нужной причине. Если тест не запускается из-за окружения, устраните это до генерации кода.
Сформулируйте задачу узко: «Исправь обработку строки из пробелов в этой функции. Не меняй публичное имя и другие файлы. Тест уже добавлен». Укажите только нужные файлы и не добавляйте секреты. Для чисто редакторской пробы можно начать с одного абзаца документации.
Aider AI получает доступ к выбранному вами контексту. Не рассчитывайте, что модель сама распознает все ограничения проекта. Передайте существенные правила явно, а результат всё равно проверьте по diff и тесту.
Как подключить Aider к API Relay
Эта инструкция рассчитана на уже установленный Aider. Установку и доступные флаги сверяйте с руководством вашей версии и страницей интеграции Relay.
Создайте ключ Relay, подтвердив почту, и сохраните его при показе. Выберите модель в каталоге. Пример использует существующий gpt-5.6-sol и OpenAI Chat Completions.
export OPENAI_API_BASE="https://relay-llm.ru/v1"
export OPENAI_API_KEY="sk-demo-not-a-real-key"
aider --model openai/gpt-5.6-sol --no-auto-commits --no-dirty-commitsУчебный ключ не работает. Задайте рабочий OPENAI_API_KEY через окружение или менеджер секретов, без записи в историю команд. Запускайте Aider из каталога нужного репозитория. Переменная должна быть доступна процессу клиента, а не только другой открытой оболочке.
Префикс openai/ выбирает OpenAI-совместимый способ обращения внутри Aider. В поле модели запроса Relay используется идентификатор из каталога. Не переносите этот префикс в обычный пример curl, если каталог не содержит такой идентификатор.
Флаг --no-auto-commits отключает автоматические коммиты правок Aider. --no-dirty-commits отключает автоматическое сохранение уже изменённых файлов перед его правкой. Это не запрет записи файлов. Если нужен только план, сначала используйте режим обсуждения, доступный в вашей версии клиента, и проверьте его правила.
Как выполнить первую правку и принять результат
В интерфейсе Aider добавьте только целевую функцию и тест средствами клиента. Сначала попросите объяснить причину падения. Сравните ответ с реальным входом: строка из пробелов отличается от пустой строки, и проверка должна учитывать именно это.
Затем разрешите исправление. После него остановитесь и прочитайте diff. Проверьте, что клиент не удалил падающий тест, не ослабил утверждение и не переименовал функцию ради прохождения проверки. Посмотрите также список новых файлов, даже если задача касалась одного существующего файла.
Выполните точечный тест в обычном окружении проекта. Если он проходит, проверьте соседние случаи этой функции: корректное имя, пустую строку и пробелы. Запускайте только нужные проверки, затем оформляйте коммит принятым в проекте способом.
Если результат неверен, опишите конкретное расхождение. Фраза «сделай лучше» не объяснит, что исправлять. Не продолжайте новую задачу поверх непринятого diff: сначала верните код к понятному состоянию, сохранив свои изменения.
Почему Aider не подключается или предупреждает о модели
При 401 проверьте окружение процесса и состояние ключа. При 404 проверьте адрес и точный идентификатор. Не добавляйте /chat/completions к OPENAI_API_BASE: клиент формирует маршрут сам. Если короткий запрос вне Aider работает, сравните его настройки с настройками клиента.
Предупреждение Aider о незнакомой модели не обязательно означает отказ API. Клиенту могут быть неизвестны параметры контекста или стоимость этого идентификатора. Проверьте предупреждение по руководству своей версии; фактическую цену Relay смотрите на странице цен и в кабинете.
При 402 различайте баланс и лимит ключа, при 429 учитывайте рекомендации справочника ошибок. Не запускайте повторную генерацию без понимания причины: это новый запрос со своим возможным расходом.
Как проверить расход первой задачи
Отфильтруйте историю запросов Relay по ключу Aider. Сопоставьте время, модель, токены и стоимость. Одна видимая команда клиента может вызвать несколько обращений к модели, поэтому оценивайте всю задачу, включая уточнения и исправления.
Поставьте ключу дневной или общий лимит. Все ключи используют общий баланс аккаунта; отдельный ключ даёт отдельную настройку доступа и расхода. При утечке отзовите его и обновите окружение клиента.
Можно ли использовать Aider без автоматических коммитов?
Да. В показанном запуске они отключены флагами, а изменения файлов проверяются и коммитятся вручную.
Почему Aider CLI предупреждает о незнакомой модели?
Клиент может не знать параметры этого идентификатора. Предупреждение не доказывает отказ API: проверьте ответ, каталог Relay и руководство клиента по незнакомым моделям.
Почему тест проходит, а правка неверная?
Проверьте, не изменил ли клиент сам тест или только один частный случай. Сопоставьте diff с условием задачи и соседними входами.
Нужен ли ключ OpenAI при работе через Relay?
Для адреса Relay используется ключ Relay. Имя переменной OPENAI_API_KEY задаёт способ настройки клиента, а не владельца ключа.