60 инсайтов Ray Amjad:
дистилляция 1600+ часов

Claude Code — это соавтор, не инструмент

Самая важная ментальная модель. Ты не «даёшь задание инструменту» — ты сотрудничаешь с умным агентом. Он может спорить, предлагать лучшие решения, замечать проблемы которые ты не видел. Это меняет весь подход.

Скорость ≠ количество токенов в минуту

Истинная скорость — сколько ценных функций деплоится в продакшн за день. Один длинный богатый промпт лучше десяти коротких итераций. Думай в единицах ценности, не в обменах сообщениями.

AI-разработка = 80% планирование, 20% исполнение

Переворот традиционного соотношения. Раньше разработчик тратил 20% на планирование и 80% на написание кода. Теперь инвестируй в спецификацию, дизайн и планирование — AI сделает исполнение быстро.

Не наблюдай за агентом — работай параллельно

«Смотреть как агент пишет код» — пустая трата времени. Запусти задачу и займись другой. Claude Code — не спектакль.

«Обычно у меня три-четыре экземпляра запущены одновременно. Одна думает — я работаю в другой.»

Кодовая база — это память агента

Claude Code работает с файловой системой лучше, чем любой другой AI-инструмент. Документируй решения прямо в коде и в CLAUDE.md — агент это прочитает в следующей сессии.

Демо-видео лучше текстовой спецификации

Запишь 30-секундное видео экрана с голосовым комментарием: «Вот что есть сейчас, вот что хочу». Используй как промпт через vision. Тысяча слов экономит тысячи токенов объяснений.

Стань лучшим ревьюером кода в своей жизни

AI пишет, ты ревьюишь. Навык чтения и понимания кода становится важнее навыка его написания. Инвестируй в понимание архитектурных паттернов, а не в синтаксис.

Доверяй агенту — но проверяй результат

Не смотри пошагово как агент работает — это снижает производительность. Проверяй финальный результат. Если нужно — используй /verbose режим для дебага, а не постоянного мониторинга.

Planning mode — это страховка, не тормоз

Shift+Tab переключает агента в режим планирования без выполнения. Для сложных задач — всегда используй. 5 минут планирования экономят час на откат неправильных изменений.

Начальный промпт важнее всех последующих

Первый промпт в сессии задаёт тон и контекст для всего. Потрать 90% времени промптинга на первый промпт — детальный, с контекстом, с ограничениями. Потом можно работать короткими командами.

Тон промпта влияет на качество кода

«Implement a function» vs «Carefully implement a robust function handling edge cases». Второй вариант стабильно даёт лучший результат. Claude реагирует на семантику слов.

Ограничения так же важны, как цель

«Добавь авторизацию» — плохо. «Добавь JWT авторизацию, НЕ изменяя схему БД, НЕ добавляя новые зависимости» — хорошо. Явно говори что НЕ делать.

Давай контекст о проекте, не только о задаче

«Это e-commerce стартап, MVP для B2B клиентов, FastAPI backend, 3 разработчика в команде. Задача: добавить...». Контекст помогает Claude принимать лучшие решения на уровне архитектуры.

«Богатые промпты» — это конкурентное преимущество

Используй голосовой ввод чтобы диктовать подробные инструкции за 30 секунд вместо 5 минут печати. Детальность промпта напрямую коррелирует с качеством результата.

Скажи «не предлагай альтернативы» если решение уже принято

Claude любит предлагать варианты. Если решение принято — добавь «implement without suggesting alternatives». Иначе получишь список опций вместо кода.

Попроси объяснить план перед исполнением

«Before writing any code, explain your implementation plan in 3-5 bullet points». Это самый дешёвый способ поймать неправильное понимание задачи. 10 секунд чтения vs. час на откат.

Инкрементальные задачи лучше монолитных

«Сделай всю авторизацию» → сложно проверить, много мест где может ошибиться. «Добавь модель User в БД» → «Добавь эндпоинт /register» → «Добавь JWT middleware». Каждый шаг проверяем.

«Форма дифа» — как описывать изменения

Описывай задачу как diff: «Сейчас у нас X. После изменения должно быть Y. Не меняй Z.» Эта структура помогает Claude понять границы изменений и избежать нежелательного side-effect.

Скриншоты работают лучше текстовых описаний UI

Для задач с UI — просто скинь скриншот. «Сделай вот так» [скриншот] работает в разы лучше чем «сделай блок с синим фоном, три колонки, gap 16px...». Vision в Claude Code — мощный инструмент.

Говори роль / аудиторию явно

«Ты — senior backend developer специализирующийся на PostgreSQL. Проверь этот запрос на производительность.» Явная роль улучшает качество ответа лучше длинных технических описаний.

CLAUDE.md — самая важная инвестиция в проект

Каждый раз когда объясняешь что-то агенту — спрашивай: «Это нужно добавить в CLAUDE.md?». Цель: чтобы новая сессия получала весь нужный контекст без повторных объяснений.

Используй git как инструмент безопасности

Делай коммит перед каждой крупной задачей агента. Если агент сломал что-то — `git checkout .` и заново. Коммиты с AI — чаще и мельче, чем в традиционной разработке.

Прерывай агента при первом признаке отклонения

Escape останавливает работу мгновенно. Не жди пока агент «дойдёт до конца». Увидел что идёт не туда — останови, скорректируй, запусти снова. Это не неудача, это нормальный итерационный процесс.

Субагенты — по контексту, не по ролям

Не создавай «frontend-агент» и «backend-агент» — это неэффективно. Создавай по задаче: «агент для рефакторинга auth модуля», «агент для написания тестов». Изоляция контекста важнее изоляции ролей.

Worktrees нужны только при конфликтах файлов

Большинство параллельных задач не пересекаются по файлам — тогда worktrees не нужны. Используй `claude -w` только когда два агента изменяют одни и те же файлы.

Разделяй «что» (ты) и «как» (агент)

Твоя задача — решить КАКУЮ проблему решать. Агентa задача — решить КАК. Не микроменеджь реализацию, если тебя устраивает результат. Доверяй «как» — требуй правильного «что».

Тесты — это инструкции для агента

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

«Context audit» в начале большой задачи

Попроси: «Напиши что ты знаешь о текущем состоянии проекта в 5 bullet points». Это выявляет что агент понял (или не понял). Дешевле чем часовой откат из-за неправильных предположений.

Skills (slash commands) — для повторяющихся задач

Всё что делаешь более двух раз — оформи в slash command. Деплой, code review, создание компонентов, миграции — каждая рутинная задача заслуживает своей команды.

MCP серверы расширяют возможности бесконечно

Стандартный Claude Code умеет работать с файлами и терминалом. MCP добавляет: базы данных, API, Slack, GitHub, браузер, Docker — всё что угодно. Инвестируй время в настройку нужных MCP серверов.

Opus для архитектуры, Sonnet для кода, Haiku для рутины

Практическое правило выбора модели. Сложные архитектурные решения — Opus. Написание кода по спецификации — Sonnet. Простые трансформации, форматирование, шаблоны — Haiku. Экономит деньги без потери качества.

Claude Code дешевле чем кажется на старте

Ray Amjad тратит $30–50 в месяц при интенсивном использовании с Pro планом. Ключ: богатые промпты дают результат с первого раза, избегая дорогостоящих итераций.

Переключение моделей внутри сессии — норма

Начни с Opus для сложного анализа, переключись на Sonnet для написания кода: claude --model sonnet. Гибридный подход оптимизирует соотношение цена/качество.

Длина контекста = стоимость, используй с умом

Каждый токен в контексте стоит денег. Не добавляй в контекст «на всякий случай». Используй `@file` чтобы добавлять конкретные файлы вместо целых директорий.

Claude Code vs Codex CLI — разные инструменты

Claude Code — для сложных, рассуждательных задач. Codex CLI — быстрее и дешевле для простых трансформаций. Ray Amjad использует оба параллельно: Claude для логики, Codex для шаблонного кода.

Max plan для тяжёлых проектов, Pro для нормального темпа

Pro план (~$20/мес) достаточен для большинства случаев. Max план (~$100/мес) — если постоянно упираешься в лимиты или работаешь с огромными кодовыми базами.

Кэширование промптов снижает стоимость

Claude автоматически кэширует повторяющиеся части промпта (например CLAUDE.md) — это снижает стоимость длинных файлов при каждом вызове. Экономия до 90% на повторяющихся контекстах.

Новые модели — тестируй сразу после релиза

Ray Amjad тестирует каждую новую модель в первую неделю. Иногда неожиданно хорошо для специфических задач. Claude 3.5 Haiku часто побеждает более дорогие модели на конкретных задачах.

Стоимость ≠ качество в 100% случаев

Для написания unit-тестов по существующему коду — Haiku справляется на уровне Opus. Для дебага сложной многопоточности — нужен Opus. Выбирай модель по сложности задачи, не по привычке.

ROI Claude Code: $50/мес замещает $50 000/мес junior-разработчика

Не самая точная математика, но точная метафора. Вопрос не «дорого ли?», а «какой ROI?». Один успешный запуск продукта покрывает годы подписки. Трать деньги на качество промптов, не на экономию токенов.

Ошибка: не читать что сделал агент

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

Ошибка: давать слишком широкий доступ

«Разберись с проектом как хочешь» — агент начнёт переписывать архитектуру, удалять «лишние» файлы, переименовывать всё. Всегда ограничивай область изменений явно.

Ошибка: игнорировать warning сообщения агента

Когда Claude пишет «I'm not sure about this...» или «This might break...» — это не вежливость. Это реальное предупреждение о неопределённости. Останови, прояснь, потом продолжай.

Ошибка: копировать код без понимания

AI-генерированный код нужно понимать. Не обязательно каждую строчку, но общую логику. Если не понимаешь что делает код — попроси объяснить перед принятием. Иначе поддерживать будет невозможно.

Ошибка: не обновлять CLAUDE.md

CLAUDE.md, который не обновляется — быстро устаревает. Архитектурные решения меняются, новые зависимости добавляются. Устаревший CLAUDE.md хуже чем никакой — он дезориентирует агента.

Ошибка: debugging разговором вместо инструментов

«Почему не работает?» → «Может быть так?» → «А если попробовать эдак?». Это замедляет в 10 раз. Правильно: дай Claude логи, трассировку, конкретный код — и попроси анализ, а не гипотезы.

Ошибка: одна сессия на весь день

Context fatigue — реальная вещь. После 2-3 часов в одной сессии качество деградирует, агент начинает противоречить сам себе. Используй /compact и начинай новые сессии для новых задач.

Ошибка: не тестировать самостоятельно

«Агент написал тесты — значит всё работает». Это опасное заблуждение. Тесты написанные AI тестируют то, что AI написал — не то, что реально нужно. Мануальное тестирование критичных путей обязательно.

Ошибка: переоценивать стабильность AI-кода

AI пишет «уверенно» — это не значит «правильно». Особенно в edge cases, security, concurrency. В критичных местах — extra review, extra tests, extra skepticism.

Ошибка: думать что AI заменит понимание предметной области

Чем глубже понимание домена — тем лучше промпты — тем лучше результат. AI усиливает экспертизу, не замещает её. Инвестируй в понимание своей области — это прямо влияет на качество AI-работы.

Создай «второй мозг» проекта в файловой системе

Помимо CLAUDE.md — создай docs/ARCHITECTURE.md, docs/DECISIONS.md, docs/GOTCHAS.md. Это хранилище знаний которое сохраняется между сессиями и может быть передано другому разработчику (или следующей версии модели).

Агентные цепочки — следующий уровень автоматизации

Один агент генерирует тесты → второй пишет код → третий делает review. Каждый агент специализирован и изолирован. Это не про сложность — это про качество: каждая роль выполняется лучше с чистым контекстом.

Hooks + headless = полная автоматизация рутины

Stop hook запускает тесты → если тесты упали, headless агент получает задачу их починить → по завершении уведомление в Telegram. Ты спишь — агент работает. Это реальное будущее разработки.

«Claude Code как junior разработчик» — неправильная модель

Правильная модель: Claude Code как очень умный, очень быстрый исполнитель который иногда галлюцинирует. Не junior (тот учится сам). Лучше аналогия — опытный контрактор которому нужна хорошая спецификация.

Изучай видео о Claude Code — это тоже инвестиция

1 час изучения лучших практик экономит 10 часов работы. Ray Amjad, официальный канал Anthropic, Simon Willison — следи за обновлениями. Инструмент меняется каждые 2-3 недели.

Используй `--verbose` только для отладки

Verbose режим показывает все вызовы инструментов. Полезен когда что-то идёт не так. В обычной работе — отключай: шум снижает фокус и не добавляет ценности.

Скорость освоения = количество часов использования

Нет замены реальному опыту. 100 часов за месяц > 1600 часов за 2 года по эффективности обучения. Дай себе месяц интенсивного использования — и выйдешь на плато мастерства. Нельзя научиться читая руководства.

Создай личный «стек успешных промптов»

Когда промпт дал отличный результат — сохрани в личную библиотеку (Obsidian, файл, Notion). Через 3 месяца у тебя будет золотая коллекция рабочих паттернов для твоих специфических задач.

Качество > скорость на архитектурных решениях

AI ускоряет исполнение — это не повод спешить с проектированием. Плохая архитектура пишется так же быстро как хорошая, но мешает в 10 раз дольше. Используй сэкономленное время на лучшее проектирование.