Пошаговая сборка · выходные

Помощник по налогам и документам

Собирает и сортирует документы и делает за тебя скучные расчёты.

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

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

Собирает и сортирует документы и делает за тебя скучные расчёты.

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

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

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

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

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

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

Неправильный запрос против правильного
✕ что пишет большинство
you ▸ сделай за меня налоги
✓ что реально работает — скопируй или, ещё лучше, скажи СВОИМИ словами
you ▸ Собери мне органайзер документов к налоговому сезону. Чек-лист нужных документов (2-НДФЛ, справки о доходах, чеки на вычеты, проценты по ипотеке и строки, которые я добавляю сам), где я отмечаю каждый как собранный и прикладываю заметку и сумму. Приложение группирует документы по категориям (доходы, вычеты, пожертвования) и складывает суммы по каждой категории плюс общий итог. Строка прогресса показывает, сколько документов я ещё не отметил, и можно видеть прошлогодние итоги рядом с этими. Всё сохраняется на моём устройстве, аккуратный читаемый вид. Собери всё целиком, проверь, что работает, и скажи, как именно открыть.
✦✦

Говори на СВОЁМ языке — русском, испанском, любом. 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Обнови страницу (F5 / Cmd-R). Галочки, заметки и суммы на месте? Если исчезли — «хранение на устройстве» не подключено, чини это.
  5. 5Добавь свою строку. Она должна попасть в нужную группу и войти в её итог.

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

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

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

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

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

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

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

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

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

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

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

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

Этому инструменту ключи не нужны — он целиком работает на твоём компьютере. Добавишь ключ только если позже захочешь, чтобы он тянулся к какому-то сервису.

Шаг 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 его собрал, а ты сам проверил. Это и есть весь круг, и для больших инструментов он такой же.