Для тех, кто только открыл Claude Code и уже чувствует, что что-то идет не так

Девять месяцев я пишу свои проекты с Claude Code. Я не разработчик и руками за это время не написала ни строчки кода. За девять месяцев можно выносить ребёнка, но их у меня уже 5, поэтому в этот раз я выносила гайдлайн по вайб-кодингу.

Токсикоз тоже был, про него писала тут Вайб-кодинг без розовых очков: как я писала свой продукт с Claude. А сегодня про то, как я работаю сейчас. С опытом сформировался порядок действий: сначала спека, потом код, потом проверка другим агентом или новым чатом. Я не претендую на исключительность, но все мои правила игры выстраданы личным опытом, временем и деньгами за подписку Max.

Рабочее место: VS Code

Claude Code можно запускать в терминале, но я для себя решила, что мне это неприятно. VS Code милее: обычный редактор, файлы слева, чат справа, никакого черного окна с командами.

Установка для тех, кто как я:

1. Поставить VS Code, он бесплатный

2. Слева открыть Extensions, найти Claude Code

3. Нажать Install

4. Войти тем же аккаунтом, что на claude.ai

5. Открыть чат по значку Claude

Ставить первое, от Anthropic с синей галочкой. Ниже похожие неофициальные расширения

Нужна платная подписка Claude, та же, что для веб-версии.

Слева у меня всегда открыта папка проекта. Там видно, что Claude делает прямо сейчас: какие файлы создает, какие подкаталоги заводит. Любой файл можно открыть и посмотреть, что он туда написал

В поле ввода внизу три вещи, за которыми я слежу: кружок контекста, модель и режим работы.

Слева кружок контекста и модель, справа режим Auto

Модель и сколько ей думать

Модель выбирается простым кликом. Я почти все делаю на Opus 5.5. Fable пробовала и не увидела никакого «вау», кроме скорости расходования лимита. А вот между Opus 5.5 и Sonet c Haiku разницу вижу: решения лучше, диалог умнее, как между джуном и миддлом, пожалуй.

Рядом настраивается, сколько модель думает перед ответом. Тут я иногда экономлю: сижу на High вместо Extra High, а в веб-версии вообще на Medium. Но в рутинной болтовне Opus 5.5 и на Medium весьма достоин. Кстати, в нем не нужно отдельно ставить Thinking, эта опция в последних моделях по умолчанию. Оговорюсь: все это про личные и небольшие проекты (сайт и платформа образовательного курса для страховщиков, приложения и боты для оптимизации рутины и проч), систем корпоративного масштаба я с Claude не строю, и для них выводы про модель и про то, сколько ей думать, возможно, были бы другие.

Режимы: почему он то спрашивает перед выполнением действия, то нет

Справа в поле ввода переключатель режима. Если коротко:

• Ask before edits: спрашивает перед каждой правкой

• Edit automatically: правит сам, команды спрашивает

• Plan mode: только план, ничего не трогает

• Auto: делает сам, спрашивает про критичное

Я почти всегда на Auto. Но и в нём Claude иногда начинает просить: «дай разрешение». Обычно это значит, что действие показалось ему рискованным: удалить файлы, зайти на боевой сервер, отправить что-то наружу, поменять его собственные настройки. На таких шагах и нужно останавливаться, мне подходит.

Не путать с «выбери решение». Иногда по пути Claude видит развилку и перед действием задаёт вопрос с вариантами ответа: какой из двух вариантов взять, что делать с найденной ошибкой. Это другой механизм: там безопасность, тут выбор. Такой вопрос он задаст в любом режиме, если есть вариативность.

Всем этим управляет обвязка, по-английски harness: программа вокруг модели, которая решает, что модели можно, где остановиться и о чем спросить. У Claude Code она, как по мне, самая навороченная. Агент попроще по прямому поручению пойдет тупить («сам виноват»). А этот товарищ и переспросит, и додумает, и улучшит, и заметит в логике, что ты пропустил. В общем, не нарадуюсь на такого помощника, в моей многозадачной жизни без клода никуда.

Сначала требования, потом код

Начинать со спеки и/или PRD считается хорошим тоном в любой разработке. PRD (Product Requirements Document) — это документ продуктовых требований: что делаем, для кого, зачем и как поймем, что готово. Спека, то есть спецификация, описывает, как это должно работать: экраны, данные, правила, ограничения. В первых проектах меня несло от магии и ощущения всемогущества (это неизбежно для любого начинающего вайбкодера), и я часто пропускала эти шаги, но расплата в виде хождений по кругу, ошибок и сложностей отката к рабочему варианту не заставит себя ждать, поверьте. Хотя месяца через 3 чуть остываешь и рациональность все равно к тебе приходит, но лучше соблюдать порядок сразу.

У меня есть заимствованный у Вани Замесина скилл PRD, который задаёт вопросы, пока смутная идея не превратится в четко сформулированную. Потом мы вместе с клодом оформляем ее в требования, и уже по ним начинается разработка.

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

Одна тема, одна папка и своя вкладка VS Code

У меня параллельно живут несколько проектов. Кажется удобным открыть одну большую папку «Мои проекты» и переключаться между ними в одном окне. Так я не делаю. И вам не советую.

Каждая тема получает свою папку, и я открываю ее в отдельной вкладке VS Code. Чаты Claude Code внутри вкладки тоже только про эту тему. Перешла к другому проекту, значит, перешла в другую вкладку.

При старте Claude читает CLAUDE.md и смотрит на файлы рабочей папки, из этого собирает картину «где мы и что делаем». Если в папке два проекта, картина смешивается: он подтягивает настройки соседнего сайта и переносит договоренности одного проекта на другой. Как общий родительский чат на два класса, понимаете?

В папку кладу все, что относится к теме, включая внешние документы: выгрузки, скриншоты ошибок, PDF с условиями сервиса, презентации и тексты, черновики требований, переписку в тг. В этой библиотеке Claude прекрасно ориентируется сам, а я могу проверить, откуда он что взял. Спрашиваю: «Ты пишешь, что лимит 300 писем в день. Где это?», и он показывает файл.

Слежу за контекстом и переезжаю в новый чат заранее

У каждого чата есть окно контекста: сколько текста модель держит в голове одновременно. Когда окно заполняется, Claude Code сжимает старую часть переписки в краткое изложение. Формально работа продолжается. На практике после сжатия он забывает договоренности: снова предлагает то, от чего мы отказались, путает, какой вариант выбрали.

Чтобы не проглядеть момент переезда, в VS Code есть кружок у поля ввода.

21% до автосжатия: скоро пора переезжать

Когда бегунок перевалил за 90%, я заканчиваю текущий шаг и пишу:

Сделай саммари этого чата, обнови память проекта, список задач и handoff-файл.

Handoff-файл это записка следующему чату, обычный текстовый файл в папке проекта. Жанр тот же, что у записки няне на холодильнике: обед в два, после сна гулять, на «мама всегда разрешает» не вестись. Новый чат начинаю с «прочитай память, TODO и handoff, скажи, что понял». Если пересказ совпадает с моим пониманием, работаем дальше.

Можно не переезжать в новый чат, а каждый раз делать compacting. Но встроенному сжатию (compacting) я не доверяю, потому что оно решает за меня, что важно. И когда скомпаченный чат продолжаешь, Claude забывает важные вещи, путается в договоренностях, в том, что уже пробовали и т.п. Примерно как муж пересказывает разговор с учительницей: «Да нормально всё, сказала, старается». Так что на собрания я хожу сама, а чаты проекта суммаризирую и храню. Бонус: через месяц это лучший способ вспомнить, что мы делали в этом проекте, и в каком из чатов я что обсуждала.

Побочные вопросы задаю в отдельном чате

Посреди работы мне часто хочется понять, что значит слово, которое Claude только что написал. Или что там вообще по месту на диске. Раньше я спрашивала в том же чате. Ответ занимал пару экранов, контекст таял, а основная задача уезжала вверх по переписке.

Теперь для «а что это такое» открываю второй чат или чат в веб-версии. Он ничего не знает про проект, и ему не надо. Прочитала ответ, вернулась в основной чат с одной строкой вывода. Рабочая сессия живёт дольше, и мусора, который потом попадёт в сжатие, в ней меньше.

Говорю, а не печатаю

Слепой печатью я владею, но голосом все равно быстрее. Задачи, требования и правки я надиктовываю.

Пользуюсь Wispr Flow, бесплатной версией, видимо, потому что я жадная. Когда бесплатный лимит кончается (а я еще и болтливая), переключаюсь на Handy. Он тоже бесплатный, транскрибирует однозначно хуже, но для жадных сойдет.

Claude неплохо понимает надиктованную кашу: «клот», «мникс» и «пирди» он без вопросов читает как Claude, nginx и PRD. Но не делайте так, когда задачи короткие, четкие и дорогие в токенах.

Скиллы сначала отдаю на разбор Claude

Скилл в Claude это папка с инструкцией и иногда скриптами. Он учит модель конкретной работе: собрать презентацию, провести интервью, написать тесты. На GitHub таких наборов сотни, и периодически, если ты состоишь в разных комьюнити вайбкодеров (а я состою) там подкидывают «супернаборы от Такого-то».

Но нужно иметь в виду, что каждый скилл занимает место в контексте, некоторые дублируют друг друга и то, что в Claude и так много чего встроено. Так что ставить лишнее и проедать токены вовсе не обязательно.

Посмотреть, кто съел окно, можно командой /context. Она показывает раскладку: системные инструкции, инструменты, файлы памяти, сама переписка.

Скиллы у меня едят 0,6% окна, а главный едок, как и положено, переписка

Поэтому прежде чем что-то ставить, я даю Claude ссылку и прошу:

Посмотри эти скиллы. Нужны ли они вообще? Что из них ценно, что нет и сколько они съедят контекста?

С этим упражнением Claude справляется великолепно. Раскладывает набор по косточкам, находит дубли, рассказывает, что у него уже есть, и говорит, какие штуки к этому проекту не нужны (читая наши же PRD). И очень часто это 90% того, что предлагают поставить. Если что-то может пригодиться потом, прошу запомнить: вот такие скиллы, вернемся, когда дойдем до этой задачи.

Через такой разбор у меня прошли, например, andrej-karpathy-skills, BABOK, Paperclip и др. У скилла Карпатого на GitHub больше двухсот тысяч звёзд, а внутри четыре правила, которые Claude и так соблюдает. Paperclip при разборе вообще оказался сервером, который управляет агентами как штатом сотрудников, и нужен он тем, у кого открыто 20+ вкладок и требуется мультизадачность. Если ваши вкладки – это отдельные проекты, и там нужна ваша голова, а не агенты на самовыгуле, то вам не надо.

Из прижившихся продуктовая методология Вани Замесина Next Move Theory Canon & Skills. Я сильно верю в подход AJTBD, продуктовый менеджмент для меня новая история, и мне помогает. Хотя какой-нибудь Deep Market Research может запустить большой мультиагентный поиск с перепроверкой и сожрать много токенов, но результат будет хорош. Просто присматривайте за ним, чтобы не разгулялся.

Презентации: скилл есть, глаз нет

Claude Code отлично пишет код. Но когда я просила его собрать с нуля презентацию для курса или Word-документ с инструкцией, получалось бедненько: шрифты по умолчанию, убогие таблицы. Та же просьба в веб-версии claude.ai давала эффектный файл с претензией на дизайн. При этом править готовую презентацию умеет хорошо.

Сначала я думала, что в Claude Code просто нет нужных скиллов. У Anthropic есть официальные скиллы для docx, pptx, xlsx и pdf, и в веб-версии они работают из коробки. Оказалось, у меня в Claude Code они тоже стоят: подтянулись из аккаунта claude.ai.

Проверьте, если скиллы у вас по умолчанию не подгрузились, их можно поставить в Claude Code как плагин:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

Тогда я попросила Claude разобраться, и он, конечно, нашел. Но не то. Он предположил, что скилл написан под веб-версию, где вокруг него стоит набор программ. И главная из них, LibreOffice, превращает готовые слайды в картинки. На моём ноутбуке LibreOffice не было, и он ее установил. Но это не помогло. Поэтому лишнюю программу я снесла и продолжаю ходить делать презентации в веб-версию. А Claude Code прошу подготовить md-конспект, тк он в теме каждого проекта.

Кстати, если кто-то знает, почему так происходит, что облачная версия клода делает гораздо более классные по дизайну файлы в обычном чате, чем плагин Claude Code для VS Code, напишите в комментариях.

Ключи не пишу в чат

Ключ от сервиса, вставленный в чат, остаётся в истории переписки. В принципе, можно на это забить, особенно, если это не ключ от вашей почты, а ключ от малозначимого тг-бота. Но лучше сразу выучить правила хорошего тона: Claude создаёт файл-шаблон с пустыми настройками и пишет, где взять каждое значение. Ключи вписываете сами, руками. Claude проверяет, что всё подхватилось, но значения не печатает.

Или если ключ выдается для разового входа, сразу удалить ключ/перевыпустить (в зависимости от приложения, в которое давали доступ).

Проверяет кто-то другой

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

• открываю новый чат и прошу покритиковать

• прошу Claude из другого проекта проверить этот

• прошу создать агента-тестировщика

• ещё в спеке пишу, какие будут проверки

В общем, важно понять, что два разных агента-клода – это как два разных сотрудника, каждый из которых на другого думает «ты неплохой парень, но слегка туповат, вот тут надо было иначе». Не пренебрегайте этим.

Что я до сих пор делаю неправильно

Git, систему контроля версий, веду не везде. В одних проектах Claude сохраняет версию после каждого шага, и откатиться можно за минуту. В других я до сих пор откатываюсь по памяти и по handoff-файлам. Однажды это кончится плохо, – говорит клод.

Не переключаю модели. По правилам хорошего тона рутину вроде переименований, мелких правок и поиска по файлам стоит отдавать Sonnet или Haiku: они быстрее и меньше тратят лимит. Я этого не делаю. Моего лимита хватает, чтобы жить на Opus. Пока хватает.

И хорошая новость напоследок.

За эти девять месяцев Claude стал гораздо реже косячить и гораздо чаще делать правильно с первой попытки. Так что выносили мы этот гайд, похоже, вдвоём с Антропик.

После родов у малыша наступает четвёртый триместр, период донашивания. И гайд по работе с Claude я законченным не считаю. Если вам есть чем поделиться, с удовольствием приму в комментариях лайфхаки от более опытных вайб-кодеров. Только не пишите «кормить надо было грудью, а не смесью»: на такие советы мы, мамы, умеем эффектно закатывать глаза.

Я Анна Муковозова, руководитель страховой аналитики с опытом 20+. Эксперт Data Science, автор проекта datadriven-course.com. В телеграм-канале @datadrivenmanagement пишу про ИИ и данные в страховом бизнесе: что автоматизировать, сколько это стоит и где оно ломается. Ищу своих, присоединяйтесь