Три месяца я использовал Claude неправильно. Вот как надо.

Yevhenii Rozov · 2026-05-17

14 ноября, 2 часа ночи. Дедлайн через 6 часов, 40 эндпоинтов без документации, американский клиент ждёт к утру.

Я скопировал код, бросил в Claude и написал "напиши документацию". Получил текст. Отправил клиенту.

Клиент отклонил.

---

Три часа переписывал то, что должно было занять двенадцать минут

Текст был технически правильным. Там было всё - параметры, форматы, примеры запросов. Но он был ни для кого. Такое ощущение, что его написал человек, который никогда не читал документацию и никогда ею не пользовался.

Я переписывал вручную до пяти утра. Сдал. Потерял $200 на правках, которые не были заложены в бюджет.

И самое обидное - я тогда не понял почему это произошло. Списал на "ну Claude иногда так выдаёт". Продолжил работать так же.

Это продолжалось три месяца. Я использовал Claude как умный поиск - бросал запрос, получал что-то, переделывал руками. Иногда выходило хорошо, чаще - средне. Я думал, это потолок инструмента.

Потолок был не у инструмента.

Я делал одно и то же на каждом проекте: давал задачу без контекста. "Напиши письмо клиенту". "Сделай код-ревью". "Придумай название для функции". Claude отвечал - и я получал что-то усреднённое, что подошло бы любому, значит не подходило конкретно мне.

Это как попросить незнакомца на улице написать письмо вашему боссу, не объяснив ни кто ваш босс, ни в чём проблема, ни какой тон нужен. Он напишет. Вы переделаете.

Я собрал промпты по этой теме в PDF. Забери бесплатно: https://t.me/airozov_bot

---

Что изменилось после одного случайного эксперимента

Та же ночь. Около четырёх утра, уже после провала с документацией, я делал ещё один кусок - описание для одного эндпоинта. Устал, злился, и написал длинно. Что-то вроде: "Это документация для senior backend разработчиков, которые будут подключить платёжный шлюз. Им нужно понять не просто что делает метод, а почему так, какие edge cases ловить и что делать при ошибках. Вот код..."

Claude выдал именно это. С первого раза. За 12 минут я закрыл эндпоинт, который до этого переписывал час.

Я сидел и смотрел на экран.

Разница была не в магии и не в везении. Разница была в одном: я объяснил кто будет читать и зачем. Всё остальное Claude додумал сам - и додумал правильно.

С тех пор я начал строить каждый промпт по одной схеме, которую называю для себя "три слоя".

Слой первый - роль читателя или пользователя результата. Не "напиши письмо", а "напиши письмо американскому клиенту из enterprise-сегмента, который привык к формальной переписке и сейчас недоволен задержкой". Claude сразу знает тон, уровень детализации, что можно сказать прямо, а что нужно смягчить.

Слой второй - какую задачу решает результат. Документация к API решает разные задачи: быстрый онбординг нового разработчика, или справочник для тех кто уже работает, или объяснение для технического менеджера без опыта в коде. Это три разных текста. Claude напишет нужный, если знает который.

Слой третий - что не нужно. Это странно звучит, но работает. "Не используй маркированные списки, мне нужен связный текст". "Не объясняй базовые концепции REST, аудитория знает". "Не добавляй вводные абзацы". Каждое такое ограничение убирает целый класс правок.

Я проверил это на следующем проекте. 40 эндпоинтов, 4 часа, ноль правок от клиента. Тот же объём работы, который в прошлый раз занял всю ночь и стоил мне $200.

---

Самое неожиданное, что я понял за эти три месяца

Я думал, что учусь использовать Claude. На самом деле я учился объяснять задачи.

Это звучит банально, но меняет всё. Когда я начал писать промпты с тремя слоями - я начал лучше ставить задачи команде. Я начал лучше брифовать клиентов. Потому что мышца "объяснить контекст" одна и та же, не важно кому ты объясняешь.

Ещё одна вещь, которую я не ожидал: Claude лучше работает когда ему говорят что пошло не так. Я начал добавлять в промпты историю: "Прошлая версия этого письма получила фидбек, что звучит слишком агрессивно. Сделай мягче, но не теряй конкретику". Claude не просто "делает мягче" - он понимает баланс.

Это не подсказка из туториала. Я нашёл это случайно, когда копипастил контекст из переписки с клиентом прямо в промпт из лени.

Лень иногда приводит к лучшим рабочим процессам.

И последнее: большинство людей вокруг меня до сих пор используют Claude как поиск. Бросают запрос, получают что-то, закрывают. Потом говорят "ну оно так себе". Я понимаю их - три месяца назад я был таким же. Разрыв в результатах между "запрос без контекста" и "три слоя" - это не 20%. Это другой инструмент.

Каждый день разбираю один такой инструмент в Telegram: https://t.me/yevheniirozov

---

Одно действие прямо сейчас

Зайди на claude.ai. Возьми любую задачу, которую ты обычно бросаешь без контекста. И напиши вот так:

*"Ты помогаешь [роль: кто использует результат]. Задача - [что должен сделать результат, какую проблему решить]. Не нужно [что убрать: лишние объяснения, определённый тон, формат]. Вот задача: [сама задача]"*

Один промпт. Сравни с тем, что ты получал раньше.

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