Плагин Cline в VS Code
Полное руководство по настройке автономного программного агента Cline для Visual Studio Code. Агент читает репозиторий, выполняет команды в терминале и создает файлы через защищенный шлюз.
Расширение Cline превращает Visual Studio Code в командный пункт для автономного инженера. В отличие от простых чат-ботов, Cline действует циклами: читает файлы проекта, выполняет команды в терминале и запрашивает одобрение перед внесением правок. Интеграция с Api Router дает разработчикам полный контроль над бюджетом каждой сессии и доступ ко всем флагманским моделям.
1. Подготовка и получение ключа
Перед началом настройки убедитесь, что у вас есть активный аккаунт и действующий ключ авторизации:
- Перейдите в личный кабинет Api Router и пополните рублевый баланс (от 1 ₽).
- В разделе Ключи управления API создайте новый ключ (формат:
sk-or-v1-...). - Скопируйте ключ. Он понадобится для указания в поле
API Keyвашего редактора.
2. Конфигурация в Cline VS Code Extension
Откройте панель настроек редактора по пути: Настройки Cline (значок шестеренки) → API Provider → OpenAI-Compatible. Укажите следующие параметры подключения:
| Параметр настройки | Значение для Api Router | Описание |
|---|---|---|
| Base URL / Endpoint | https://api-router.velar.plus/v1 | Единая точка входа для всех запросов |
| API Key | sk-or-v1-ваш-ключ | Ваш секретный токен из кабинета |
| Provider Type | OpenAI Compatible | Стандартный протокол эмуляции |
3. Рекомендуемые модели для работы с кодом
В Cline VS Code Extension вы можете вручную указать идентификаторы моделей, оптимизированных для архитектурных рассуждений, поиска багов и автодополнения. Ознакомиться с полным списком и ценами за токен можно в разделе Модели нейросетей:
anthropic/claude-sonnetdeepseek/deepseek-chatopenai/gpt-mini
4. Основные сценарии и горячие клавиши
После сохранения настроек шлюз мгновенно начинает маршрутизировать запросы на генерацию кода:
| Комбинация клавиш | Функциональное действие |
|---|---|
| Cmd + Shift + P → Cline: Open | Открыть главную панель управления автономным агентом |
| Auto-approve toggle | Настройка разрешений на автоматическое чтение файлов и запуск команд |
| Context window slider | Ограничение размера истории для оптимизации расхода токенов |
5. Проверка подключения и диагностика
Если редактор сообщает об ошибке соединения, проверьте следующие моменты:
- Проверка баланса: Убедитесь в личном кабинете или через GET /v1/credits, что на балансе есть средства.
- Формат Base URL: Убедитесь, что в конце адреса указан путь
/v1без лишнего слеша в конце:https://api-router.velar.plus/v1. - Резервирование: Для критических задач настройте резервные модели, чтобы избежать прерывания сессии при временной недоступности апстрима.
- Лимиты ключа: Проверьте, не исчерпан ли лимит расходов в настройках ключа (контроль расходов).
Связанные разделы документации
Рекомендуем также изучить смежные технические руководства и спецификации: