Cline (VS Code / Cursor)
Подключение AI-ассистента Cline к Hubris — кодит, читает и пишет файлы, запускает терминал из вашего редактора.
Cline — расширение для VS Code и Cursor, которое превращает редактор в полноценного AI-агента: умеет читать и редактировать файлы, запускать команды в терминале, работать с git, выполнять многошаговые задачи. Подключается к любому OpenAI-совместимому провайдеру — в том числе к Hubris.
Требования
- VS Code 1.85+ или Cursor
- Установленный аккаунт на hubris.pw и API-ключ
Установка Cline
- Откройте панель расширений в VS Code (
Ctrl+Shift+X). - Найдите Cline (издатель — saoudrizwan).
- Нажмите Install.
- После установки в боковой панели появится иконка Cline.
Подключение к Hubris
В панели Cline нажмите на селектор модели под полем ввода. Откроется список API-провайдеров.
- Выберите OpenAI Compatible.
- Заполните поля:
| Поле | Значение |
|---|---|
| Base URL | https://api.hubris.pw/v1 |
| API Key | ваш ключ из личного кабинета |
| Model ID | например anthropic/claude-haiku-4.5 |
- Сохраните настройки. Cline готов к работе — можно сразу писать задачу.
Рекомендуемые модели
Cline — это многошаговый агент: длинный контекст, много вызовов инструментов, чтение/запись файлов. Под такой профиль подходят:
| Назначение | Модель |
|---|---|
| Сложные многошаговые задачи, рефакторинги | Claude Opus (anthropic/claude-opus-* из каталога) |
| Основная рабочая лошадка для кодинга | Claude Sonnet (anthropic/claude-sonnet-*) |
| Быстрые правки, экономичный режим | anthropic/claude-haiku-4.5 |
| Универсальная альтернатива | openai/gpt-4o-mini |
Полный актуальный список — в каталоге моделей. Подойдёт любая модель с поддержкой tool calling (фильтр в каталоге).
Стоимость и контроль расходов
Cline — агент, а значит делает много вызовов на одну задачу: чтение файлов, изменения, проверка результата. Расход токенов на одну сессию может оказаться выше, чем ожидаешь.
Что советуем:
- Дневной лимит на ключ — задайте лимит расхода в настройках ключа. При превышении ответы вернутся с
429 daily_limit_exceeded, баланс не пострадает. - Раздельные ключи — отдельный ключ для каждого проекта или клиента, чтобы видеть расходы в «Расходах» разнесённо.
- Дешёвая модель для рутины — Haiku или GPT-4o-mini для типовых правок, переключаться на Opus только когда задача реально сложная.
Решение проблем
Cline не подключается, ошибка 401
- Проверьте, что в поле API Key именно ключ Hubris (формат
sk-gw-+ hex). - Если копировали из браузера — убедитесь, что не попали пробелы по краям.
- В случае сомнений — создайте новый ключ в личном кабинете.
model not found при попытке генерации
- Проверьте написание Model ID. Формат —
provider/model-name, напримерanthropic/claude-haiku-4.5. - Убедитесь, что модель есть в нашем каталоге — Hubris проксирует не все модели всех провайдеров.
Cline работает, но «теряет» инструменты или зацикливается
- Это типичная история со слабыми моделями на сложных tool-сценариях. Попробуйте более сильную модель — Claude Sonnet или Opus.
- Уменьшите размер задачи: дайте Cline более узкую цель за раз.
Сильно вырос баланс — почему?
- Каждое действие Cline (открыть файл, прочитать, изменить, проверить) — отдельный запрос с собственным
prompt_tokensиcompletion_tokens. Длинные файлы → большой prompt. - Откройте «Расходы» и отсортируйте по дате — будут видны все запросы за сессию.
Что дальше
- Каталог моделей — выбрать подходящую модель.
- Управление API-ключами — создать отдельный ключ и задать дневной лимит.
- Расходы — детализация всех запросов и потраченных рублей.
- Вызов инструментов — как работают tool calls под капотом.
Обновлено: