Cline (VS Code / Cursor)
Подключение AI-ассистента Cline к Hubris — кодит, читает и пишет файлы, запускает терминал из вашего редактора.
Cline — расширение для VS Code и Cursor, которое превращает редактор в полноценного AI-агента: умеет читать и редактировать файлы, запускать команды в терминале, работать с git, выполнять многошаговые задачи. Подключается к любому OpenAI-совместимому провайдеру — в том числе к Hubris.
Требования
- VS Code 1.101+ или Cursor
- Аккаунт на hubris.pw и API-ключ
Установка Cline
- Откройте панель расширений в VS Code (
Ctrl+Shift+X). - Найдите Cline (издатель — saoudrizwan).
- Нажмите Install.
- После установки в боковой панели появится иконка Cline.
Подключение к Hubris
При первом открытии Cline показывает экран How will you use Cline? — выберите Bring my own API key и нажмите Continue. Откроется форма Configure your provider. Если Cline уже настроен, та же форма находится в настройках: шестерёнка в верхней части панели → раздел API Configuration.
- В поле API Provider начните вводить
OpenAI Compatibleи выберите этот пункт из списка. - Заполните поля:
| Поле | Значение |
|---|---|
| Base URL | https://api.hubris.pw/v1 |
| OpenAI Compatible API Key | ваш ключ из личного кабинета |
| Model ID | полный ID с вендором, например anthropic/claude-haiku-4.5 |
- Нажмите Continue (при первом запуске) или Done (в настройках). Cline готов к работе — можно сразу писать задачу.
Блок Model Configuration под полями (размер контекста, цены, поддержка изображений) заполнять не обязательно. Учтите: по умолчанию цены там не заданы, поэтому счётчик стоимости в заголовке задачи Cline показывает $0.0000. Реальный расход смотрите в «Расходах».
Рекомендуемые модели
Cline — это многошаговый агент: длинный контекст, много вызовов инструментов, чтение/запись файлов. Под такой профиль подходят:
| Назначение | Модель |
|---|---|
| Сложные многошаговые задачи, рефакторинги | Claude Opus (anthropic/claude-opus-* из каталога) |
| Основная рабочая лошадка для кодинга | Claude Sonnet (anthropic/claude-sonnet-*) |
| Быстрые правки, экономичный режим | anthropic/claude-haiku-4.5 |
| Универсальная альтернатива | openai/gpt-4o-mini |
Полный актуальный список — в каталоге моделей. Подойдёт любая модель с поддержкой tool calling (фильтр в каталоге).
Стоимость и контроль расходов
Cline — агент, а значит делает много вызовов на одну задачу: чтение файлов, изменения, проверка результата. К каждому запросу он добавляет свой большой системный промпт — даже вопрос из одной строки уходит примерно на 2,3 тыс. токенов входа. Расход на одну сессию может оказаться выше, чем вы ожидаете.
Что советуем:
- Дневной лимит на ключ — задайте лимит расхода в настройках ключа. При превышении ответы вернутся с
429 daily_limit_exceeded, баланс не пострадает. - Раздельные ключи — отдельный ключ для каждого проекта или клиента, чтобы видеть расходы в «Расходах» разнесённо.
- Дешёвая модель для рутины — Haiku или GPT-4o-mini для типовых правок, переключаться на Opus только когда задача реально сложная.
Решение проблем
«Provider "openai-compatible" rejected the configured credentials»
Так Cline сообщает о любой проблеме с доступом — смотрите строку Provider response под сообщением.
Provider response: Неверный API-ключ— ключ не подошёл. Проверьте, что в поле OpenAI Compatible API Key именно ключ Hubris (форматsk-gw-+ hex), без пробелов по краям. В случае сомнений создайте новый ключ в личном кабинете.Provider response: Cannot connect to API: Connect Timeout Error— ключ ни при чём, Cline не достучался до сервера (сеть, прокси). Проверьте Base URL и соединение, затем нажмите Retry.
«Модель не найдена: …»
- Cline передаёт Model ID как есть. Нужен полный ID с вендором:
openai/gpt-4o-mini, а неgpt-4o-mini. - Убедитесь, что модель есть в нашем каталоге — Hubris поддерживает не все модели всех провайдеров.
Cline работает, но «теряет» инструменты или зацикливается
- Так часто ведут себя слабые модели в сложных сценариях с инструментами. Попробуйте более сильную модель — Claude Sonnet или Opus.
- Уменьшите размер задачи: дайте Cline более узкую цель за раз.
Баланс тает быстрее, чем ожидалось
- Каждое действие Cline (открыть файл, прочитать, изменить, проверить) — отдельный запрос с собственным
prompt_tokensиcompletion_tokens. Длинные файлы → большой prompt. - Откройте «Расходы» и отсортируйте по дате — будут видны все запросы за сессию.
Что дальше
- Каталог моделей — выбрать подходящую модель.
- Управление API-ключами — создать отдельный ключ и задать дневной лимит.
- Расходы — детализация всех запросов и потраченных рублей.
- Вызов инструментов — как работают tool calls под капотом.
Обновлено:
Claude Code (VS Code)
Подключение Claude Code (CLI и расширение VS Code) к Hubris через эндпоинт /v1/messages — Fable, Sonnet, Opus, Haiku, reasoning effort, кэширование, статусная строка.
Codex CLI
Подключение Codex CLI от OpenAI к Hubris через config.toml. GPT, Claude, DeepSeek и другие модели каталога в агенте, оплата в рублях.