tariel.ge › Полезное: бесплатные книги › Агент ИИ на своём компьютереБесплатно · автор Тариел Бежанидзе
← Агент ИИ ЛИСТ 14АгентыРЕВ. 1
Глава 14 · Агенты

Cline в VS Code: агент с терминалом и файлами

Агент прямо в редакторе: правит файлы, запускает команды в терминале, показывает каждое действие и ждёт подтверждения. Самый наглядный способ понять, что вообще делает агент.

Чем хорош именно этот вариант

Cline — расширение для Visual Studio Code. Оно показывает каждый шаг агента в отдельной панели: вот файл, который он хочет изменить, вот точная разница до и после, вот команда, которую он хочет выполнить. Ничего не происходит, пока вы не нажали кнопку.

Лучший выбор для первого знакомства

Если после глав 12 и 13 осталось ощущение, что агент — это чёрный ящик, поставьте Cline. Наглядность важнее, чем кажется: за пару часов работы с ним становится понятно, как агент рассуждает, где ошибается и когда его надо останавливать.

Установка

  1. Поставьте Visual Studio Code, если его нет: code.visualstudio.com. На Windows можно winget install Microsoft.VisualStudioCode, на Mac — обычным перетаскиванием.
  2. Откройте VS Code, слева — значок расширений (квадратики) или Ctrl/Cmd+Shift+X.
  3. Найдите Cline и установите.
  4. В левой панели появится значок расширения. Откройте его.

Подключение к локальной модели

Откройте настройки расширения (шестерёнка в его панели) и заполните:

ПолеДля OllamaДля LM Studio
API ProviderOllamaLM Studio
Base URLhttp://localhost:11434http://localhost:1234
Model IDточно из ollama listкак показано в окне сервера
Если список моделей пустой

Значит расширение не достучалось до движка. Вернитесь к проверке 1 из главы 08 и убедитесь, что адрес отвечает. Пустой список — это всегда проблема связи, а не расширения.

Два режима работы

РежимЧто делаетКогда использовать
PlanТолько обсуждает и составляет план. Файлы не трогаетВсегда начинайте отсюда. Особенно на локальной модели
ActВыполняет: правит файлы, запускает командыКогда план вас устроил
Привычка, которая экономит время

Сначала Plan: «что ты собираешься сделать?». Прочитали план — увидели, что агент понял задачу неправильно, — поправили формулировку. И только потом Act. На локальной модели это спасает от половины бессмысленных правок.

Как выглядит работа

пример
# Вы пишете в панели:
Добавь в script.py обработку аргументов командной строки:
--input (обязательный), --output (по умолчанию out.txt), --verbose (флаг)

# Cline показывает:
  [Read file]  script.py           → [Approve] [Reject]
  ...прочитал, подумал...
  [Edit file]  script.py           → показывает разницу построчно
                                      [Save] [Reject]
  [Command]    python script.py --help   → [Run] [Reject]

# Каждый шаг вы подтверждаете отдельно.
# Вывод команды Cline видит и при ошибке предлагает исправление.

Что смотреть перед подтверждением

Тип действияНа что смотреть
Чтение файлаПрактически всегда безопасно. Но обратите внимание, если он лезет за пределы проекта
Изменение файлаРазницу целиком. Особенно то, что удаляется — красные строки
Создание файлаПуть. Не создаёт ли он файл не там, где надо
Команда в терминалеВнимательно. Это то же самое, что глава 12: rm, sudo, установка пакетов, сеть
Обращение в интернетКуда именно. См. главу 20 про prompt injection
Про автоподтверждение

В настройках есть переключатели «подтверждать автоматически» для чтения, правок и команд. Соблазн включить их велик — подтверждать каждый шаг утомительно. Включайте только чтение, и только когда освоитесь. Автоподтверждение команд превращает Cline в то же самое, что interpreter -y, со всеми рисками главы 18.

Обязательно: git до начала

в папке проекта
git init
git add .
git commit -m "before cline"

В отличие от Aider, Cline не делает коммиты сам. Значит точку возврата создаёте вы. Делайте коммит перед каждой крупной задачей — тогда «git reset --hard» вернёт всё за секунду.

Честно про локальные модели и Cline

Это самый требовательный агент в книге

Cline интенсивно пользуется инструментами и держит в контексте много служебного текста. Модели до 14B здесь ведут себя плохо: путают формат вызова, зацикливаются, начинают «читать файл» по кругу. Ниже 14B пробовать почти бессмысленно, комфортно — от 32B. Если ваш потолок ниже, возьмите Aider из главы 13 или загляните в главу 23.

Отдельно про контекст: Cline быстро его расходует. Если агент начал «забывать» начало задачи — увеличьте длину контекста (глава 08) либо начните новую задачу вместо продолжения старой.

Родственные расширения

НазваниеОтличие
Roo CodeОтветвление от Cline с дополнительными режимами. Ставится и настраивается так же
ContinueБольше про автодополнение и чат по коду, чем про агентские действия. Легче к моделям

Если Cline тяжёл для вашего железа, Continue — разумная замена: он не пытается выполнять многошаговые цепочки, а помогает в редакторе, и на модели 7–8B ведёт себя прилично.

Если не работает

СимптомРешение
Список моделей пустПроверка 1 из главы 08. Движок не отвечает по указанному адресу
Зацикливается на чтении файловМодель слабовата. Возьмите крупнее или перейдите на Aider
«Забыл» начало задачиКончился контекст. Увеличьте его или начните задачу заново
Правки применяются не тудаОткройте правильную папку как проект в VS Code, а не отдельный файл
Очень медленноПосмотрите ollama ps: модель могла уехать на процессор

Чек-лист главы

Что дальше

Универсальный агент, который не привязан ни к коду, ни к терминалу, и расширяется подключаемыми инструментами.

Глава14 — Cline в VS Code: агент с терминалом и файлами
БлокАгенты
Далее15 — Goose: универсальный агент с расширениями
Ревизия1
↑ Оглавление Предыдущая глава← 13 · Aider: правит ваши файлы и делает коммиты Следующая глава15 · Goose: универсальный агент с расширениями →

Бесплатная книга · tariel.ge · команды и версии проверяйте в официальной документации проектов

Книга бесплатна для чтения. Автор — Тариел Бежанидзе, компьютерный мастер в Батуми · tariel.ge · все бесплатные книги. Копировать текст целиком на другие сайты — только со ссылкой на источник.