Claude и Codex помогают превратить идею в цифровой проект. Но результат зависит от того, насколько точно вы ставите задачу и как проверяете созданное. За красивым скриншотом может скрываться неработающая форма. Приложение, которое запускается на компьютере, может раскрывать лишние данные или ошибаться в расчётах. Поэтому обучение работе с ИИ обязательно включает проверку результата.
В этом руководстве разберём демонстрационный проект: простой калькулятор стоимости услуги. Пройдём путь от постановки задачи и подготовки контекста до разработки, проверки и публикации. Именно такой последовательности посвящён курс Claude & Codex AI. Его цель — научить создавать цифровые продукты для бизнеса так, чтобы каждый шаг был понятен и его можно было повторить самостоятельно.
Выбирайте небольшой продукт с четкой функцией
«Хочу полноценную платформу для своего бизнеса» — слишком широкая задача для первого упражнения. Такая платформа может включать сайт, учётные записи, платежи, CRM и отчёты. У каждого элемента свои особенности. Калькулятор стоимости одной услуги гораздо проще описать и проверить: пользователь вводит несколько значений и получает результат с понятным объяснением расчёта.
Например, калькулятор может оценивать стоимость по площади и виду работ. Формулу должна предоставить компания: помощнику не следует придумывать её самостоятельно. Если окончательная цена определяется после осмотра специалистом, об этом нужно прямо сказать в интерфейсе. Цифровой продукт не должен обещать точность, которой нет в реальном рабочем процессе.
Напишите то, чего нет в первой версии: никаких платежей, никакой учетной записи пользователя и никакого сохранения личных данных. Эти ограничения не уменьшают ценность упражнения. Они позволяют вам проверить всю функцию перед добавлением новых обязанностей и отделить логические ошибки от проблем интеграции.
Поймите роль ассистента и свою роль
Чат-ассистент помогает сформулировать идею и разобраться в понятиях. Инструмент для работы с кодом, в зависимости от среды и выданных разрешений, может читать файлы, менять проект и запускать проверки. Не стоит считать, что у всех продуктов с обозначением «ИИ» одинаковые возможности или одинаковый доступ к вашему компьютеру. Сначала разберитесь, что умеет выбранный инструмент.
Codex представлен OpenAI как инструмент для работы с кодом, а в документации Claude Code особое внимание уделяется контексту и проверке. Для обучающегося полезным вопросом является то, что инструмент может делать в конкретной среде и какие доказательства он может предоставить о том, что задача выполнена.
Ваша задача — определить цель, подтвердить правила бизнеса и оценить, решает ли продукт нужную задачу. ИИ может предложить технический подход, но он не знает ваши тарифы, договорённости с клиентами и исключения из обычного порядка работы. Эти сведения нужно сообщить явно, а затем проверить, правильно ли они учтены в реализации.
Хороший бриф также содержит критерии приемки.
Опишите пользователя, его действие и ожидаемый результат. В нашем примере человек выбирает вид работ, вводит площадь и видит формулу, примерную сумму и кнопку связи. Укажите язык, валюту, допустимые значения и сообщения об ошибках. Если дизайн уже утверждён, отдельно перечислите элементы, которые требуется сохранить.
Добавьте проверяемые условия. При площади в десять единиц и учебном тарифе в двадцать денежных единиц результат должен равняться двумстам. Отрицательную площадь нужно отклонить, а пустое поле нельзя считать корректной заявкой. Такие примеры превращают расплывчатое пожелание в задачу, для которой можно однозначно проверить правильность результата.
Это отправная точка, а не универсальная подсказка. Дополните его реальными правилами проекта. Более длинное требование не означает автоматически лучшее; актуальная информация и отсутствие противоречий имеют большее значение, чем объем.
Дайте нужный контекст, сохраняя ясные границы задачи
Если проект уже существует, сначала попросите определить нужную страницу и связанные компоненты. Изменение калькулятора не должно превращаться в переделку всего сайта. Укажите границы работы и покажите пример оформления, которому нужно следовать. Визуальные ориентиры и существующие правила помогают избежать лишних догадок и сохранить целостность проекта.
Зафиксируйте команды запуска, важные части структуры и уже принятые решения. Если в проекте есть библиотека кнопок или общая функция форматирования цен, помощник должен их найти и использовать. Создание дубликатов может привести к разному поведению страниц и лишней работе при дальнейшем сопровождении сайта.
Не отправляйте весь архив компании для объяснения одной функции. Используйте демо-данные и удалите ненужную информацию. Для нашего примера достаточно формулы и нескольких тестовых примеров; Фактический список клиентов не помогает построить интерфейс.
Работайте поэтапно, принося видимые результаты.
На первом этапе можно создать внешний вид калькулятора без подключения сторонних сервисов. На втором — добавить формулу и проверку полей. На третьем — кнопку связи и версию для предварительного просмотра. Каждый этап должен давать результат, который можно открыть и проверить, а не только список изменённых файлов.
Не судите исключительно по заявлению «Я закончил». Попросите посмотреть, что изменилось и как это проверялось. В документации Claude Code рекомендуется указывать критерии, которые может проверить инструмент. Для новичка это означает просто: требуются конкретные примеры входных данных и ожидаемых результатов.
Когда что-то не работает, опишите воспроизводимую проблему: что вы набирали, что нажимали, что отображалось и что должно было произойти. «Это не работает» оставляет слишком много интерпретаций. Точное наблюдение ускоряет исправление и учит отличать ошибку расчета от ошибки представления.
Проверьте и расчёты, и работу в браузере
Успешная сборка показывает, что проект прошел определенный набор технических проверок. Это не доказывает, что каждое взаимодействие правильно для пользователя. Откройте калькулятор, заполните поля и сравните результат с самостоятельным расчетом. Повторите действия для предельных значений и недопустимых ситуаций.
| Scenariu | Что необходимо соблюдать |
|---|---|
| Поля заполнены правильно | Формула и сумма соответствуют правилам |
| Отсутствует или отрицательное значение | Явная ошибка, нет вводящего в заблуждение результата |
| Узкий экран | Видимый текст и кнопки без перекрытия |
| Использование с клавиатуры | Порядок навигации и видимый фокус |
Обратите внимание и на сообщения. Если сумма предварительная, это должно быть указано рядом с ней, а не спрятано в другом разделе. Если кнопка открывает WhatsApp, проверьте номер и подготовленный текст. Небольшой продукт удобно проверить целиком именно потому, что первая версия имеет чёткие и ограниченные функции.
Данные и разрешения являются частью дизайна продукта.
С самого начала определите, какие данные нужны. Для демонстрационного расчёта могут не понадобиться имя, телефон или адрес. Если позже появится отправка заявки, у каждого поля должны быть понятные назначение и получатель. Сбор сведений «на всякий случай» усложняет проект, не делая его автоматически полезнее для пользователя.
Ключи API и данные доступа должны оставаться секретными. Их нельзя помещать в код, отправляемый браузеру, или в публичные записи. Разделяйте тестовую и рабочую среду, а инструментам предоставляйте только необходимый доступ. Разрешение прочитать один файл не означает разрешения опубликовать весь проект или передать его содержимое стороннему сервису.
Подключая внешний сервис, проверьте также ситуацию, когда он не отвечает. Интерфейс должен понятно объяснить ошибку и по возможности сохранить уже введённые значения. Сообщение об успехе без подтверждённой отправки — ошибка продукта, даже если сама страница выглядит безупречно. Проверяйте поведение при сбоях так же внимательно, как успешный сценарий.
Сохраняйте версии и публикуйте их контролируемым образом.
Перед важными изменениями сохраняйте проверенную версию проекта. История изменений помогает понять, что именно было сделано, и вернуться к рабочему состоянию, если возникла проблема. Одного скриншота недостаточно: необходимо сохранять исходные файлы, из которых состоит продукт, и понимать, какая версия действительно прошла проверку.
Сначала опубликуйте проект по адресу предварительного просмотра и повторите проверки там. Приложение может работать локально, но вести себя иначе после публикации из-за настроек среды. Проверьте адреса, необходимые переменные и подключения к внешним сервисам. Только после этого обновляйте версию по адресу, которым пользуются клиенты.
После публикации сохраните краткое описание выполненных проверок и известных ограничений. Например: калькулятор оценивает одну услугу, не сохраняет заявки и открывает WhatsApp для уточнения стоимости. Эта запись поможет тому, кто продолжит работу над проектом, и не даст принять демонстрационную функцию за полноценную систему оформления и обработки заказов.
Используйте ИИ для изучения решений, а не только команд
Попросите объяснить изменение простым языком: почему происходит проверка, почему формула вычисляется в определенном месте и что происходит, когда данные отсутствуют. Тогда попробуйте объяснить то же самое сами. Если вы можете только повторить команду, но не можете описать результат, навык все еще хрупкий.
Ведите дневник решений и примеров. Для каждой решенной проблемы запишите симптом, выявленную причину и окончательную проверку. Этот журнал может стать более ценным, чем набор подсказок, поскольку он фиксирует контекст, в котором было найдено решение.
Работа с ИИ естественно дополняет дизайн и разработку сайта и создание интернет-магазина. Принцип остаётся тем же: продукт должен решать конкретную задачу и корректно работать в важных сценариях. Быстрая генерация кода не заменяет ответственности за то, что в итоге получает пользователь.
Упражнение: от брифа до проверенной демонстрации
Создайте описанный калькулятор на основе учебной формулы и вымышленных данных. Ещё до просмотра кода подготовьте пять примеров расчёта и две ситуации с ошибочными значениями. Сформулируйте задачу, проследите за разработкой и сравните результат с этими примерами. Тогда проверка будет независимой, а не повторит предположения, на которых помощник построил своё решение.
В конце покажите продукт человеку, который не участвовал в разработке. Объясните задачу, продемонстрируйте правильный расчёт, корректную обработку ошибки и работу на телефоне. Запишите, что уже реализовано, а что требует отдельного этапа. Так у вас получится небольшой законченный проект, устройство и ограничения которого вы можете уверенно объяснить.
Курс Claude & Codex AI даёт основу для такой практики, а индивидуальное менторство позволяет начать с вашей задачи. Полезный навык заключается не в слепой передаче всей работы инструменту, а в умении проектировать, проверять и улучшать цифровые продукты, в которых вы действительно разбираетесь.
