Claude Code: правила инженера, который строил системы для Amazon и Disney

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

Сначала думайте, потом печатайте

Самая большая ошибка на старте — сразу начать печатать. В 10 случаях из 10 результат из режима планирования (двойное нажатие Shift+Tab) значительно лучше, чем «вывалить всё подряд и надеяться».

Сравните два запроса: «построй мне систему авторизации» и «сделай вход по email и паролю на существующей модели User, сессии храни в Redis сутки, закрой все маршруты /api/protected». Первый оставляет модели свободу, которой она распорядится плохо. Второй — задаёт рамку.

Нет опыта, чтобы продумать архитектуру самому? Ведите диалог: опишите нейросети, что хотите, попросите варианты решения, задавайте вопросы и требуйте вопросов в ответ. Пять минут планирования экономят часы отладки.

CLAUDE.md — ваш главный рычаг

Это файл-онбординг, который Claude читает перед каждой сессией. Большинство его либо игнорирует, либо превращает в роман — и то и другое портит результат.

• Кратко. Модель надёжно держит порядка 150–200 инструкций, и ~50 уже занято системным промптом. Каждая лишняя строка конкурирует за внимание с нужными.
• Только неочевидное. Не объясняйте, что такое папка components — объясните ваши команды сборки и особенности проекта.
• «Почему» сильнее «что». «Используй строгий режим TypeScript» — нормально. «…потому что у нас были баги в проде из-за неявных типов» — заметно лучше: обоснование помогает модели принимать решения, которые вы не предусмотрели.
• Обновляйте постоянно. Поймали себя на том, что исправляете модель вторым разом за одно и то же — добавьте правило в файл (клавиша #).

Плохой CLAUDE.md выглядит как документация для нового сотрудника. Хороший — как заметки самому себе на случай завтрашней амнезии.

Контекст деградирует раньше, чем вы думаете

У модели окно в 200 тысяч токенов, но качество начинает проседать уже на 20–40% заполнения. Если после сжатия контекста результаты стали ужасными — модель деградировала ещё до сжатия.

Что помогает:

1. Один диалог — одна задача. Не смешивайте авторизацию и рефакторинг базы в одном чате.
2. Внешняя память. Пусть планы и прогресс живут в файлах (plan.md) — они переживают сессию.
3. Сброс через копипаст. Контекст раздулся — скопируйте важное, очистите диалог, вставьте обратно только нужное.
4. Не бойтесь /clear. В 9 из 10 случаев чистый старт лучше, чем попытка пробиться сквозь путаницу.

Ментальная модель: Claude не хранит состояние. Каждый разговор начинается с нуля, кроме того, что вы явно дали.

Плохой ввод == плохой вывод

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

Отдельный пункт — говорите, чего НЕ делать. У моделей есть наклонности: например, любовь к оверинжинирингу — лишние файлы и абстракции, которых никто не просил. «Сделай просто, одним файлом, без лишних абстракций» — легальный и очень эффективный промпт.

И про выбор модели: быстрая — для исполнения по готовому плану, мощная — для планирования и компромиссов. Планируйте дорогой моделью, исполняйте дешёвой.

Когда Claude застревает

Модель зациклилась: пробует одно и то же, падает, пробует снова. Инстинкт говорит давить сильнее — больше инструкций, больше исправлений. Правильный ход — сменить подход:

• очистите диалог — накопленный контекст путает;
• разбейте задачу мельче — если модель не тянет, план был слаб;
• показывайте, а не рассказывайте: напишите минимальный пример руками — «вот образец, примени паттерн к остальному»;
• переформулируйте с другого угла.

Главный навык — распознать цикл вовремя: объяснили трижды и не помогло — четвёртое объяснение не поможет тоже.

Стройте системы, а не разовые запросы

Те, кто получает от Claude Code максимум, не задают вопросы — они строят конвейеры: headless-режим позволяет запускать промпты скриптами и встраивать их в рабочие процессы — авторевью, ответы на тикеты, отчёты.

И главное — маховик: Claude ошибся → вы посмотрели логи → улучшили CLAUDE.md → в следующий раз ошибки нет. Накопительный эффект: система через три месяца работает заметно лучше, чем в день запуска.

Что здесь важно для маркетолога

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

Проверить, где ваша система теряет качество — от промптов до заявок: напишите «система» в Telegram, разберём за 15 минут.