Aider + NeuroAPI: OpenAI-совместимый API

Aider — консольный помощник для работы с репозиторием. Он обращается к модели по OpenAI-совместимому протоколу, поэтому для NeuroAPI достаточно задать адрес API и ключ. Начните с кабинета: создайте API-ключ в разделе «Токены», выберите тариф и скопируйте ключ. Затем откройте /price и найдите модель, с которой будете работать, — её точный ID понадобится в аргументе --model.

Отдельно проверьте возможности модели: Aider использует разные режимы правок, а поддержка инструментов и структурированного вывода зависит от модели. В карточке модели видно, какие функции доступны, а размер контекста подсказывает, насколько большой фрагмент репозитория можно передать в одном запросе.

• Ключ NeuroAPI — отдельный под Aider, чтобы расход был виден отдельно.
• Точный ID модели — из /price или GET /v1/models.
• Тариф выбирается при создании ключа.
• Проверьте контекст и поддержку функций в карточке модели.

Официальная документация Aider для OpenAI-совместимых API описывает два шага: установку и настройку переменных окружения. На macOS и Linux это export OPENAI_API_BASE=<endpoint> и export OPENAI_API_KEY=<key>, на Windows — setx с последующим перезапуском оболочки. Для NeuroAPI endpoint равен https://neuroapi.host/v1.

Управлять настройкой можно и аргументами командной строки: в факт-паке проекта указаны флаги --openai-api-base и --openai-api-key. Выбор между env и флагами — вопрос удобства: переменные окружения не попадают в историю команд, но требуют аккуратности при смене окружений; флаги видны в истории, поэтому ключ лучше всё же хранить в переменной.

• export OPENAI_API_BASE=https://neuroapi.host/v1
• export OPENAI_API_KEY=<ключ NeuroAPI>
• Windows: setx и перезапуск терминала.
• Не коммитьте ключ и не передавайте его в общий shell history.

После настройки переменных перейдите в каталог проекта и запустите aider с моделью, указав префикс openai/: например aider --model openai/<MODEL_ID>. Префикс сообщает Aider, что модель обслуживается OpenAI-совместимым провайдером, а не официальным API OpenAI. Именно этот формат описан в документации для compatible-эндпоинтов.

Дальше начинается обычная работа: вы формулируете задачу, Aider читает файлы и предлагает правки. Начните с небольшого изменения в одном файле — так вы проверите связку ключ → модель → применение правок до того, как запускать длинные задачи на большом репозитории.

• cd /path/to/project
• aider --model openai/<MODEL_ID>
• Первый тест — правка в одном файле.
• Длинные задачи — после проверки связки.

Ответ 401 означает, что ключ не принят: проверьте, что в OPENAI_API_KEY указан ключ NeuroAPI, а не другого сервиса, и что он не отозван. Ошибка 404 по модели — опечатка в ID или недоступность модели на выбранном тарифе. Ответ 429 говорит о превышении лимитов: подождите и повторите, а не отправляйте задачу параллельно в нескольких окнах Aider.

Официальная документация Aider отдельно упоминает предупреждения для моделей, которые инструмент не знает: он может неверно оценивать контекст и стоимость. Это не ошибка подключения, но повод сверить поведение на пробной задаче. Если запрос обрывается по контексту, уменьшите число файлов в сессии и начните новый чат.

• 401 — проверьте ключ и переменную окружения.
• 404 — сверьте ID модели и тариф.
• 429 — снизьте параллелизм и повторите позже.
• Контекст — сократите набор файлов и перезапустите сессию.

Aider отправляет в модель контекст репозитория, поэтому расход зависит не только от длины ответа, но и от того, сколько файлов попало в запрос. Начните с небольшого репозитория или отдельного модуля, ограничьте сессию явной задачей и следите за историей использования в кабинете NeuroAPI: баланс предоплаченный, списание идёт по факту.

Тариф выбирается на уровне ключа. Пилот дешевле, но допускает перебои; Оптимальный устойчивее; Смарт делает попытку Пилота и при безопасной ошибке переходит к цепочке Оптимального. Для длинных агентных сессий разумно держать отдельный ключ, чтобы видеть расход Aider отдельно от остальных интеграций.

• Расход растёт с числом файлов в контексте.
• Отдельный ключ под Aider — прозрачный бюджет.
• Тариф определяется на уровне ключа.
• Сверяйте расход в кабинете после первых задач.

Практический ритм работы с Aider: сформулируйте задачу в одном-двух предложениях, попросите внести правку, просмотрите дифф и только затем принимайте изменения. Инструмент показывает, какие файлы он читает и меняет, поэтому контроль остаётся за вами: Aider предлагает, а решение принимает разработчик.

Для повторяемых задач полезно заранее договориться о правилах: какие каталоги можно трогать, где лежат тесты и как оформлять коммиты. Если задача затрагивает несколько модулей, разбейте её на шаги — так проще отследить расход и откатить неудачную правку, не перезапуская всю сессию.

• Одна задача — одна сессия с явной формулировкой.
• Просматривайте дифф до принятия правок.
• Тесты запускайте после каждого шага, а не в конце.
• Большие задачи дробите на несколько сессий.