Ваш первый кодинг-агент: минимальная рабочая настройка

Почему это важно: кодинг-агент — это ИИ, который не только отвечает, но и действует: создаёт файлы, пишет код, проверяет свою работу и рассказывает, что получилось. Это как раз роль «исполнителя», в которой идет речь во втором уроке: работу отдать можно, а понимание — нет. Поэтому держимся подхода оракула из того же урока: агент делает, а решения и понимание остаются за вами. Дальше мы выполним простое практическое задание, которое делает что-то полезное: создадим небольшую веб-страницу, в отдельной папке, на вашем компьютере.

Выберите агента: три рабочих варианта

Один инструмент, одна команда, один вход в аккаунт — а какой именно инструмент, решаете вы. Все три делают одно и то же: читают папку, пишут файлы, выполняют команды и спрашивают разрешение перед рискованным действием. Разница — в том, во сколько обойдётся старт:

Все три работают в Windows, macOS и Linux и перед рискованным действием спрашивают разрешение. Именно поэтому с таким агентом справится и человек без технической подготовки.

Настройка шаг за шагом

Цикл, который вы только что запустили

Любой кодинг-агент работает одним и тем же циклом. Когда вы его знаете, всё становится предсказуемым:

Первый промпт (копируйте)

Сделай мне в этой папке небольшую личную страницу в файле index.html.

Обо мне: [имя, чем занимаетесь, один интересный факт]
На странице нужно: короткое вступление, 3 факта обо мне и моя почта [email].
Стиль: чистый и современный, тёмный фон, один акцентный цвет на твоё усмотрение.
Потом объясни мне в 3 предложениях, какие файлы ты создал и за что каждый отвечает.

Последний пункт — «объясни, что создал» — это снова подход оракула. Работу делает агент, понимание остаётся у вас.

Как выглядит первый сеанс

1$ claude --version
2x.y.z (Claude Code)
3 
4$ claude
5 
6> Сделай мне небольшую личную страницу в файле index.html.
7 
8● Создаю index.html...
9● Пишу HTML + CSS... готово.
10 
11Готово. Создано:
12- index.html (ваша страница: шапка, 3 факта, контакты)
13 
14Откройте файл в браузере, чтобы увидеть результат.
15 
16> сделай акцентный цвет красным вместо нынешнего
17● Обновляю index.html... готово. Акцентный цвет изменён на красный.
18 
19> /exit
20До встречи.

Обратите внимание на ритм: вы просите — агент делает — вы проверяете — уточняете. Десяток таких кругов, и у вас готовая страница и настоящий навык. Какой из трёх инструментов вы ни выбрали, запись выглядит так же: меняются только название программы и цвета.

Правила безопасной работы

• Одна папка — один проект. Запускайте агента только внутри свежей пустой папки. Не запускайте его в «Документах» и в корне диска. В отдельной папке весь эксперимент удаляется одним нажатием.

• Читайте, прежде чем одобрить. Перед значимыми действиями агент спрашивает разрешение. Этот диалог — не формальность, а ваш руль. Вот как он выглядит, чтобы вы встретили его уже подготовленными:

  Агент сначала спрашивает

  press the button below to send the first message

  sent to the modelnothing yet — every message is sent in full

  send next →↻ restart

  Нажимайте отправить → и смотрите на середину диалога: агент останавливается и спрашивает до того, как что-то тронуть, и пока вы не ответите, ничего не происходит — разрешение он просит и на действия вне своей папки, и на разрушительные действия внутри неё, как это удаление. Сравните два исхода: откажете — файлы останутся точно такими же; согласитесь — изменение применится. И присмотритесь к средней кнопке: «да, и больше не спрашивать» — это не то же самое, что «да». Это согласие плюс постоянное разрешение, поэтому следующее такое же действие пройдёт уже без вопроса. Соглашаться можно часто, а «больше не спрашивать» выбирайте только тогда, когда вас устроит, что об этом конкретном действии вас больше никогда не спросят.

• Результат не такой? Просто скажите. «Не хватает блока с почтой, добавь» — полноценная инструкция. Ни перезапуска, ни переустановки.

• Запутались? Выйдите и зайдите заново. Команда /exit (или Ctrl+D) закрывает агента; в некоторых инструментах это /quit или двойное Ctrl+C. Чтобы прервать его на середине работы, нажмите Ctrl+C: это отменяет текущее действие, а не выход из агента. В крайнем случае закройте окно терминала — ничего не потеряется.

• Упёрлись в лимит? Это условие тарифа, а не поломка. На бесплатном тарифе рано или поздно вы увидите «возвращайтесь позже» или получите модель поменьше в часы пик. Переключитесь на более лёгкую модель или подождите.

• Агент может ошибаться в собственной работе. Страница может не открыться, какой-то блок может отсутствовать. Это нормально и поправимо: опишите точный симптом или отправьте ему текст ошибки.

• Хотите продолжить? Логичный следующий шаг — бесплатно опубликовать эту страницу. Про это есть отдельная статья: Как создать сайт и разместить его бесплатно.

Итог

Один установленный инструмент, один вход, одна папка, один промпт — и вы уже не человек, который «не дружит с компьютером». Всё, что вы сделаете дальше, строится на том же цикле: опишите, одобрите, проверьте, уточните.