Avante.nvim (Neovim)
Руководство по настройке ультра-быстрого плагина Avante.nvim для Neovim. Полноценный интерфейс Cursor IDE в консоли: боковой чат, inline-диффы и умный контекст через единый шлюз в РФ.
Плагин Avante.nvim переносит эргономику и возможности Cursor IDE в любимый терминал пользователей Neovim. Написанный на Lua, он обеспечивает молниеносный отклик интерфейса, боковой сплит для диалога и контекстные подсказки при редактировании буферов через единый эндпоинт Api Router.
1. Подготовка и получение ключа
Перед началом настройки убедитесь, что у вас есть активный аккаунт и действующий ключ авторизации:
- Перейдите в личный кабинет Api Router и пополните рублевый баланс (от 1 ₽).
- В разделе Ключи управления API создайте новый ключ (формат:
sk-or-v1-...). - Скопируйте ключ. Он понадобится для указания в поле
API Keyвашего редактора.
2. Конфигурация в Avante.nvim
Откройте панель настроек редактора по пути: lua/plugins/avante.lua (менеджер lazy.nvim). Укажите следующие параметры подключения:
| Параметр настройки | Значение для Api Router | Описание |
|---|---|---|
| Base URL / Endpoint | https://api-router.velar.plus/v1 | Единая точка входа для всех запросов |
| API Key | sk-or-v1-ваш-ключ | Ваш секретный токен из кабинета |
| Provider Type | OpenAI Compatible | Стандартный протокол эмуляции |
3. Рекомендуемые модели для работы с кодом
В Avante.nvim вы можете вручную указать идентификаторы моделей, оптимизированных для архитектурных рассуждений, поиска багов и автодополнения. Ознакомиться с полным списком и ценами за токен можно в разделе Модели нейросетей:
anthropic/claude-sonnetopenai/gpt-minideepseek/deepseek-chat
4. Основные сценарии и горячие клавиши
После сохранения настроек шлюз мгновенно начинает маршрутизировать запросы на генерацию кода:
| Комбинация клавиш | Функциональное действие |
|---|---|
| Открыть диалоговое окно Avante Chat в боковом сплите | |
| Запустить inline-редактирование выделенного блока кода | |
| Обновить и перезагрузить контекст текущего буфера |
5. Проверка подключения и диагностика
Если редактор сообщает об ошибке соединения, проверьте следующие моменты:
- Проверка баланса: Убедитесь в личном кабинете или через GET /v1/credits, что на балансе есть средства.
- Формат Base URL: Убедитесь, что в конце адреса указан путь
/v1без лишнего слеша в конце:https://api-router.velar.plus/v1. - Резервирование: Для критических задач настройте резервные модели, чтобы избежать прерывания сессии при временной недоступности апстрима.
- Лимиты ключа: Проверьте, не исчерпан ли лимит расходов в настройках ключа (контроль расходов).
Связанные разделы документации
Рекомендуем также изучить смежные технические руководства и спецификации: