Claude Code: продвинутые техники для работы с AI

Эволюция работы с Claude Code

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

Горький урок (The Bitter Lesson)

Идея Ричарда Саттона подчёркивает, что вкладывать силы в hardcode-ограничения системы менее эффективно, чем просто увеличивать объём данных и вычислительных мощностей. Это справедливо и для Claude: модель лучше извлекает скрытые требования через диалог, чем вы их формулируете заранее.

Совет: Чем сложнее задача — тем больше пользы от интерактивного уточнения требований. Позвольте модели «интервьюировать» вас вместо того, чтобы писать детальный многостраничный brief.

Этап 1: Пусть Claude задаёт вопросы

Плохой промт: «Сделай лучше».

Хороший промт: Определяет область интересов, но не навязывает конкретное решение, поощряя Claude к диалогу.

Как это работает

1. В промте явно указывается использовать инструмент ask_user_question.
2. Claude начинает интерактивный опрос, уточняя детали (аудитория, функции, ограничения и т.д.).
3. В результате создаётся более полная и точная спецификация без необходимости заранее всё детализировать.

Рекомендации по настройке Claude Code

• Используйте Auto mode — это значительно упрощает работу и снижает вероятность ошибок.
• Настройте параметр Effort — рекомендуется high или max для сложных задач.
• Попробуйте Fast mode — дороже обычного, но идеально для быстрой итерации по спецификациям, когда скорость важнее стоимости токенов.

Этап 2: От Markdown к HTML-спецификациям

Проблема Markdown

Длинные файлы (200+ строк) плохо читаемы и трудно отобразимы визуально. Сложно предоставить дизайнеру или заказчику наглядную обратную связь без превращения текста в интерактивный макет.

Преимущества HTML-спецификаций

• Большая информационная плотность — больше данных в одной удобной форме.
• Визуальная эргономика — можно сразу оценить дизайн и макет интерфейса.
• Интерактивность — можно делать скриншоты спецификаций и давать по ним точную обратную связь Claude, работая с улучшенной vision-моделью.

Пример: приложение для разделения счетов

Claude может сгенерировать несколько HTML-макетов в разных стилях (минимализм, Tokyo fintech, брутализм и др.). Это позволяет наглядно выбрать направление дизайна и дать точные правки, особенно с улучшенной vision-моделью Opus 4.7.

Совет: Регулярно делайте скриншоты спецификаций для обратной связи. Часто проще показать Claude на картинке, что «что-то не так», чем описать это словами в текстовом формате.

Этап 3: Встроенная верификация для агентов

Цель: встроить возможность проверки прямо в артефакт (код), чтобы агент мог самостоятельно запускать тесты и верификацию, без вмешательства человека.

Пример с To-Do приложением (React)

1. Публикация состояния в DOM. Компоненты явно выводят свои данные через data-атрибуты HTML, например data-verify-unit="total-done".
2. Агент читает контракт. Claude может прочитать это состояние напрямую из DOM браузера, не вникая во внутренности React-компонентов.
3. Запуск верификации. На основе этих данных запускаются проверки инвариантов и фикстур, автоматически подтверждающих корректность кода.

Три способа запуска верификации

Запись доказательств

Процесс верификации можно записывать как видео-клипы, сохранять их в облаке (например, в S3) и делиться с командой в качестве объективного доказательства работоспособности и соответствия спецификации.

Итоговые рекомендации и выводы

Пять принципов эффективной работы с Claude Code

1. Доверяйте модели: Позвольте Claude извлекать требования через интерактивный диалог, используя ask_user_question.
2. Специфицируйте в HTML: Переходите от длинных Markdown-файлов (200+ строк) к наглядным интерактивным HTML-макетам с возможностью скриншотирования.
3. Встраивайте верификацию: Делайте состояние приложения и контракты проверки доступными прямо в DOM (через data-* атрибуты) для автономной работы агентов.
4. Используйте Opus 4.7: Новая модель с улучшенным vision-модулем идеально подходит для анализа скриншотов спецификаций и точной обратной связи.
5. Экспериментируйте с Fast mode: Для быстрого прототипирования и быстрых итераций по спецификациям, когда время критично.

Главный вывод

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