Как писать промпты для Claude Code: чек-лист начинающего

Если вы только начинаете работать с Claude Code, главный сюрприз ждёт вас не в терминале и не в коде, а в том, как вы формулируете задачи. Claude — не телепат. Он не знает, что вы имели в виду, пока вы не сказали это словами. И именно от качества ваших слов зависит, получите ли вы готовый результат за пять минут или будете тратить вечер на переделки.

Дальше — о том, как писать промпты для Claude Code так, чтобы ассистент делал именно то, что нужно. Без магии, без секретных слов и без требования «просто сделай красиво». Только простая формула, проверенные шаблоны и честные примеры ошибок. Если Claude Code ещё не установлен, начните со статьи Как установить Claude Code на Windows, в VS Code и терминал — а если хочется сначала понять, что это за инструмент, — с обзора Что такое Claude Code: как установить и пользоваться.

Что такое промпт и почему он важен

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

Промпт — это не заклинание. Это техническая задача, переданная естественным языком. Чем точнее вы описываете задачу, тем точнее Claude её выполнит. Чем больше вы умалчиваете, тем больше Claude вынужден додумывать за вас. А додуманное редко совпадает с вашими ожиданиями.

Представьте, что вы нанимаете помощника на кухне. Если вы скажете «приготовь ужин», результат может вас расстроить. Если вы скажете «приготовь ужин на двоих: курицу с картошкой в духовке, без острого, готово к семи вечера», вероятность успеха резко вырастет. С Claude Code то же самое. Вы не пишете код руками, но вы управляете процессом словами.

Формула хорошего промпта

Хороший промпт можно собрать по простой формуле: что + контекст + детали + критерий. Разберём каждую часть.

Что

В начале промпта чётко скажите, что вы хотите получить. Claude должен понимать конечную цель с первых строк.

Хорошие открытия звучат так:

• Создай страницу входа с полями email и пароль.
• Добавь счётчик символов в форму обратной связи.
• Исправь ошибку, из-за которой кнопка не нажимается на мобильном.

Плохие открытия оставляют цель туманной:

• Сделай красиво.
• Тут что-то не работает.
• Давай улучшим форму.

Слово «красиво» не имеет смысла для Claude. Для кого-то красиво — это чёрный фон и неоновые буквы, для кого-то — пастельные оттенки и много воздуха. Указывайте конкретику.

Контекст

Контекст — это информация, которая помогает Claude понять, в каком проекте он работает. Без контекста Claude будет действовать вслепую и может предложить решение, которое не подходит вашему стеку.

Включайте в контекст:

• На чём написан проект: HTML/CSS/JS, React, Next.js, Vue или что-то другое.
• Где находятся нужные файлы.
• Какие библиотеки уже используются.
• Какая часть проекта уже работает, а что ещё нужно добавить.

Пример хорошего контекста:

Детали

Детали превращают общую задачу в конкретную инструкцию. Здесь вы описываете:

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

Пример деталей:

Критерий

Критерий — это способ понять, что задача выполнена. Claude лучше работает, когда знает, по каким признакам вы будете принимать результат.

Примеры критериев:

• После нажатия на кнопку форма не перезагружается, появляется сообщение об успехе.
• Страница корректно отображается в Chrome и Safari.
• Код не использует внешних библиотек, только чистый JavaScript.
• Решение занимает не больше одного файла.

Критерий помогает Claude выбирать между несколькими вариантами решения. Если вы не укажете критерий, Claude выберет самый очевидный для него вариант, а не для вас.

Примеры плохо и хорошо

Пример 1: кнопка

Плохо:

Что значит «лучше»? Больше? Синее? С тенью? С анимацией? Claude не знает.

Хорошо:

Пример 2: исправление ошибки

Плохо:

Без текста ошибки, без файла, без контекста Claude не сможет помочь.

Хорошо:

Пример 3: новая функция

Плохо:

Это огромная задача. У Claude нет шансов угадать, какой механизм вам нужен.

Хорошо:

Правило одна правка — один запрос

Одна из самых распространённых ошибок начинающих — пытаться запихнуть в один промпт сразу пять разных задач. Например:

Claude может попытаться сделать всё сразу, но результат будет хуже, чем если бы вы разбили задачи. Каждое изменение добавляет шанс что-то сломать. Чем больше изменений в одном запросе, тем сложнее понять, что именно пошло не так, если что-то сломается.

Лучше двигаться маленькими шагами:

1. Сделай шапку сайта с логотипом и ссылками.
2. Теперь добавь форму подписки в подвал.
3. Поменяй цвета в подвале на те, что в моём брендбуке.
4. Подключи шрифт Inter из Google Fonts.
5. Оптимизируй загрузку изображений.

Между шагами проверяйте результат. Если Claude сделал не так, как вы хотели, поправьте его сразу, прежде чем идти дальше. Это правило «одна правка — один запрос» экономит часы.

Частые ошибки в промптах

1. Недостаточно конкретики

Самая частая ошибка — слишком общие формулировки. «Сделай нормально», «давай по-другому», «что-то не то» — это не задачи, это эмоции. Claude не умеет читать эмоции, он читает слова.

Как исправить: перепишите запрос, используя формулу «что + контекст + детали + критерий». Даже если получится длинно, это лучше, чем неопределённость.

2. Пропуск контекста

Люди часто забывают сказать, в каком проекте они работают. Claude не знает, используете ли вы React или обычный HTML, пока вы не скажете. В лучшем случае он спросит уточняющие вопросы. В худшем — сделает предположение и выберет неправильный путь.

Как исправить: начинайте промпт с краткого описания проекта. Даже одного предложения часто достаточно: «Проект на Next.js 14, Tailwind CSS, файлы в папке app».

3. Смешивание нескольких задач

Когда в одном сообщении несколько разных задач, Claude может выполнить их неравномерно: сделает одну хорошо, вторую средне, третью забудет. Или выполнит всё в неправильном порядке.

Как исправить: разбейте задачу на части и задавайте их по очереди. Если нужно, создайте себе небольшой план в отдельном файле и покажите его Claude.

4. Отсутствие критерия готовности

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

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

5. Использование жаргона, который Claude может понять иначе

Некоторые слова в разработке имеют несколько значений. «Модуль», «компонент», «библиотека», «фреймворк» — Claude поймёт их, но может интерпретировать по-своему, если контекст неясен.

Как исправить: уточняйте значения. Вместо «сделай компонент» лучше сказать «создай React-компонент кнопки в файле components/Button.jsx».

Готовые шаблоны промптов

Вот несколько шаблонов, которые вы можете копировать и адаптировать под свои задачи.

Шаблон 1: создание новой функции

Создай [что] в проекте [название/стек].

Контекст:
- Проект на [React/Next.js/Vue/HTML].
- Нужный файл: [путь].
- Рядом уже есть [что уже работает].

Требования:
- [деталь 1]
- [деталь 2]
- [деталь 3]

Критерий готовности:
- [как проверить результат]

Шаблон 2: исправление ошибки

В проекте [стек] возникает ошибка.

Текст ошибки:
"[полный текст ошибки]"

Когда возникает:
- [шаг 1]
- [шаг 2]
- [шаг 3]

Что я уже пробовал:
- [попытка 1]
- [попытка 2]

Нужно:
- Найти причину ошибки и исправить её.
- Проверить, что после исправления [что должно работать].

Шаблон 3: улучшение интерфейса

Улучши интерфейс [элемента] в файле [путь].

Что сейчас:
- [краткое описание текущего состояния]

Что нужно:
- [изменение 1]
- [изменение 2]
- [изменение 3]

Ограничения:
- [не используй внешние библиотеки / не меняй структуру HTML / сохрани существующие классы и т.д.]

Результат:
- [как должно выглядеть в браузере]

Шаблон 4: рефакторинг кода

Отрефактори код в файле [путь].

Что нужно улучшить:
- [дублирование / читаемость / производительность / что-то ещё]

Что нельзя менять:
- [поведение / внешний вид / публичное API]

После рефакторинга:
- [критерий: код проходит тесты / выглядит так же / работает быстрее]

Шаблон 5: объяснение кода

Объясни, как работает этот участок кода:

```[вставь код]```

Я новичок, поэтому объясни простыми словами:
- что делает каждая часть;
- зачем это нужно;
- что будет, если убрать [конкретную строку].

Как работать с Claude Code пошагово

Claude Code — это не просто чат, а инструмент, который может редактировать файлы, запускать команды и проверять результат. Чтобы получать от него максимум, полезно выстроить рабочий ритм.

Шаг 1. Опишите задачу целиком

Перед тем как просить что-то сделать, сформулируйте задачу для себя. Что должно измениться? Почему это важно? Как вы поймёте, что всё готово? Когда вы сами понимаете ответы на эти вопросы, написать промпт становится легче.

Шаг 2. Дайте Claude контекст

Скажите, в каком проекте вы работаете, какие файлы важны, какие технологии используются. Если у вас есть примеры похожих решений, покажите их.

Шаг 3. Попросите сделать первую версию

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

Шаг 4. Проверьте результат

После каждого изменения проверяйте, что получилось. Запускайте проект, открывайте в браузере, смотрите в терминал. Если Claude сказал, что всё работает, лучше перепроверить.

Шаг 5. Правьте маленькими порциями

Если что-то не так, напишите конкретную правку: «Кнопка слишком широкая на телефоне. Сделай её шириной 100% только на экранах уже 600 пикселей». Не пишите «плохо, переделай».

Шаг 6. Завершайте с критерием

Когда результат вас устраивает, попросите Claude сделать финальную проверку: «Проверь, что все изменения работают вместе, и что в консоли браузера нет ошибок».

Как Claude Code читает ваши промпты

Не обязательно понимать внутреннее устройство Claude, но полезно знать несколько вещей.

Во-первых, Claude работает с тем, что видит. Если вы не показали ему файл, он не знает его содержимого. В Claude Code он обычно видит файлы проекта, но не всегда понимает, какие из них важны для текущей задачи. Указывайте пути явно.

Во-вторых, Claude лучше понимает структурированный текст. Списки, разделы, шаги, примеры — всё это помогает. Сплошная простыня текста без абзацев усложняет задачу.

В-третьих, Claude может ошибаться. Он не всегда знает последние версии библиотек, не всегда угадывает ваши предпочтения и иногда предлагает решения, которые технически работают, но не подходят вам. Поэтому проверка — ваша ответственность.

В-четвёртых, Claude умеет задавать уточняющие вопросы. Если он спрашивает что-то, не игнорируйте вопрос. Часто это означает, что в вашем промпте не хватает контекста, и Claude пытается его получить, прежде чем делать работу.

Как работать с большими проектами

Когда проект растёт, одного промпта становится недостаточно. Файлов много, связей между ними много, и Claude может потеряться. Вот несколько приёмов, которые помогают сохранять контроль.

Делите проект на модули

Представьте проект как набор независимых частей: шапка, подвал, форма, страница профиля, страница оплаты. Каждая часть — отдельная задача для Claude. Так проще проверять результат и не ломать уже работающее.

Используйте файл плана

Создайте файл plan.md или todo.md в корне проекта. Опишите в нём этапы работы. Покажите этот файл Claude и попросите действовать по плану. Это помогает вам обоим не сбиваться с курса.

Пример содержимого plan.md:

# План разработки лендинга

1. Создать базовую структуру HTML и подключить шрифты.
2. Сверстать шапку с логотипом и навигацией.
3. Сверстать блок hero с заголовком и кнопкой.
4. Добавить блок с преимуществами.
5. Добавить форму подписки с проверкой email.
6. Сверстать подвал.
7. Адаптировать под мобильные устройства.
8. Проверить в браузере и исправить ошибки.

Показывайте связанные файлы

Если вы просите Claude изменить компонент кнопки, укажите, где он используется. Например: «Компонент Button.jsx используется на страницах Login.jsx и Register.jsx. После изменений проверь, что на обеих страницах кнопка выглядит корректно».

Не меняйте слишком много за раз

В большом проекте риск сломать что-то растёт. Делайте маленькие коммиты, часто проверяйте результат и откатывайтесь назад, если что-то пошло не так. Claude поможет с командами Git, если вы попросите.

Практические советы по стилю промптов

Пишите простыми предложениями

Не нужно пытаться звучать технически. Пишите так, как объясняли бы задачу человеку. «Сделай так, чтобы при нажатии на кнопку открывалось меню» — это отличный промпт.

Используйте списки

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

Приводите примеры

Если вы можете показать, как должно выглядеть решение, покажите. Скриншот, ссылка на похожий сайт, пример кода — всё это помогает Claude понять ваш вкус.

Указывайте ограничения

Если важно не использовать что-то, скажите об этом заранее. Например: «Не подключай jQuery, используй только чистый JavaScript» или «Не меняй существующую структуру HTML».

Не бойтесь длинных промптов

Хороший промпт часто длиннее плохого. Это нормально. Лучше написать подробное описание и получить результат с первого раза, чем экономить на словах и тратить время на переделки.

Примеры промптов для разных ситуаций

Создание страницы

Добавление анимации

Работа с формой

Подключение API

Исправление вёрстки

Написание тестов

Рефакторинг старого кода

Добавление адаптивности

Интеграция с внешним сервисом

Как учиться на своих ошибках

С первого раза идеальные промпты почти никто не пишет. Это нормально. Главное — обращать внимание на паттерны.

Если Claude часто не понимает вас, скорее всего, вы недостаточно конкретны. Если Claude делает слишком много или слишком мало, скорее всего, вы смешиваете задачи или не указываете критерий. Если Claude спрашивает много уточнений, значит, в ваших промптах не хватает контекста.

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

Чек-лист хорошего промпта

Перед отправкой промпта проверьте его по этому списку:

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

Мостик к практикуму

Умение писать хорошие промпты — это главный навык в работе с Claude Code. Именно он отличает человека, который тратит вечер на правки, от человека, который за полчаса получает готовый результат. Но писать промпты — это только половина дела. Вторая половина — понимать, как устроен процесс создания приложения от идеи до публикации.

Если вы хотите пройти этот путь пошагово и научиться ставить задачи Claude так, чтобы он собирал ваши собственные проекты, присоединяйтесь к практикуму «Путь к миллиарду». Там мы не заставляем вас запоминать код. Мы учим формулировать задачи, проверять результат и двигаться к готовому продукту маленькими шагами.

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