Инструменты19 ноября 2026 г.5 мин чтения
Cline в VS Code: настройка AI-агента, Plan/Act и контроль расхода токенов
Cline — открытый AI-агент для VS Code: сам правит файлы, запускает команды и отлаживает в браузере. Разбираем подключение через OpenAI-совместимый API, правила проекта в .clinerules и приёмы против перерасхода токенов.
Cline — расширение для VS Code с открытым исходным кодом, которое работает не как автодополнение, а как агент: читает файлы проекта, вносит правки, выполняет команды в терминале и проверяет результат в браузере, запрашивая подтверждение на каждом шаге. В статье — как устроен Cline, как подключить его к OpenAI-совместимому API, зачем нужны файлы правил .clinerules и какие настройки сдерживают расход токенов.
Что Cline делает в редакторе
Проект начинался в июле 2024 года как расширение Claude Dev, а в октябре 2024 года получил нынешнее имя Cline. Расширение живёт в боковой панели VS Code и ведёт работу циклично: предлагает план, после подтверждения правит файлы, запускает команды и показывает результат. Человек остаётся в контуре принятия решений — этот подход называют human-in-the-loop.
Два режима разделяют работу на этапы. В Plan агент исследует код и предлагает решение, в Act — выполняет его. Поддержка Model Context Protocol позволяет подключать дополнительные инструменты, а контрольные точки сохраняют снимки рабочего пространства в теневом Git-репозитории: к любому шагу можно вернуться, сравнить диффы и откатить изменения.
На вход Cline принимает текст и изображения — например, скриншоты и макеты. На выходе он редактирует файлы, выполняет команды терминала и делает скриншоты в headless-браузере. Аудио и видео не поддерживаются. Автодополнения по мере ввода, как у GitHub Copilot, у Cline нет: это архитектурное ограничение, а не недоработка настройки.
Что понадобится
Собственного контекстного окна у Cline нет: он наследует лимит выбранной языковой модели. То же с максимальным объёмом ответа за один шаг — он определяется возможностями модели. Поэтому для работы нужны три вещи: установленное расширение, доступ к модели через OpenAI-совместимый API и точный идентификатор этой модели.
Подключение через OpenAI-совместимый провайдер
В настройках Cline выберите провайдера OpenAI Compatible. Он принимает три поля: Base URL сервиса (обычно адрес заканчивается на /v1), секретный ключ API Key и точный Model ID. Для API Hubris Base URL — https://api.hubris.pw/v1, ключ создаётся в разделе «Ключи» личного кабинета.
Идентификатор модели указывайте ровно так, как он записан в каталоге: например, anthropic/claude-sonnet-5.5 или openai/gpt-5.3-codex. После подключения Cline не определит возможности модели автоматически: размер контекстного окна, лимит токенов на ответ, поддержку изображений и инструментов управления придётся выставить вручную. Пока эти поля не заполнены, расширение применяет минимальные значения.
| Модель | Идентификатор | Контекст | Вход | Выход |
|---|---|---|---|---|
| Claude Sonnet 5.5 | anthropic/claude-sonnet-5.5 | 1 000 000 токенов | текст, изображения, файлы | текст |
| GPT-5.3 Codex | openai/gpt-5.3-codex | 400 000 токенов | текст, изображения, файлы | текст |
Параметры и цены обеих моделей — на карточках: Claude Sonnet 5.5 и GPT-5.3 Codex. Большое контекстное окно пригодится, когда агент читает крупные файлы и документацию; для локальных правок хватает и меньшего лимита.
Первую задачу дайте небольшую — например, попросите прочитать один файл и предложить правку. Так вы проверите связку до того, как агент пойдёт по всему проекту.
.clinerules: правила проекта
С 21 июня 2025 года Cline перешёл от текстового поля Custom Instructions к файловой системе правил. Правила хранятся markdown-файлами в каталогах .clinerules/ или .cline/rules/ в корне проекта. Кроме собственных файлов, Cline распознаёт правила смежных инструментов: .cursorrules, .windsurfrules и AGENTS.md.
Важное ограничение: для Cline правила — это контекст, а не механизм принуждения. Они подсказывают агенту, как принято работать в проекте, но не могут запретить ему прочитать файл или выполнить команду. Если нужны жёсткие блокировки, в .clinerules/hooks/ настраиваются хуки исполнения, например PreToolUse: они перехватывают действие до выполнения.
Plan/Act и контрольные точки
Режим Plan нужен, чтобы сначала договориться о решении: агент изучает файлы и показывает, что собирается менять. Режим Act выполняет согласованный план. Контрольные точки создаются автоматически: каждая — снимок рабочего пространства в теневом Git-репозитории. Перед принятием правок можно открыть диффы, а если шаг оказался неудачным — откатить изменения и вернуться к предыдущему состоянию.
Такая связка важна для длинных задач: агент проходит десятки шагов, и возможность откатиться дешевле, чем просить его переделать всё заново.
Почему агент быстро расходует токены
У Cline есть характерная статья расходов: на крупных кодовых базах без файлов правил агент быстро тратит токены из-за частых циклов чтения файлов и объёмных логов терминала. Правила в .clinerules задают ему границы проекта, но не заменяют настройку лимитов.
Второй источник перерасхода — сам провайдер OpenAI Compatible. Cline не умеет автоматически определять лимиты и возможности сторонней модели, поэтому по умолчанию ставит минимальные значения контекста и ответа. Если не поправить их под выбранную модель, длинные файлы и логи не поместятся в один шаг, и работа разобьётся на лишние запросы.
Практический порядок такой: сначала выставить контекст и максимальный ответ по спецификации модели, затем описать в .clinerules структуру проекта и запреты, а неудачные шаги откатывать контрольной точкой, а не повторным прогоном задачи.
Кому подойдёт Cline
Cline — для тех, кому нужен агент в VS Code с подтверждением шагов и точками отката. Он не заменяет автодополнение: для подсказок по ходу ввода нужен другой инструмент. Если вы работаете в JetBrains или ищете другой интерфейс агента, посмотрите разборы OpenCode, Roo Code и Kilo Code и общий материал о нейросетях для кода.
Все модели из статьи доступны в Hubris — единый API, оплата в рублях.
