Aider + Heli: CLI-ассистент для кода с оплатой в рублях

Подготовка

1. Зарегистрируйтесь на getheli.ru (подтверждение почты или вход через Google / Яндекс ID) и создайте ключ на вкладке «Ключи».
2. Установите Aider: python -m pip install aider-install, затем aider-install.
3. Задайте переменные OPENAI_API_BASE и OPENAI_API_KEY или параметры --openai-api-base и --openai-api-key.

Запуск и формат имени модели

Для OpenAI-совместимых endpoint Aider требует префикс openai/ перед именем модели. Слаг Heli уже содержит вендора, поэтому итоговое имя выглядит как openai/anthropic/claude-sonnet-5: первый префикс говорит Aider, какой протокол использовать, остальное уходит в Heli как есть.

export OPENAI_API_BASE="https://getheli.ru/v1"
export OPENAI_API_KEY="sk-heli-ВАШ_КЛЮЧ"

cd ~/projects/my-app
aider --model openai/anthropic/claude-sonnet-5 \
      --weak-model openai/deepseek/deepseek-v4-flash

Чтобы не набирать параметры каждый раз, положите .aider.conf.yml в домашнюю папку или корень репозитория:

# .aider.conf.yml
openai-api-base: https://getheli.ru/v1
openai-api-key: sk-heli-ВАШ_КЛЮЧ   # не коммитьте этот файл с ключом
model: openai/anthropic/claude-sonnet-5
weak-model: openai/deepseek/deepseek-v4-flash
timeout: 300

Какие модели выбрать

Основная модель редактирует код — Claude Sonnet 5 или GPT-5.5. Слабая модель (--weak-model) пишет сообщения коммитов и сжимает историю — тут достаточно DeepSeek V4 Flash, и это заметно экономит баланс. Aider отправляет карту репозитория и добавленные файлы, поэтому держите в чате только нужные файлы, а большие сгенерированные каталоги исключите через .aiderignore.

В режиме --architect основная модель планирует изменения, а модель из --editor-model применяет их к файлам. Например, архитектор — Claude Sonnet 5, редактор — более дешёвая Qwen3 Coder Next (имя тоже с префиксом: openai/qwen/qwen3-coder-next).

Для незнакомых моделей Aider выводит предупреждение о неизвестном окне контекста и цене. Это не ошибка: работу можно продолжить или описать модель в .aider.model.metadata.json.

Частые ошибки

• 401 AuthenticationError — неверный ключ или в окружении осталась старая переменная OPENAI_API_KEY.
• 402 — закончился баланс; пополните его в кабинете.
• Model not found / BadRequest — забыт префикс openai/ или опечатка в слаге; сверьте с GET /v1/models.
• Timeout — увеличьте --timeout и уменьшите контекст командой /drop.

Справка по API — в документации, пополнение — в разделе «Оплата». Как выбирать модель для кода — в гайде «Лучшие модели для кода».