Cline: как установить и настроить агента — шесть способов, провайдеры и первая задача

01Что такое Cline и как он работает

Cline — это агентное ядро, поверх которого собрано несколько приложений: расширение для редактора, плагин для JetBrains, терминальный CLI, отдельное десктопное приложение, SDK и доска Kanban. Официальное описание проекта — «Autonomous coding agent as an SDK, IDE extension, or CLI assistant».

Главная особенность — human-in-the-loop: агент читает файлы, пишет код и запускает команды, но каждое действие показывает до выполнения и ждёт подтверждения. Правила автоподтверждения настраиваются отдельно и по умолчанию выключены.

• Plan & Act — раздельные режимы «думать» и «делать»; это главный способ держать агента под контролем.
• Checkpoints — откат изменений файлов без потери контекста разговора.
• MCP — подключение внешних инструментов (серверов Model Context Protocol).
• Rules и Skills — файлы с правилами проекта и модульные инструкции под типовые задачи.
• Subagents — параллельные исследовательские агенты, которые не засоряют основной контекст.
• Memory Bank — структурированная документация, помогающая агенту помнить проект между сессиями.

02Что подготовить перед установкой

03Шесть способов установки

Официальная документация предлагает пять-шесть путей; выбирайте по тому, где вам удобнее работать. Все используют одно агентное ядро, а конфигурация проектов переносится между ними.

# VS Code: Ctrl/Cmd + Shift + X -> найти 'Cline' -> Install
# затем: значок Cline на боковой панели -> Sign in

npm i -g cline
cline --help

# JetBrains: Settings -> Plugins -> Marketplace -> Cline

# cline.bot/desktop — инсталлятор под вашу платформу

cd /path/to/your/repo
npx kanban

npm install @cline/sdk

04Доступ к моделям: четыре пути

Это главный выбор при настройке. Документация Cline делит доступ на четыре варианта: собственный провайдер (usage-billing), подписка ClinePass, свои ключи (BYOK) и локальные модели. Все варианты сосуществуют — можно переключаться под задачу.

05Первая задача: правила, игнор-файл, MCP

После установки потратьте 10 минут на инфраструктуру — это окупается сразу. Агент читает правила проекта и уважает игнор-файл, поэтому самые частые проблемы («лезет не туда», «трогает секреты») решаются именно здесь.

- Стек: TypeScript, React, Vite
- Тесты обязательны для новой логики
- Не менять файлы миграций вручную
- Отвечать по-русски

node_modules/
dist/
.env*
*.pem

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./data"]
    }
  }
}

npm test -- --watch=false

06Что реально помогает в работе

• Subagents — полезны на больших репозиториях: исследование идёт параллельно и не съедает основной контекст.
• Agent Teams в CLI — сценарий для сложных задач, где агенты делят роли.
• Планировщик (Scheduling) — регулярные прогоны: ночные тесты, ревью PR, сводки.
• Коннекторы — CLI умеет писать в Telegram, Slack, Discord, Google Chat, WhatsApp: удобно для отчётов о прогонах.
• ACP-режим — тот же агент внутри Zed, JetBrains, Neovim и Emacs.
• Multi-root Workspaces — работа сразу с несколькими репозиториями в одном окне.

07Сколько стоит и как платить из РФ

Само расширение Cline бесплатно для индивидуальных разработчиков: страница тарифов прямо говорит, что платить нужно только за инференс моделей — по факту использования, без подписки на сам продукт. Дополнительно есть опциональная подписка ClinePass за $9.99 в месяц и корпоративный тариф с SSO, централизованным биллингом и SLA.

08Cline и альтернативы: проверяемые цифры

Ниже — метрики, которые легко проверить через публичный GitHub API на дату съёма. Звёзды не равны качеству, но показывают размер сообщества и темп изменений: колонка «последний пуш» честно говорит, живёт ли проект.

09Типичные ошибки при настройке

1. Ставить агента на репозиторий без тестов: у агента нет критерия готовности, и результат приходится проверять руками.
2. Давать доступ к секретам: .env-файлы должны быть в игнор-файле, а ключи — в переменных окружения.
3. Включать автоодобрение целиком вместо списка разрешённых безопасных команд.
4. Работать в основной ветке: агентная сессия должна жить в своей ветке или worktree.
5. Не писать правила проекта: одно и то же замечание в каждой сессии — это время и токены.
6. Забыть про лимиты провайдера: длинный контекст на дорогой модели съедает бюджет быстрее, чем кажется.