Пошаговая сборка · ~15 мин

Объясни как пятилетнему

Любая сложная тема простыми словами — пока не щёлкнет.

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

ℹЧто у тебя будет в конце

Любая сложная тема простыми словами — пока не щёлкнет.

Сначала — как вообще говорить с агентом

  1. 1Описывай РЕЗУЛЬТАТ, а не технологию: что на экране, что делает каждая кнопка, что сохраняется. «Как» агент придумает сам.
  2. 2Будь конкретен про экраны и поля — «форма с суммой, категорией и датой» лучше, чем «дай добавлять траты».
  3. 3Проси сначала самую маленькую рабочую версию. Растишь её потом словами — это Шаг 2, а не первое сообщение.
  4. 4Реши, что ТВОЁ, а не агента: задай категории, цвета, правила. Не заставляй его угадывать то, что знаешь только ты.

Шаг 1 — Собери вживую

Как писать промпт под такой инструмент

  1. 1Для этой тетради зафиксируй ТРИ вещи: что хранит ОДНА запись (название темы, простое объяснение, которое щёлкнуло, несколько вопросов «проверь меня»), что показывает ГЛАВНЫЙ экран (список тем, метка уверенности зелёным/жёлтым/красным, поиск) и что по тапу на тему открывается объяснение плюс кнопка «проверь меня».
  2. 2Систему уверенности задай сам: три состояния — зелёный (твёрдо), жёлтый (шатко), красный (потерял) — которые ТЫ ставишь и меняешь тапом. Не давай Claude выдумывать пятизвёздочный рейтинг, которым ты не будешь пользоваться.
  3. 3Скажи, что проверка прогоняет твои вопросы ПО ОДНОМУ, а не все разом — это самопроверка, ты читаешь свой ответ в голове и идёшь дальше.
  4. 4Закончи так: «собери всё целиком, проверь, что работает, и скажи, как именно открыть».
Запусти Claude
claude

Открой терминал и запусти это (если Claude уже запущен — сначала набери /exit). Потом попроси его создать папку под этот проект и работать внутри неё.

Неправильный запрос против правильного
✕ что пишет большинство
you ▸ объясни мне всё
✓ что реально работает — скопируй или, ещё лучше, скажи СВОИМИ словами
you ▸ Собери мне тетрадь «объясни просто». Экран добавления, где я ввожу название темы, самое простое объяснение, которое наконец щёлкнуло, и несколько вопросов «проверь меня» по этой теме. На главном экране — список сохранённых тем с меткой «насколько уверен» зелёным/жёлтым/красным, которую можно менять, и строка поиска. По тапу на тему открывается её объяснение простыми словами и кнопка «проверь меня», которая прогоняет вопросы по одному. Всё сохраняется на моём устройстве, чистая читаемая тема. Собери всё целиком, проверь, что работает, и скажи точно, как открыть.
✦✦

Говори на СВОЁМ языке — русском, испанском, любом. Claude поймёт.

Собери прямо сейчас — отмечай по ходу

0/6

Шаг 2 — Собрано. Теперь сделай его своим

ℹClaude написал «открой localhost…» — и что дальше?

Не пугайся технической ссылки. Claude скажет одно из двух. Либо файл вроде index.html — найди его в папке проекта и открой двойным кликом, он откроется в браузере. Либо адрес, начинающийся с http://localhost — скопируй его в адресную строку браузера и нажми Enter. «localhost» просто значит «это работает прямо сейчас на твоём компьютере». Вот он, твой инструмент. Он настоящий.

Теперь докрути его под СЕБЯ — просто говори

Вот часть, которая делает его ТВОИМ. Не соглашайся на первую версию — меняй её, говоря, чего хочешь, прямо в том же чате. Claude пересобирает, ты обновляешь страницу. Доводи, пока не ляжет под то, как ты реально работаешь. Для этого инструмента попробуй, например:

you ▸ добавь кнопку, которая перепишет моё объяснение ещё проще, как для десятилетнего
you ▸ дай отмечать каждую тему зелёным / жёлтым / красным, чтобы видеть, что ещё хромает
you ▸ сгруппируй мои темы по предметам — «физика», «история»
✦Как я (Евгений) делаю это сам

Я не печатаю длинные сообщения. Я включаю голосовой ввод (микрофон в ChatGPT или в клавиатуре телефона) и просто НАГОВАРИВАЮ всё, что думаю про то, что он собрал — что не так, что хочу дальше, — потом выделить всё, скопировать и вставить весь поток в Claude Code. Сумбурные устные мысли отлично заходят — агент сам в них разберётся. Это в разы быстрее, чем писать.

Шаг 2.5 — Протестируй как настоящую вещь (с первого раза идеально не будет)

Правда, которую новичкам не говорят: первая сборка — это ЧЕРНОВИК. Агент что-то собрал, ты запустил, нашёл, что не так, сказал ему — и ВОТ этот цикл и есть работа. Код не читай. Пользуйся инструментом как посторонний и смотри, где он тебя подводит. Для этого инструмента проверь именно это:

  1. 1Открой (Claude даст ссылку localhost или файл index — см. Шаг 2) и добавь две темы, у каждой объяснение и пара вопросов для проверки.
  2. 2На главном экране смени метку одной темы с красной на зелёную тапом. Цвет реально меняется и держится?
  3. 3Набери часть названия темы в поиске — список сужается до неё? Пустой или не меняющийся список значит, что поиск не подключён.
  4. 4Открой тему и нажми «проверь меня»: вопросы идут по одному и можно перейти к следующему? Если вываливаются все разом или останавливается после первого — это твоя правка.
  5. 5Обнови страницу (F5 / Cmd-R). Обе темы, их объяснения и цветные метки на месте? Если исчезли — «хранение на устройстве» не подключено, чини это.

Нашёл косяк? Скажи вот так

Ты ничего не чинишь сам — ты ОПИСЫВАЕШЬ словами, что не так, и агент чинит. Будь конкретен: что увидел против того, что ожидал. Реальные примеры для этого инструмента:

you ▸ «цветная метка темы не сохраняется после обновления — сохраняй метку вместе с темой на моём устройстве»
you ▸ «кнопка проверь меня показывает все вопросы сразу — показывай по одному, с кнопкой «дальше»»
you ▸ «поиск не фильтрует темы — пусть совпадает по мере набора и прячет те, что не подходят»

Не останавливайся на v1 — развивай

Инструмент, собранный за десять минут, — это старт, а не финиш. Затягивает тех, кто продолжает говорить «а теперь ещё…». Каждая строка ниже — одно предложение, которое ты вставляешь в тот же чат, чтобы прокачать инструмент:

you ▸ «добавь кнопку, которая перепишет моё объяснение ещё проще, как для десятилетнего» — когда твоя формулировка всё ещё корявая, это её расклинивает.
you ▸ «сгруппируй темы по предметам — «физика», «история»» — после десятка тем плоский список быстро превращается в кашу.
you ▸ «покажи в один тап только мои красные и жёлтые темы» — сразу к тому, что не освоил, без прокрутки.
you ▸ «после проверки дай поднять цвет темы по тому, как прошло» — замыкает круг, чтобы метки оставались честными.

Шаг 3 — Подключи к миру (по желанию)

Бесплатные данные и API под это

API — это просто способ для инструмента подтянуть внешние данные или что-то отправить наружу; многие бесплатны. Искать их самому почти не нужно; приём, который работает для ЛЮБОЙ идеи, — попросить агента найти их:

  1. 1Для старта внешний API НЕ нужен — темы, объяснения, метки и проверки работают локально, на твоём устройстве.
  2. 2Хочешь черновик объяснения для правки вместо чистого листа? Для этого нужен ИИ-сервис (Claude или OpenAI): вводишь тему, получаешь черновик простыми словами, потом переписываешь своими — оплата по факту, отдельно от чата, в котором собираешь.
  3. 3Универсальный приём для ЛЮБОЙ идеи: спроси Claude — «найди бесплатные или открытые API под тетрадь «объясни просто» и скажи, каким реально нужен ключ». Он перечислит — ты выберешь.

Про оплату ИИ-частей

  1. 1Собирать инструмент в Claude Code можно по подписке Claude (Pro, Max, Team или Enterprise) в пределах её лимитов.
  2. 2Если готовый инструмент сам должен обращаться к Claude (например, писать для тебя тексты), ему нужен отдельный API-ключ из Claude Console, и это оплачивается отдельно, по факту использования.
  3. 3Цены меняются; перед тем как запускать что-то частое, загляни на claude.com/pricing.

Инструмент получает суперсилу, когда умеет общаться с другими сервисами — прислать тебе сообщение, прочитать таблицу, подтянуть живые данные. Каждый сервис выдаёт «API-ключ» (длинный пароль, который говорит «это я»). Для ЭТОГО инструмента полезны:

Какие ключи может использовать этот инструмент

  1. 1ИИ-сервис (Claude или OpenAI) — ввести тему и получить черновик объяснения простыми словами, а потом переписать своими (оплата по факту, отдельно от чата, в котором собираешь)

Ключ почти везде берётся одинаково: зайти в сервис → Настройки → «API» или «Для разработчиков» → «Создать ключ» → скопировать. Потом попроси Claude: «создай файл .env с пустым местом для этого ключа и проверь, что .env есть в .gitignore», и вставь ключ в этот файл сам. В чат ключ не пиши.

Шаг 4 — Выложи в интернет (только если нужен кому-то ещё)

ℹШаг 4 — Выложи в интернет (только если нужен кому-то ещё)

Только для себя, на своём компьютере? Тогда ты уже закончил — пропусти этот шаг со спокойной совестью. Выкладывай в интернет, только если его должен открывать кто-то ДРУГОЙ или ты хочешь заходить с телефона вне дома.

Шаг 6 — Будь в безопасности (две простые привычки)

  1. 1Делай бэкап того, что жалко потерять. Если инструмент хранит реальные данные (бюджет, дневник здоровья, список клиентов), сразу попроси Claude: «добавь кнопку экспорта/бэкапа» — один клик сохраняет данные в файл. Сделай это до того, как пересоберёшь с нуля или перенесёшь папку.
  2. 2Не давай Claude ключи от опасных комнат. Держи его в папке этого проекта. Никогда не подключай учебный проект к банку, крипте или чему-то необратимому. Чеки и календари — да. Сбережения — нет.
  3. 3Думай, прежде чем просить. Claude делает то, что ты говоришь, в той папке, где вы находитесь. «Оптимизируй мои фото» — оптимизирует, а не удалит — если только ты не попросишь что-то безрассудное. Здравые просьбы, чистое рабочее место — и бояться просто нечего.

Ошибки, на которых останавливается большинство

  1. 1Просить расплывчатое («сделай мне приложение») и получать расплывчатое. Назови экраны, кнопки, что сохраняется.
  2. 2Запихивать десять функций сразу. Сначала попроси крошечную работающую версию — потом наращивай дозапросами.
  3. 3Останавливаться на первой ошибке. Ошибка — не провал: вставь её Claude или опиши, что видишь, и он починит. Этот цикл и ЕСТЬ работа.
  4. 4Решить, что «сначала надо выучить программирование». Тебе не нужно понимать код, который пишет Claude. Тебе нужно описать результат.
  5. 5Не сказать, что значит «готово». Закончи запрос тем, как ты проверишь результат, например: «готово, когда я добавляю пункт и он остаётся после перезагрузки страницы».
  6. 6Строить для воображаемой аудитории. Строй версию, которую ТЫ откроешь завтра. Не полируй — пользуйся сразу.
!Если что-то сломалось

Нормально. Скажи Claude, что не так, обычными словами («кнопка ничего не делает», «страница пустая») или вставь красный текст ошибки. Он найдёт и починит. Ты проверишь. Повторяй, пока не заработает.

checkpoint

Всё. Ты собрал настоящий инструмент.

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