Cline CLI: агент Cline в терминале со своим провайдером моделей

Cline известен как расширение для редактора, но у него есть и консольная версия. Cline CLI запускает того же агента в терминале: можно вести диалог, отправить одноразовую задачу аргументом или принять данные по каналу из другой команды. Ниже разберём установку, подключение собственного провайдера и безопасные способы запускать задачи без редактора.

Важная оговорка: документация Cline быстро меняется, а ниже описан набор флагов из актуальной справки на момент написания. Перед использованием сверьтесь с выводом cline --help в вашей версии.

Что такое Cline CLI

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

• интерактивный режим: просто cline, либо терминальный интерфейс по флагу -i;
• одноразовые задачи: cline "ваша задача";
• режим планирования -p и режим действия (по умолчанию);
• безголовый режим для скриптов: включается флагом --json, ввод по каналу или перенаправление вывода;
• подключение MCP-серверов (cline mcp), хуки и плагины, расписания (cline schedule).

Конфигурация лежит в ~/.cline/ и общая для расширения редактора, CLI и SDK: правила, навыки, настройки провайдеров. Поэтому то, что вы настроили для Cline в IDE, консольный клиент подхватывает.

Установка

Нужен Node.js 20 или новее (рекомендуется 22):

npm install -g cline
cline --version

Не ставьте пакет через sudo: лучше настроить пользовательский каталог npm. Обновление выполняется командой cline update или флагом --update.

Подключаем свой провайдер

Запустите мастер настройки:

cline auth

Выберите провайдера, указывающего на OpenAI-совместимый API, и введите три значения: Base URL, ключ и идентификатор модели. Для шлюза Zukko это:

• Base URL: https://api.zukko.pro/v1 (для клиентов на OpenAI-формате адрес с /v1);
• ключ: fetch_... из кабинета↗;
• модель: идентификатор из GET /v1/models, например claude-sonnet-5-5 или deepseek-v4.1-flash.

Согласно справке, команда cline auth принимает опции для настройки без вопросов: провайдер, ключ, идентификатор модели и базовый адрес (-b, --baseurl). Точный идентификатор провайдера для OpenAI-совместимого API зависит от версии, поэтому один раз пройдите интерактивный мастер, посмотрите итог в cline config, а потом уже автоматизируйте. Не вставляйте ключ прямо в историю командной строки на общей машине: в справке отмечено, что ключи провайдеров хранятся в ~/.cline/data/settings/providers.json, так что ограничьте права на каталог.

В Cline есть и провайдер Anthropic с опцией собственного базового адреса. Общее правило шлюза: для провайдеров Anthropic-формата адрес указывается без /v1 (https://api.zukko.pro), для OpenAI Compatible — с /v1. Проверенный в документации Zukko вариант для Cline — OpenAI Compatible; если выбрали Anthropic и получаете 404, первым делом проверьте суффикс адреса. Подробнее про выбор формата — в документации Zukko↗ и в статье про подключение Cline↗.

Запуск задач

Несколько типовых сценариев:

## Интерактивная сессия
cline

## Одноразовая задача
cline "перепиши модуль parser на async/await"

## Сначала план, без правок
cline -p "предложи план миграции на новую версию библиотеки"

## Данные по каналу
git diff | cline "найди возможные регрессии в этих изменениях"

## Структурированный вывод для скриптов
cline --json "перечисли TODO в проекте" | jq -r 'select(.type == "run_result") | .text'

Флаги, которые чаще всего пригождаются: -m (модель на этот запуск), -P (провайдер), -c (рабочий каталог), -t (таймаут в секундах), --thinking (уровень рассуждений от none до xhigh).

Осторожно: автоодобрение

Самое важное, что нужно знать. В справке сказано, что при запуске с аргументом-задачей Cline по умолчанию работает в режиме действия с включённым автоодобрением. То есть правки файлов и команды выполняются без вопросов. Параметр управляется флагом --auto-approve <true|false>:

cline --auto-approve false "обнови зависимости и запусти тесты"

Для автономных запусков документация рекомендует чистую ветку и проверку результата. В режиме ACP (когда Cline встроен в редактор) по умолчанию, наоборот, ничего не одобряется автоматически. Отдельного списка разрешённых и запрещённых команд в CLI нет; чтобы заблокировать команды, документация предлагает хук PreToolUse.

Практический минимум для безопасности: запускайте агента в отдельной ветке git, для CI используйте отдельный ключ с лимитом, а в интерактивной работе включайте режим -p, пока не проверили план.

Cline CLI в CI и скриптах

Безголовый режим удобен для автоматизации: ревью диффа при пулл-реквесте, разбор причин падения тестов, генерация описания изменений. В документации Cline есть примеры для GitHub Actions. Общую схему можно собрать так:

git diff origin/main...HEAD | cline --auto-approve false --timeout 600 \
  "проверь изменения на ошибки и перечисли найденное списком"

Здесь --timeout 600 ограничивает задачу десятью минутами. Выбор модели для такой рутины — вопрос цены. Цены на 18 октября 2026: deepseek-v4.1-flash стоит $0.013 за 1M токенов входа и $0.038 за 1M выхода, claude-sonnet-5-5 — $0.4 и $2. Допустим, ревью получает 40 000 токенов диффа и возвращает 3 000 токенов:

• deepseek-v4.1-flash: 0.04 × 0.013 + 0.003 × 0.038 = 0.00052 + 0.000114 ≈ $0.0006;
• claude-sonnet-5-5: 0.04 × 0.4 + 0.003 × 2 = 0.016 + 0.006 = $0.022.

Разница по цене очевидна, но качество ревью зависит от задачи: оценивайте по индексу силы (39 у deepseek-v4.1-flash, 48 у claude-sonnet-5-5) и проверяйте на своих диффах. Актуальный список цен — GET https://api.zukko.pro/v1/models или страница «Модели» в кабинете. Агентам с длинным контекстом помогает кэш, но при вызове Claude через OpenAI-формат скидки за кэш нет: весь вход идёт по цене входа. Подробнее о расчёте — в статье про стоимость агентной сессии↗.

Cline внутри редактора через ACP

Тот же cline --acp запускает Cline как агента для редакторов с поддержкой протокола ACP: Zed, JetBrains AI Assistant, Neovim, Emacs. Редактор сам запускает команду и общается с агентом через stdio. Учётные данные, сохранённые через cline auth, подхватываются автоматически. Это способ получить Cline без отдельного расширения.

Диагностика

• cline doctor диагностирует конфигурацию, cline doctor log открывает лог;
• 401 от шлюза — неверный ключ или не тот Base URL;
• 402 — не хватает баланса, пополнение от $1;
• 403 model_not_allowed_for_key — модель не входит в список ключа;
• 404 model_not_found — опечатка в идентификаторе модели.

Создайте отдельный ключ для CLI с дневным лимитом: так зациклившаяся задача упрётся в потолок. Баланс пополняется через СБП (комиссия платёжной страницы 8,5%), картой MasterCard или криптовалютой.

Частые вопросы

Чем Cline CLI отличается от расширения для VS Code?

Это тот же агент, но в терминале: без интерфейса редактора, с возможностью работать в скриптах и CI. Конфигурация (~/.cline/) общая.

Нужен ли Cline CLI редактор?

Нет. Для работы нужны Node.js, пакет cline и настроенный провайдер.

Как избежать лишних правок в автономном запуске?

Передайте --auto-approve false, запустите задачу в режиме -p или работайте в отдельной ветке git и проверяйте diff.

Какую модель выбрать для CLI?

Для рутины дешёвую, для сложных задач посильнее. Сравнивайте по цене, контексту и индексу силы и проверяйте на своих задачах.