Лучшие практики Claude Code: уроки реальных запусков

Как работать с Claude Code эффективно: дробить задачи, вести CLAUDE.md, проверять перед публикацией. Реальные уроки и грабли из практики QuboLab.

Обновлено 30 июня 2026 г.

Коротко

Главная практика Claude Code простая: давайте помощнику чёткие маленькие задачи, заранее объясняйте правила проекта в CLAUDE.md и проверяйте результат перед публикацией. Помощник пишет код хорошо, но не читает мысли: он сделает «вообще правильно», а не «как у вас», если вы не сказали, как у вас. Большинство наших осечек — это не ошибки помощника, а недосказанность с нашей стороны: забыли предупредить про окружение, дали слишком крупную задачу, доверились вслепую на «боевом».

Определение

«Лучшие практики» здесь — это не свод теории, а привычки, которые экономят время и нервы при работе с ИИ-помощником. Они сводятся к нескольким принципам: формулировать узко, держать правила проекта в памятке, дробить большое на маленькое, не доверять вслепую на проде и проверять перед публикацией.

Всё это мы вывели не из инструкции, а из синяков на реальных продуктах QuboLab. Ниже — практики и сразу за ними конкретные грабли, на которых они появились.

Когда использовать

Эти привычки окупаются всегда, но особенно — когда:

  • Работаете над живым продуктом, у которого есть пользователи: цена ошибки реальная.
  • Задача крупная и её хочется свалить одной фразой — как раз тут важно дробить.
  • В проекте есть неочевидные правила (своё окружение, соглашения): их надо вынести в CLAUDE.md, иначе помощник про них не узнает.
  • Готовите выкладку на сервер — момент, где проверка важнее всего.

Когда НЕ стоит

Перегибать тоже не стоит:

  • Не превращайте правила в бюрократию. Если вы один на маленьком черновике, тяжёлый процесс с PR и ревью на каждый шаг будет только мешать.
  • Не дробите до абсурда. Слишком мелкие куски — это много лишних заходов. Задача должна быть «осмысленный шаг», а не «одна строчка».
  • Не пишите CLAUDE.md «на вырост». Огромная памятка с правилами, которых ещё нет, только путает. Растите её по мере того, как правила реально появляются.

Пошаговая инструкция

Семь практик, которые держат работу с помощником ровной. Каждая — с уроком, на котором она у нас появилась.

  1. 1
    Дробите большое на маленькое

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

  2. 2
    Ведите CLAUDE.md как живую памятку

    Правила, карту проекта и запреты держите в CLAUDE.md — помощник читает её в начале каждой сессии. Без неё он делает «правильно вообще», а не «по-вашему». Дополняйте её по ходу: всплыло новое правило — записали.

  3. 3
    Предупреждайте про неочевидное окружение

    Если в проекте есть особенность, про которую не догадаешься из кода (адрес сервиса, способ сборки), скажите заранее. Мы один раз выкатили мини-приложение, и оно открылось пустым: при сборке в код «зашился» старый адрес. Помощник сделал всё верно — но про эту деталь окружения надо было сообщить.

  4. 4
    Не доверяйте вслепую на проде

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

  5. 5
    Делайте бэкап перед крупными изменениями

    И проверяйте, что копируете именно то. Мы потеряли обложки статей, потому что бэкапили не тот путь: данные лежали в одном месте, а сохраняли мы другое. Бэкап «не того» — это иллюзия бэкапа.

  6. 6
    Проверяйте перед публикацией

    Дайте помощнику проверить себя — прогнать тесты, посмотреть дифф. А заметные изменения проводите через pull request, чтобы был шаг, где вы всё читаете. Автопроверки можно повесить на hooks.

  7. 7
    Делегируйте широкое субагентам

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

Пример

Самые полезные уроки у нас — это конкретные грабли, а не абстрактные советы. Три, которые врезались сильнее всего:

  • Пустое приложение после переезда. Перенесли мини-приложение на новый адрес, оно открылось — но пустое. Причина: при сборке в код «запёкся» старый адрес сервиса, и запросы уходили не туда. Урок: при сборке такие адреса фиксируются намертво — про окружение надо сказать заранее.
  • Потерянные обложки. После переустановки сервера пропали картинки к статьям. Бэкапили мы хранилище, а файлы лежали по другому пути. Урок: бэкапить надо по тому пути, откуда реально отдаётся файл, и проверять, что копируешь то самое.
  • Контейнеры затёрли друг друга. Два продукта использовали одинаковое имя проекта при запуске — и перезаписали один другой. Урок: явно задавать имя проекта, не полагаться на значение по умолчанию.

Общее во всех трёх: помощник всё сделал по инструкции. Споткнулись мы на том, чего ему не сказали. Поэтому главная практика — не «контролировать помощника», а вовремя сообщать ему про свои неочевидные условия.

Частые ошибки

Самые частые ошибки новичков (и наши собственные на старте):

  • Задача одной огромной фразой. «Сделай мне сайт» помощнику не по зубам за один заход. Дробите.
  • Работа без CLAUDE.md. Без памятки помощник не знает ваших правил и каждый раз изобретает их заново.
  • Слепое доверие на проде. «Разрешить всё» на живом сайте рано или поздно стоит инцидента.
  • Бэкап «не того». Резервная копия не того, что нужно, обнаруживается в худший момент. Проверяйте, что бэкапите.
  • Бесконечная одна беседа. В длинном разговоре помощник «забивает голову» и начинает путать. Между разными задачами начинайте заново.

Частые вопросы

С чего начать, если хочется сразу делать правильно?+

С двух привычек: дробите задачи на маленькие осмысленные шаги и заведите CLAUDE.md с правилами проекта. Это закрывает большую часть типичных проблем. Остальное — проверка перед публикацией и осторожность на «боевом» — добавится естественно.

Почему помощник делает «не так, как я хотел», хотя код правильный?+

Чаще всего потому, что он не знал вашего контекста. Помощник делает «правильно вообще», а ваши неочевидные условия (окружение, соглашения, что нельзя трогать) надо сообщить — в CLAUDE.md или прямо в задаче. Большинство осечек — это недосказанность, а не ошибка помощника.

Насколько можно доверять помощнику без проверки?+

На черновике и экспериментах — смело. На живом продукте — проверяйте перед публикацией и держите опасные шаги за ручным подтверждением. Хорошее правило: чем дороже цена ошибки, тем больше проверки. На проде — обязательно дифф, тесты и pull request.

Как не дать помощнику «запутаться» в долгой работе?+

Между разными задачами начинайте беседу заново (командой /clear), чтобы не копить лишнее в контексте. Важные правила при этом не теряются — они в CLAUDE.md. А широкие задачи отдавайте субагентам, чтобы основная беседа оставалась чистой.

Термины

Определения из глоссария QuboLab

Материалы QuboLab

Наши продукты, кейсы и исследования по теме