Пару месяцев назад один из участников корпоративного тренинга спросил: "Я технолог, мне 47, последний раз я программировал в институте на Паскале. Могу ли я собрать рабочий продукт с помощью AI?"

Через три дня он прислал ссылку на работающий калькулятор юнит-экономики. Не прототип в Figma. Работающий веб-сервис.

Это и есть реальность 2026 года. Кодинг-агенты размывают границу между "техническими" и "нетехническими" специалистами. Но чтобы эффективно работать с ними, нужно понимать базовые концепции. Без этого вы будете как водитель, который не знает, где у машины руль.

Локальное vs удалённое

Первое, что нужно усвоить. Локальное - это на вашем компьютере. Удалённое - в облаке.

Работаете над Google Doc без интернета на телефоне? Это локальная работа. Документ существует только на этом устройстве. Подключились к сети, сохранили в Google Drive - теперь у документа есть удалённое хранилище. Можете открыть его с компьютера.

Почему это важно для кодинг-агентов? Потому что они работают с файлами на вашем компьютере (локально), но могут отправлять код в облачные репозитории (удалённо). Путаница между этими понятиями - источник 80% проблем у новичков.

Терминал и команды

Терминал - это приложение, которое выполняет команды на вашем компьютере. Раньше нужно было знать точные команды: создать папку, переместить файл, запустить программу.

С кодинг-агентами это больше не требуется. Почти. Одну команду всё-таки стоит запомнить: cd (change directory - сменить директорию). Пишете cd /Users/ваше_имя/projects/мой_проект/ и запускаете агента уже внутри нужной папки.

Директория - это просто папка. Когда видите "создать директорию" - это значит создать папку. Путь (path) - это адрес файла в системе, как URL для сайта. /Users/shima/projects/bot/ - путь к папке bot. Символ ~/ - сокращение для домашней директории пользователя.

Что такое кодинг-агент

По сути это ChatGPT или Claude с суперспособностями. Та же языковая модель, которая понимает ваши запросы. Но с доступом к инструментам вашего компьютера.

Агент может читать и редактировать файлы. Запускать программы. Устанавливать зависимости. Тестировать код. Всё это он делает через тот самый терминал, о котором говорили выше.

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

Системные промпты и AGENTS.md

У каждого кодинг-агента есть системный промпт - базовые инструкции, которые определяют его поведение. Claude Code, Factory Droid, OpenAI Codex - у каждого свой набор правил.

Но вы можете добавить собственные инструкции. Для этого существует файл AGENTS.md (Claude Code использует CLAUDE.md). Это обычный текстовый файл в формате markdown, где вы пишете, что агент должен знать о вашем проекте.

Пример содержимого:

Я не технический специалист. Объясняй каждое действие простым языком.
Мы используем pnpm вместо npm.
Перед любыми изменениями делай коммит.

Агенты читают эти файлы иерархически. Если в папке components лежит свой AGENTS.md, агент прочитает его первым, потом поднимется к корневому файлу. Ближайшие инструкции имеют приоритет.

Skills - переиспользуемые воркфлоу

Skills - это отдельные файлы с инструкциями для конкретных задач.

Допустим, вы регулярно пишете посты для Telegram-канала. Создаёте skill с правилами: максимум 2000 знаков, никаких эмодзи в заголовках, всегда добавлять призыв к действию. Каждый раз, когда просите агента написать пост, он подтягивает эти инструкции автоматически.

В чём отличие от AGENTS.md? Skills загружаются по требованию, а не добавляются в контекст постоянно. Это экономит "память" агента.

Где хранятся skills? В скрытых папках (dot files). На Mac нажмите Command+Shift+. чтобы увидеть их. Путь выглядит примерно так: ~/.claude/skills/ или ~/.factory/skills/.

Контекстное окно и токены

У AI-моделей есть лимит памяти - контекстное окно. Измеряется в токенах. Один токен - примерно 4 символа или 3/4 слова. Модель с окном 100k может держать в памяти около 100 000 токенов одновременно.

Это критически важно понимать. Агент видит только то, что помещается в окно. Огромная кодовая база с сотнями файлов? Он не загрузит всё сразу. Будет читать нужные файлы, работать, потом "забывать" часть информации, чтобы освободить место для новой.

Если агент вдруг "забыл" что-то из начала разговора - это оно. Информация выпала из контекстного окна. Напомните или начните новую сессию.

Поэтому AGENTS.md должен быть сфокусированным. Поэтому skills выносятся в отдельные файлы. Вы управляете вниманием агента.

Git и контроль версий

Это самое важное, если собираетесь делать что-то серьёзное.

Git - система контроля версий. Сохранение работы, но с возможностью вернуться к любому предыдущему состоянию.

Commit (коммит) - снимок проекта в конкретный момент. "Вот так выглядит проект сейчас, я доволен, сохраняю чекпоинт". К каждому коммиту пишется сообщение: "добавил новый хедер", "исправил баг с авторизацией".

Branch (ветка) - параллельная версия проекта. Есть main - основная ветка, рабочая версия. Хотите поэкспериментировать? Создаёте новую ветку, делаете изменения. Получилось - сливаете (merge) обратно в main. Не получилось - удаляете ветку, ничего не сломано.

Push - отправка коммитов в облако (обычно GitHub). Pull - скачивание изменений из облака. Push = загрузить, Pull = скачать.

Repository (репозиторий, репо) - папка проекта с настроенным git. Когда говорят "склонируй репо" - значит скачай проект с GitHub на свой компьютер.

Агент делает всё это сам. Коммитит, пушит, создаёт ветки. Но он может спросить: "Закоммитить это?" И вы должны понимать, что он имеет в виду.

Переменные окружения и API-ключи

Это секреты, которые нужны коду для работы. Подключаетесь к Stripe или OpenAI - они дают вам API-ключ. Фактически пароль.

Писать пароль прямо в код - плохая идея. Если запушите в GitHub, все увидят ваш пароль.

Решение: файл .env. Туда записываете секреты:

OPENAI_API_KEY=sk-ваш_ключ_тут
DATABASE_URL=postgres://...

Код читает из этого файла. Сам файл никогда не пушится - есть .gitignore, который говорит git: "этот файл не трогай".

Когда разворачиваете проект на сервере (Vercel, Cloudflare), добавляете переменные окружения через их интерфейс. Локальный .env остаётся локальным.

Зависимости и пакетные менеджеры

Вы не пишете весь код с нуля. Используете готовые библиотеки (packages, dependencies). Хотите подключиться к базе данных - есть пакет. Отправить email - есть пакет.

Package manager (пакетный менеджер) управляет всем этим. JavaScript использует npm (Node Package Manager) или bun (быстрее). Python использует pip.

Когда клонируете проект, первое что делает агент - npm install или pip install. Смотрит файл package.json (JS) или requirements.txt (Python), скачивает все нужные пакеты. Они падают в папку node_modules (для JS) - там будут тысячи файлов. Это нормально. Не трогайте её.

Запуск проекта локально

Зависимости установлены, теперь запускаем. Тут появляется localhost - ваш компьютер притворяется веб-сервером.

Агент запускает сервер, вы открываете браузер, идёте на localhost:3000 (или другой порт). Видите свой проект. Работает. Но только на вашей машине - никто другой по этой ссылке ничего не увидит.

Порт - это как канал. Можете запустить один проект на 3000, другой на 3001. Не мешают друг другу.

Команда запуска обычно npm run dev или npm start. Агент разберётся. Пока сервер работает, изменения в коде подхватываются автоматически (hot reloading).

Деплой

Проект работает локально. Теперь хотите показать миру - нужен деплой.

Популярные платформы: Vercel (React, Next.js), Netlify (статика, простые приложения), Cloudflare (скорость, глобальное распространение). У всех есть CLI-инструменты, агент может деплоить за вас.

Говорите "задеплой на Vercel" - агент запускает Vercel CLI, отправляет код, даёт вам публичную ссылку.

Помните про переменные окружения. Локальный .env не деплоится. Все секреты добавляете в настройках платформы вручную. Работает локально, падает после деплоя? Первым делом проверяйте переменные окружения.

Чтение ошибок

Что-то сломается. Это нормально.

Терминал покажет ошибку. Красный текст, выглядит страшно. Но там полезная информация.

Ищите само сообщение об ошибке - обычно в начале или конце красного блока. "cannot find module", "undefined is not a function", "connection refused". Дальше идёт stack trace - путь к файлу и номер строки, где случилась проблема.

Хорошая новость: вам не нужно это понимать. Копируете ошибку, вставляете агенту, пишете "почини". Агент видел миллионы таких ошибок.

Со временем начнёте узнавать паттерны. ENOENT - файл не найден. ECONNREFUSED - не удалось подключиться (база данных не запущена?).

Есть ещё Chrome DevTools. Правый клик на странице -> Inspect -> Console. Там ошибки JavaScript. "Failed to fetch", "404 Not Found" - копируете, отдаёте агенту с контекстом: "вижу эту ошибку когда нажимаю кнопку отправить".

Застряли в цикле? Остановитесь

Типичная ситуация: что-то сломалось, говорите "почини", агент пробует, не работает, "всё ещё сломано", пробует ещё, не работает... Час прошёл, ничего не изменилось.

Что делать:

Закоммитьте работу. Перед охотой на баг сохраните всё, что сделали. Если станет хуже, откатитесь.
Начните новую сессию. Иногда контекст захламлён неудачными попытками. Чистый старт помогает.
Проверьте базовые вещи. .env на месте? Ключи правильные? Переменные добавлены на хостинге?
Обновите инструкции. Если одна и та же проблема повторяется, добавьте информацию в AGENTS.md.

Хороший подход: попросите агента сначала разобраться, а не сразу чинить. "Не исправляй пока. Расскажи, что, по-твоему, сломалось и почему". Если он начнёт менять код без понимания проблемы, может сделать хуже.

Цикл работы агента

Агент - это цикл: планирует, действует, наблюдает, повторяет.

Даёте задачу: "Сделай лендинг". Агент планирует: нужны такие-то файлы, такие-то зависимости. Действует: создаёт файлы, пишет код. Наблюдает: работает? Есть ошибки? И на основе наблюдений либо продолжает, либо исправляет.

Цикл идёт, пока задача не решена или агент не застрял. Застрял - спрашивает вас.

Уровни автономии

Разные агенты работают по-разному. Одни спрашивают разрешение на каждое действие: "Создать этот файл? Запустить эту команду?" Безопаснее, но медленнее.

Другие делают всё сами. Быстрее, но нужно доверие. Иногда уходят не туда, приходится возвращать.

Большинство агентов позволяют настроить баланс. "Спрашивай перед удалением файлов, но создавать можешь без спроса".

Я предпочитаю давать агенту работать и наблюдать. Если вижу что-то странное, вмешиваюсь. Но не одобряю каждый чих.

Это фундамент. Необязательно запоминать всё сразу. Начните строить что-то, пусть агент ведёт, и разберётесь в процессе. Лучший способ научиться - делать.

В AI Masters мы проводим практические тренинги, где участники без технического бэкграунда создают работающие продукты за несколько сессий. Теория нужна, но ничто не заменяет опыт.

Ссылки:

Кодинг-агенты для нетехнарей: всё, что нужно знать