Гайд по Cline CLI: установка, cline auth, plan/act и субагенты
Новый самостоятельный CLI от Cline переносит того же агента plan/act в терминал. Разбираем установку, настройку провайдера через cline auth, флаги задач и включение субагентов в VS Code — с кадром из видео на каждом шаге.
Коротко
- Ставим один раз через npm install -g cline, затем вводим cline в любой папке проекта — интерактивная сессия запущена.
- Интерактивные сессии стартуют в plan mode; введите /act, когда готовы к правкам, /plan — чтобы вернуться, а для разовых запусков есть --mode.
- cline auth — пульт управления аккаунтами и моделями: аккаунт Cline, Cline или bring-your-own провайдеры вроде OpenRouter; перезапускайте в любой момент.
- Субагенты живут в расширении VS Code: установите CLI, нажмите Enable Subagents в панели Cline — и она поднимет headless-инстансы в терминале для параллельного исследования.
Cline CLI & Sub Agents: Cline is back with a new CLI Agent, but is it good?
Канал: AICodeKing8:03
Introducing Cline CLI 2.0
Канал: Cline1:42
Cline CLI — official documentation
Доки: docs.cline.bot
Скриншоты взяты из чистой демки терминала и VS Code в обзоре AICodeKing — лица в кадре нет вовсе, пропущен только финальный экран. Команды и флаги сверены с официальной документацией Cline и анонсом релиза.
Кадры принадлежат их авторам и здесь указаны со ссылками на точный момент; текст — наш.
Настраиваем Cline CLI шаг за шагом
Знакомимся с CLI, устанавливаем, подключаем провайдера
- 1
Понять, что такое CLI — и чем она не является
В документации CLI позиционируется как спутник IDE, а не замена: то же ядро агента, рассчитанное на управление множеством параллельных агентов, полностью скриптуемое и с удобным чат-интерфейсом. Режимы plan и act, чекпоинты, выполнение в терминале и headless-режим — всё на месте, поэтому весь опыт с расширением VS Code переносится напрямую.
Страница What's Special About Cline CLI в официальной документации.Смотреть на 1:18 - 2
Посмотреть, для чего она создана
В анонсе собраны идеи из их Discord: NPC в играх, записывающие память в файлы, мобильное приложение для удалённого управления, Discord-бот на Cline, Cline внутри shell-скриптов и Cline в GitHub issues, автоматически разбирающий баг-репорты. Для старта ничего из этого не нужно — но это объясняет, почему CLI изначально headless и скриптуемая.
Идеи применения CLI прямо из анонса релиза.Смотреть на 1:48 - 3
Установить CLI
Выполните npm install -g cline в любом терминале (нужен Node.js). Та же команда показана в баннере Cline for CLI is here внутри VS Code — с кнопкой копирования. Когда npm закончит, команда cline доступна откуда угодно.
Официальная команда установки из анонса CLI Preview.Смотреть на 4:30 - 4
Запустить в папке проекта
cd в проект и введите cline. Приветственная плашка покажет preview-версию, активного провайдера с моделью и бейдж plan mode; ниже Start a new Cline task ждёт первого указания. Нижняя строка — шпаргалка по хоткеям: alt+enter или ctrl+j — новая строка, ctrl+e открывает редактор для длинных промптов, enter отправляет.
Первый запуск: приветственная плашка и ввод новой задачи.Смотреть на 3:36 - 5
Подключить провайдера через cline auth
Свежая установка не знает ни аккаунтов, ни моделей. Запустите cline auth — появится мастер авторизации: войти с аккаунтом Cline, выбрать активного провайдера (Cline или свой), настроить API-провайдера или выйти. В демо активная модель — anthropic/claude-sonnet-4.5 через OpenRouter. Передумали позже? Всё та же команда cline auth.
Мастер cline auth с опциями аккаунта и провайдера.Смотреть на 3:49
Plan, act и headless-флаги
- 6
Сначала будет plan mode
Отправьте приветствие — и Cline ответит планом, не трогая файлы: интерактивные сессии стартуют в plan mode, который отвечает за сбор информации и проектирование. Ответ завершается расходом токенов и ценой, а в поле ввода появляется подсказка [plan mode] Cline is ready for your message...
Первый ответ в plan mode — с ценой и подсказками режимов.Смотреть на 4:24 - 7
Переключиться на act через /act
Введите /act, и сессия перейдёт в act mode, где Cline может править файлы и выполнять команды; /plan возвращает обратно. Для разовых задач стартовый режим задаётся флагом -m/--mode, а в актуальной справке CLI есть и -p/--plan для запусков «сначала план».
![Terminal cursor pointing at the /plan or /act to switch modes hint below the [plan mode] Cline is ready for your message input in the Cline CLI](/images/guides/cline-cli-tutorial/cline-cli-tutorial-plan-act-switch-hint.webp "Terminal cursor pointing at the /plan or /act to switch modes hint below the [plan mode] Cline is ready for your message input in the Cline CLI")
Подсказка /plan or /act висит прямо под вводом.Смотреть на 4:16 - 8
Освоить headless-флаги
Раздел INSTANT TASK OPTIONS в справке CLI — шпаргалка: -o (--oneshot) выполняет задачу полностью автономно и выходит, -y (--yolo) отключает все интерактивные вопросы и завершает всё сам, -s переопределяет настройку для одной задачи, -m задаёт стартовый режим. Набор флагов с релиза менялся — в актуальной справке oneshot/yolo свернуты в --auto-approve и -p/--plan, так что проверьте cline -h для своей версии.
Instant task options: oneshot, yolo, настройки на задачу и режим.Смотреть на 4:35
Субагенты из расширения VS Code
- 9
Обновить расширение и найти баннер
Субагенты поставляются с расширением VS Code, новинка v4.106.0. Обновите Cline, откройте панель — появятся changelog и баннер Cline for CLI is here! со сниппетом npm install -g cline и пометкой, что Cline может запускать команды cline в отдельных подпроцессах, сохраняя чистоту основного окна контекста.
Баннер CLI в панели Cline внутри VS Code.Смотреть на 5:25 - 10
Нажать Enable Subagents
Вторая кнопка баннера, Enable Subagents, включает функцию в настройках расширения (feature settings). Именно этот шаг падает без CLI: субагенты работают, запуская headless-инстансы cline в вашем терминале, так что сначала должен пройти npm install -g cline.
Installed и Enable Subagents стоят рядом в панели.Смотреть на 5:32 - 11
Попросить субагента
Дайте главному агенту задачу, где полезно исследование — в демо: Spin up a sub agent that tells me about the repo. Cline оценивает запрос и сама отправляет субагента, когда помогает параллельное изучение; можно и попросить напрямую.
Главный агент планирует запуск sub agent.Смотреть на 5:42 - 12
Одобрить ожидающий промпт
До запуска панель показывает Cline wants to use a subagent вместе с точным промптом, который собирается отправить, — здесь это пятипунктовый анализ репозитория: назначение, стек, функциональность, модель данных и паттерны реализации. Одобрите (или доверьтесь auto-approve) — субагент отработает в headless и вернёт отчёт, не раздувая основное окно контекста.
Ожидающий промпт субагента — пункт за пунктом.Смотреть на 5:46
Cline CLI против расширения Cline для VS Code: что и когда
Обе оболочки гоняют одного и того же агента Cline с режимами plan и act, так что выбор — о том, где должен жить агент, а не о том, что он умеет.
- 1Повседневная разработка: оставайтесь в расширении. Панель, диффы, чекпоинты и контекст редактора прямо в VS Code.
- 2Автоматизация и рутина: берите CLI. Разовые промпты, shell-скрипты, GitHub Actions, боты для Discord и Slack — headless-запуски с флагами вроде -o и -y ровно для этого и созданы.
- 3Смешанный сценарий: состояние переезжает. Задача может начаться в терминале и продолжиться в IDE (и наоборот) — план, набросанный в терминале, становится послеполуденными правками в VS Code.
- 4Субагентам нужны обе части: расширение оркеструет, CLI исполняет. Кнопка Enable Subagents работает только при установленной CLI — весь механизм именно в этом.
Если выбирать что-то одно, берите то, где уже проходит ваша работа; установка CLI — это одна npm-команда, а переключатель субагентов в любом случае откроется.
Субагенты на практике: промпты, ограничения, починка
Субагенты — визитная карточка релиза и одновременно место, где спотыкаются с первого раза. Что показывает демо и что добавляет актуальная документация:
- 1Нет кнопки Enable Subagents? Сначала обновите расширение до v4.106.0 или новее — кнопка живёт в баннере Cline for CLI, а сам CLI должен быть установлен, иначе ничего не поднимется.
- 2Субагенты не запускаются? Попросите явно ("spin up a sub agent to..."). По актуальной документации субагенты — исследователи «только чтение»: читать файлы, искать и запускать безопасные команды могут, править файлы, пользоваться браузером или MCP и порождать новых субагентов — нет.
- 3Отработал — и что дальше? Каждый субагент возвращает отчёт с найденными путями к файлам, а статистика по агентам (вызовы инструментов, токены, стоимость) видна в чате — можно проверить, чем занималась вся команда.
- 4Надоело всё одобрять? Запуск субагентов подчиняется auto-approve-правилу Read project files — включите его, и промпты перестанут блокировать, при этом полный промпт остаётся виден в панели.
- 5Поведение изменилось с времён видео? На релизе это был экспериментальный переключатель в feature settings; актуальная документация описывает субагентов как включённых по умолчанию с настройкой через Settings → Features, а набор флагов консолидирован (--auto-approve, -p/--plan). Когда доки и старый обзор противоречат друг другу, верьте докам.
Относитесь к субагентам как к усилителю исследования, а не армии кодеров: они сжимают час чтения кодовой базы в один отчёт, а пишет по-прежнему главный агент.