API ROUTER.
Вход

Консольный агент Aider

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

Терминальный агент Aider CLI оптимизирован для разработчиков, предпочитающих работать в консоли и использовать возможности Git. Aider автоматически рассчитывает карту репозитория (repo map), вносит изменения точечными патчами и создает аккуратные осмысленные коммиты. Подключение шлюза через аргументы командной строки снимает любые проблемы с оплатой в рублях.

1. Подготовка и получение ключа

Перед началом настройки убедитесь, что у вас есть активный аккаунт и действующий ключ авторизации:

  1. Перейдите в личный кабинет Api Router и пополните рублевый баланс (от 1 ₽).
  2. В разделе Ключи управления API создайте новый ключ (формат: sk-or-v1-...).
  3. Скопируйте ключ. Он понадобится для указания в поле API Key вашего редактора.

2. Конфигурация в Aider CLI

Откройте панель настроек редактора по пути: Параметры командной строки или файл ~/.aider.conf.yml. Укажите следующие параметры подключения:

Параметр настройки Значение для Api Router Описание
Base URL / Endpoint https://api-router.velar.plus/v1 Единая точка входа для всех запросов
API Key sk-or-v1-ваш-ключ Ваш секретный токен из кабинета
Provider Type OpenAI Compatible Стандартный протокол эмуляции

3. Рекомендуемые модели для работы с кодом

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

  • anthropic/claude-sonnet
  • openai/gpt-mini
  • deepseek/deepseek-chat

4. Основные сценарии и горячие клавиши

После сохранения настроек шлюз мгновенно начинает маршрутизировать запросы на генерацию кода:

Комбинация клавиш Функциональное действие
/add Добавление файлов проекта в сессионный контекст рассуждения
/architect Переключение в режим архитектора для глубокого планирования перед кодингом
/git diff Быстрый просмотр сформированного патча до создания коммита

5. Проверка подключения и диагностика

Если редактор сообщает об ошибке соединения, проверьте следующие моменты:

  • Проверка баланса: Убедитесь в личном кабинете или через GET /v1/credits, что на балансе есть средства.
  • Формат Base URL: Убедитесь, что в конце адреса указан путь /v1 без лишнего слеша в конце: https://api-router.velar.plus/v1.
  • Резервирование: Для критических задач настройте резервные модели, чтобы избежать прерывания сессии при временной недоступности апстрима.
  • Лимиты ключа: Проверьте, не исчерпан ли лимит расходов в настройках ключа (контроль расходов).

Связанные разделы документации

Рекомендуем также изучить смежные технические руководства и спецификации: