Как настроить Claude Code за вечер: 8 промтов по порядку

С чего начать настройку Claude Code

Начните с файла CLAUDE.md в корне проекта: Claude Code читает его в начале каждой сессии, и вам больше не придётся заново объяснять, как у вас собирается и тестируется код. Следом поставьте хук-предохранитель. Запрет в CLAUDE.md для модели всего лишь просьба, а хук срабатывает всегда и остановит rm -rf и git push --force, даже если правило забыто. В стартовом наборе восемь шагов, и если времени мало, сделайте первый и четвёртый: CLAUDE.md проекта и предохранитель. Личный CLAUDE.md хранит ваши правила для всех проектов: язык ответов, формат коммитов, что можно делать только после вашего «да». Режим плана не даёт Claude трогать файлы, пока вы не одобрите план. Второй хук зовёт вас, когда Claude закончил или ждёт ответа. Три субагента (исследователь, ревьюер и критик) работают каждый в своём чистом контексте и возвращают в ваш разговор только итог. Четыре шага написаны просьбами, их Claude Code выполнит сам. Ещё четыре дают готовые файлы: замените примеры в квадратных скобках на свои и сохраните.

Правило в CLAUDE.md просит, хук запрещает

Документация Claude Code называет CLAUDE.md контекстом. Модель читает его как просьбу: обычно следует ему, но может и отступить. Чем длиннее файл, тем больше места он занимает в контексте и тем хуже соблюдается, поэтому там же советуют держать его короче 200 строк.

Допустим, вы просите откатить неудачный эксперимент, а самый короткий путь к этому лежит через git reset --hard. Выполни его Claude, и вместе с экспериментом пропадут ваши незакоммиченные правки за полдня. Строка «reset только с моего согласия» в CLAUDE.md, скорее всего, удержит модель. Но ведь «скорее всего» и есть просьба.

А вот хук устроен иначе. Claude Code запускает его сам, и решает тут не модель. PreToolUse срабатывает перед вызовом инструмента, у предохранителя это Bash: скрипт получает JSON с описанием действия, а код выхода 2 действие останавливает. Текст из stderr Claude видит, так что знает, во что упёрся, и может спросить вас, как быть.

Отсюда простое правило, что куда писать. Всё, что можно поправить следующим сообщением, пусть живёт в CLAUDE.md: язык ответов, формат коммитов, какой командой гонять тесты. Всё, чего уже не вернуть, отдайте хуку: удаление папок, git push --force, DROP TABLE, деплой на боевой сервер.

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

Почему шаги идут в таком порядке

Первые два шага рассказывают Claude, с чем и с кем он работает. CLAUDE.md проекта описывает этот репозиторий, уезжает в git и достаётся всей команде. Личный ~/.claude/CLAUDE.md описывает вас и работает во всех проектах на вашей машине. Разведите их сразу. Иначе через месяц в общем репозитории окажется строка «я новичок во фронтенде, объясняй подробнее», и прочитают её все коллеги.

Третий шаг проверяет первые два на живой задаче. Возьмите что-нибудь небольшое и отправьте промпт с /plan в начале. По плану видно, что Claude понял о проекте. Ищет команду тестов наугад или не знает, где лежат миграции? Значит, этого нет в CLAUDE.md, и дописать лучше сразу.

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

Субагенты идут в конце, потому что читают тот же CLAUDE.md: чем точнее файл из первого шага, тем меньше им объяснять. Критик, правда, нужен реже остальных. Он пригодится, когда одну задачу делали несколько агентов сразу.

Идеи шагов мы нашли в открытых проектах на GitHub, тексты наши, источники названы в карточках.

Куда класть файлы и какие команды нужны

• ./CLAUDE.md или ./.claude/CLAUDE.md: правила проекта, уезжают в репозиторий.
• ~/.claude/CLAUDE.md: ваши правила для всех проектов.
• ./CLAUDE.local.md: личное для одного проекта, добавьте его в .gitignore.
• ~/.claude/settings.json: хуки для всех проектов. Хуки проекта лежат в .claude/settings.json и едут в репозиторий, а .claude/settings.local.json остаётся только у вас.
• .claude/agents/имя.md: субагент проекта, ~/.claude/agents/имя.md: ваш субагент для всех проектов.

Черновик CLAUDE.md делает встроенная команда /init, но промпт из первого шага строже: пересказывать README не даёт и каждую команду сверяет с файлами сборки. Править файлы памяти потом можно через /memory. Меню /hooks только показывает, какие хуки стоят, меняют их в settings.json, и правки обычно подхватываются сами. Нет в проекте CLAUDE.md, Claude Code прочитает AGENTS.md.

Команда /agents в новых версиях пошагового мастера не открывает и предлагает попросить Claude создать агента. Поэтому три субагента здесь даны готовыми файлами: шапка между строками --- с полями name, description и tools, ниже сама инструкция.

Субагенты Claude Code не слышали ваш разговор

У субагента свой чистый контекст. Вашей переписки он не видит: получает от Claude только задание и читает CLAUDE.md. Отсюда и польза, и ловушка. Исследователь перелопатит хоть полпроекта в своём контексте, а к вам вернётся один отчёт со ссылками файл:строка.

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

Кого позвать, Claude решает сам, по полю description в шапке файла, а позвать явно можно по имени или через @. Слова «используй сразу после…» подталкивают звать субагента без просьбы, так устроен ревьюер. Несколько независимых вопросов отдайте нескольким исследователям сразу, субагенты умеют работать параллельно.

Чего набор не закроет

• Предохранитель знает только свой список. Удаление, записанное по-другому, например find -delete или вызов из скрипта на Python, пройдёт, пока вы не добавите такой шаблон.
• Ревьюеру Bash нужен, чтобы видеть дифф, но Bash умеет и менять файлы, так что запрет на правки держится на словах инструкции. Нужно строже, уберите Bash из tools, но тогда дифф ему придётся передать в задании.
• В чужом репозитории могут лежать свои хуки в .claude/settings.json, и запустятся они раньше, чем вы решите, доверять ли этой папке. Сначала откройте этот файл глазами.
• CLAUDE.md стареет вместе с проектом. Тесты переехали с npm test на pnpm test, а в файле старая строка, и Claude упорно запускает её. Поменяли сборку, поправьте и файл.

Что дальше: скиллы и MCP

Набор настраивает, как Claude Code работает с вашим проектом, а следующий уровень учит его новому. Скиллы добавляют готовые умения, которые Claude подгружает под подходящую задачу, о них статья «Скилы для Claude». MCP подключает внешние программы вроде Figma, GitHub или браузера, об этом статья «MCP для Claude».

Но это потом. Для первого шага хватит одной просьбы: откройте терминал в корне проекта, запустите claude и вставьте промпт из карточки. Готовый CLAUDE.md прочитайте глазами до коммита: строки с пометкой «проверить» Claude не нашёл в файлах сборки, и решать по ним вам.

Частые вопросы

Почему Claude Code нарушает правила из CLAUDE.md?

Потому что CLAUDE.md для модели контекст, и читает она его как просьбу. Чем длиннее файл, тем хуже он соблюдается, поэтому документация советует держать его короче 200 строк. Формулируйте правила проверяемо: «миграции только через make migrate» вместо «аккуратно с базой». То, что нельзя допустить ни разу, ставьте хуком PreToolUse, он срабатывает всегда.

Чем субагент отличается от скила?

Скил — папка с правилами, которые Claude подгружает в ваш же разговор, когда задача подходит под описание. Субагент работает отдельно: у него свой чистый контекст, вашу переписку он не видит, получает задание и CLAUDE.md, а возвращает отчёт. Скил меняет то, как Claude делает работу, субагент забирает кусок работы себе. Про скилы и их установку есть наша статья «Скилы для Claude».

Как проверить хук-предохранитель, ничего не сломав?

Настоящие опасные команды для этого не нужны. Промпт из четвёртого шага просит Claude подать скрипту два тестовых JSON: в одном rm -rf test-folder, в другом git status. Исправный хук ответит кодом 2 на первый и 0 на второй. Потом откройте меню /hooks и убедитесь, что хук стоит на PreToolUse с matcher Bash. Обычные ls и удаление одного файла должны проходить.

Почему не приходит уведомление, когда Claude закончил?

Сначала проверьте систему. notify-send не работает на сервере без рабочего стола и в сессии по SSH, там выручит Telegram через бота, с токеном и номером чата в переменных окружения. На macOS уведомления идут от Script Editor, ему нужно разрешение в системных настройках. И проверьте событие: Stop запускается, когда Claude закончил ответ, Notification — когда он ждёт вас.

Как позвать субагента, если Claude не зовёт его сам?

Назовите его по имени прямо в сообщении, например «пусть ревьюер посмотрит изменения», или выберите через @ в поле ввода. Кого позвать, Claude решает по полю description, поэтому, если субагент молчит, допишите туда, в каких случаях он нужен. Прямое указание вроде «используй сразу после правки кода» подталкивает Claude звать его без напоминаний.