Промптинг Claude Code: как объяснять AI, чтобы он делал то, что нужно
Почему промптинг в Claude Code отличается от ChatGPT
Claude намного строже интерпретирует инструкции. Агрессивный тон («ты ДОЛЖЕН всегда использовать веб-поиск») вызывает у модели «панику» — она начинает вызывать ненужные инструменты и выдаёт хаотичный результат.
Главное отличие:
Чёткие процедурные инструкции → точный результат + экономия токенов + меньше переделок.
Агрессивные команды → хаос, пустая трата денег.
2 Ключевые принципы из Anthropic
2.1 Тон: Мягкий, а не агрессивный
❌ Плохо (агрессивный тон):
Никогда не пропускай поиск перед ответом!
✅ Хорошо (директивный):
Агрессивные команды (must, always, never) вызывают синдром «паники» — инструменты вызываются просто из страха ошибиться. Мягкие процедурные инструкции → модель спокойна и точна.
2.2 Точность: От расплывчатого к конкретным действиям
❌ Неточно:
Claude часто реализует сразу — «предложи» неточно
✅ Точно:
Принцип Opus 4.5:
Хочешь реализацию — скажи «реализуй». Хочешь анализ — скажи «предложи, не реализуя». Модель точно следует инструкциям.
2.3 Ограничения: Контролируй масштаб
Opus 4.5 тяготеет к переусложнению. «Рефакторь аутентификацию» → модель создаст новые интерфейсы, вспомогательные классы, конфиги, 10 файлов вместо 2.
❌ Без ограничений:
✅ С ограничениями:
Ограничения: модифицируй в месте, новых файлов не создавай, минимальные изменения.
2.4 Исследование: Поощряй глубокий анализ
❌ Без контекста:
Вносит изменения без понимания контекста — может исправить неправильно
✅ С исследованием:
Альтернатива: используй /plan — он автоматически запустит sub-agents для исследования кодбейса.
2.5 Богатые промпты = богатые результаты
❌ Скудный промпт:
Простая, базовая форма. Скучно.
✅ Детальный промпт:
- Полные анимации
- Валидация формы
- Сообщения об ошибках
- Доступность (a11y)
- Выйди за базовые рамки
Принцип пропорциональности:
Модель распределяет усилия пропорционально вложению в промпт. Простой → простое решение. Детальный → детальное.
2.6 Правила + контекст = точность
❌ Голое правило:
Заменит всё, даже где выглядит странно
✅ Правило + мотивация:
Контекст: Формальный юридический документ. Аббревиатуры = неоднозначность.
Понимает дух правила, может обобщить
2.7 Избегай «think» без thinking mode
❌ Без thinking mode:
Долгий многословный ответ — модель генерирует слова вместо мышления
✅ Правильная альтернатива:
Синонимы «think» которые работают: consider, evaluate, analyze.
3 Структура хорошей задачи
3.1 Как описывать контекст
Контекст отвечает на вопрос: «Почему я это спрашиваю?»
❌ Без контекста:
✅ С контекстом:
3.2 Как задавать чёткие цели
Цель должна быть измеримой и конкретной.
❌ Расплывчато:
✅ Конкретно:
1. Принимает видео до 5 ГБ
2. Извлекает аудио
3. Отправляет на AssemblyAI
4. Исправляет через Gemini
5. Показывает прогресс в UI
3.3 Типичные ограничения
- • Новых файлов не создавай
- • Только русский язык
- • Минимальные изменения
- • Не трогай эту папку
- • Используй библиотеку X, не Y
- • Результат за 2 минуты
- • Не рефакторь заодно
- • Сохрани существующий API
3.4 Примеры: плохой vs хороший промпт
Пример 1: Фронтенд-дизайн
❌ Плохо
✅ Хорошо
- Минималистичный, элегантный
- Не Inter (уникальный шрифт)
- Смелые контрастные цвета
- Сложные анимации
- Адаптивный
Вдохновение: Apple, Stripe (но отличаться)
Пример 2: Баг-фикс
❌ Плохо
✅ Хорошо
Контекст: frontend ограничивает до 500 МБ, backend поддерживает до 5 ГБ.
Требование: поднять лимит фронта до 5 ГБ.
Ограничения: не трогай backend.
4 Специфика дизайна и фронтенда
Дизайн требует противоположных инструкций
При простом «создай beautiful UI» — модель выдаёт усреднённый результат: Inter шрифт, purple gradient, minimal дизайн. Это центр распределения знаний.
❌ Тянет к центру:
→ Inter, purple gradient, minimal
✅ Тянет к краям:
- Избегай Inter
- Избегай фиолетовых градиентов
- Сложные анимации (не flat)
- Уникальное, не generic
→ Оригинальный результат
Лайфхак Ray:
Frontend design skill + extended thinking mode → лучший дизайн. В обычном режиме — функциональный код, скучный дизайн.
Чеклист перед отправкой промпта
Проверь перед тем, как нажать Enter:
Все ✅ — отправляй. Нет — доработай промпт.
Промптинг — это искусство и наука
Правильный промпт = точный результат. Не жалей времени на формулировку.