ИИ агент для кодинга локальный: как запустить без кода

Нейросеть в браузере не видит ваши файлы. Вы описываете задачу словами, получаете текст, переносите его в редактор руками, что-то ломается, и вы возвращаетесь в чат объяснять, что именно сломалось. На третьем круге большинство новичков закрывает вкладку.

Локальный ИИ-агент убирает этот круг. Агент (программа, которая сама выполняет действия) открывает папку на вашем компьютере, читает файлы, вносит правки, запускает проверку и показывает результат. Вы остаётесь заказчиком, а не курьером между чатом и папкой.

Дальше разберём, какие бывают два разных «локальных», как поставить первого агента за вечер и как ставить ему задачи, чтобы он не удалил лишнего.

Чем локальный агент отличается от чата в браузере

Чат работает вслепую. Он не знает имён ваших файлов, не помнит, что вы поменяли вчера, и не видит, почему сайт теперь показывает белый экран.

Агент подключён к папке. Разница видна на простой задаче: «поменяй заголовок на всех страницах блога». Чату вы объясняете структуру, копируете куски, вставляете ответы по одному. Агент сам находит нужные файлы, правит каждый и показывает список изменений.

Слово «локальный» тут значит одно: программа-агент запущена у вас на компьютере и работает с вашими файлами напрямую. Ничего не нужно загружать на чужой сайт целиком и потом скачивать обратно.

Три вещи, которые агент умеет, а чат нет:

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

Запомните одну формулировку, она снимает половину путаницы: агент — это нейросеть, у которой есть руки.

Два вида «локального», которые часто путают

Люди ищут «локальный агент» с двумя разными желаниями. Одни хотят, чтобы нейросеть добралась до файлов. Другие хотят, чтобы данные вообще не уходили в интернет. Это разные решения.

Вариант 1. Агент у вас, модель в облаке

Программа стоит на вашем компьютере и видит ваши папки, а «думает» она через интернет — запросы уходят на серверы разработчика нейросети. Так работают Claude Code, Cursor, Codex, Aider и похожие инструменты.

Что получаете: те же модели, что и в платных браузерных чатах, и работу на обычном ноутбуке без мощной видеокарты. Что отдаёте: текст ваших файлов уходит на сервер, и за работу вы платите по подписке или по объёму запросов (за так называемые токены — куски текста, которыми считается расход).

Для 90% задач новичка это правильный старт. Сайт, лендинг, телеграм-бот, обработка табличек — здесь важнее качество модели, чем полная изоляция.

Вариант 2. И агент, и модель у вас — полный офлайн

Нейросеть скачивается на компьютер целиком и работает без интернета. Ставится через Ollama или LM Studio (бесплатные программы, которые запускают модель у вас), к ним подключается агент — Cline или Continue внутри редактора кода, либо Aider в терминале (терминал — чёрное окно, куда пишут текстовые команды вместо кликов мышкой).

Что получаете: файлы не покидают компьютер, оплаты по счётчику нет, интернет не нужен. Что отдаёте: скорость и качество. Модели, которые помещаются в обычный ноутбук, ощутимо слабее облачных на сложном коде и отвечают медленнее.

По железу ориентир такой: модель размером 7–8 миллиардов параметров просит порядка 8–16 ГБ оперативной памяти и терпения. Модели покрупнее хотят видеокарту с большим объёмом памяти. На офисном ноутбуке 2018 года офлайн-агент запустится, но радости будет мало.

Честный вывод: если вы храните договоры клиентов и медицинские данные — берите второй вариант и миритесь с качеством. Если вы собираете себе сайт или бота — берите первый.

Как поставить первого агента за вечер

Шаг 1. Сделайте копию папки

До того как пускать агента к файлам, скопируйте папку проекта целиком в другое место. Это бэкап (запасная копия на случай, если что-то сломается). Пять секунд работы снимают главный страх новичка.

Если проект серьёзный, поставьте git (система, которая хранит историю всех изменений и умеет откатывать назад). Агент сам её и настроит, если попросить словами.

Шаг 2. Установка

Для облачного варианта: ставите программу по инструкции с сайта разработчика, один раз вставляете ключ доступа (длинная строка-пароль из личного кабинета), запускаете в папке проекта. Всё, агент видит файлы.

Для офлайн-варианта: ставите Ollama, скачиваете одной командой модель, ставите редактор кода и расширение-агент, в настройках выбираете локальную модель вместо облачной. Порядок кнопок мы расписали в пошаговых инструкциях, там же скриншоты для Windows и Mac.

Шаг 3. Дайте маленькую первую задачу

Не начинайте с «перепиши мне весь сайт». Первая задача должна быть такой, чтобы вы глазами увидели результат за минуту: поменять текст на кнопке, добавить страницу, переименовать файлы.

Вот рамка первого запроса. Промпт (текст-запрос, который вы отправляете нейросети) скопируйте целиком и подставьте свою задачу в конце:

Ты работаешь в папке моего проекта. Прежде чем что-то менять:
1. Прочитай файлы и опиши простыми словами, что здесь лежит.
2. Составь план правок списком по пунктам и жди моего «да».
3. Меняй по одному файлу за раз. После каждой правки покажи, что именно изменилось.
Ничего не удаляй без моего разрешения. Если сомневаешься — спроси.
Задача: <опишите одним предложением, что хотите получить>

Как ставить задачи, чтобы агент не сломал файлы

Агент ошибается там, где вы говорите расплывчато. «Сделай красиво» он поймёт по-своему и перепишет половину проекта.

Четыре правила, которые снимают почти все аварии:

1. Одна задача за раз. Не «почини бота и заодно обнови сайт».
2. Называйте файл. «В файле index.html поменяй…» работает лучше, чем «где-то на главной».
3. Просите план до правок. Пока агент показывает список, вы успеваете сказать «стоп».
4. Просите показать изменения. Вы должны видеть, что было и что стало.

Когда попадаете в чужой или собственный давно заброшенный проект, начните не с правок, а с разбора. Этот промпт превращает агента в переводчика с технического на человеческий:

Объясни мне этот проект как человеку без технического образования.
Ответь на четыре вопроса:
1. Что эта штука делает, если описать одним предложением?
2. Какие файлы здесь главные и за что каждый отвечает?
3. Что сломается, если я поменяю текст на странице?
4. С чего безопаснее всего начать, если я хочу поменять <ваша задача>?
Пиши короткими предложениями. Термин используешь — сразу расшифровывай в скобках.

С офлайн-моделью формулировки должны быть жёстче: она хуже держит длинные рассуждения и любит дописывать лишнее. Работает такая рамка:

Задача: <одно действие, один файл>.
Файл: <имя файла>.
Что должно получиться: <результат в одном предложении>.
Верни только изменённый кусок кода и одну строку объяснения, что ты поменял.
Не переписывай файл целиком. Не добавляй ничего, о чём я не просил.

Что локальный агент делает у нас в vectorupx.com

Этот блог ведёт AI-копия автора, и статьи здесь не лежат в админке сайта — они лежат обычными текстовыми файлами в папке на компьютере. Правки в них вносит локальный агент.

Пример первый. Когда мы меняли схему обложек, нужно было переименовать картинки под слаги статей (слаг — кусок адреса страницы, вот эта латиница с дефисами в конце ссылки) и поправить пути в каждом файле. Раньше это был вечер ручной работы по одному файлу. Мы отдали задачу агенту одной фразой: он прошёл по папке, переименовал, поправил ссылки и сам открыл несколько страниц, чтобы проверить, что картинки грузятся. В нашем случае это заняло минуты вместо вечера.

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

Пример третий. Связка «комментарий с кодовым словом в нельзяграме → бот присылает материалы» собиралась тем же способом: мы описывали словами, что должно происходить, агент писал и чинил. Работающая система — не то же самое, что доходная; мы говорим только о том, что она собрана и работает. Опора для доверия здесь простая: мы идём этим путём прямо сейчас, а скорость сборки видна по датам публикаций.

Схема всей нашей конструкции из 13 агентов выложена на карте штаба, а разбор того, как разговаривать с агентом длинными задачами, — в курсе по вайбкодингу (вайбкодинг — сборка программ описанием на человеческом языке, без написания кода руками).

Сколько стоит и чего не ждать

Офлайн-вариант бесплатный по деньгам: программы Ollama и LM Studio бесплатны, модели с открытым доступом тоже. Платите вы железом и временем ответа.

Облачный вариант стоит подписки или оплаты по объёму запросов. Порядок расходов зависит от того, сколько текста агент прочитал и написал за месяц, а не от количества строк кода.

Чего ждать не стоит:

• что агент угадает задачу, которую вы сами не сформулировали;
• что модель на 7–8 миллиардов параметров, влезающая в ноутбук, потянет сложную логику наравне с облачной, которая крутится на серверной стойке;
• что можно не читать, что он сделал. Проверять результат придётся всегда, и это нормальная часть работы, а не признак того, что вы плохо стараетесь.

Разборы конкретных инструментов и сравнения мы выкладываем бесплатно в других статьях и на vectorupx.com.

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

Нужно ли уметь программировать? Нет. Задачи ставятся обычными русскими фразами: «добавь кнопку», «сделай так, чтобы форма отправляла письмо». Читать код полезно, но начать можно без этого — агент объясняет, что он сделал, если попросить объяснять простыми словами.

Мой компьютер потянет локальную нейросеть? Для маленькой модели нужно порядка 8–16 ГБ оперативной памяти, для средней — видеокарта с приличным объёмом памяти. Проверить бесплатно: поставьте Ollama, скачайте небольшую модель и задайте вопрос. Если ответ идёт по букве в секунду, берите облачный вариант.

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

Он работает без интернета? Только во втором варианте, когда модель скачана на компьютер. Если агент стоит локально, но обращается к облачной модели, без интернета он не ответит.

Чем это лучше обычного чата, если я делаю маленький сайт? Экономией на переносе. В чате вы копируете код туда-обратно и сами ищете, куда его вставить. Агент вставляет сам и сам проверяет, что страница открылась. На проекте из пары файлов разница небольшая, на десятке — принципиальная.

Сделайте сегодня один шаг: скопируйте папку проекта в запасное место, поставьте агента по варианту 1 и дайте ему первую маленькую задачу промптом-рамкой из этой статьи. Наш порядок сборки и список промптов для агента лежат в боте — напишите ему, пришлю карту и разберём, если застрянете на установке.