Создайте в корне проекта файл CLAUDE.md и запишите в нём границы задачи: какие части сайта разрешено менять, что нужно согласовать и как проверить результат. Для сайта малого бизнеса начните с запрета на посторонние правки, обновление зависимостей и публикацию без разрешения. Ниже разберём, как составить такие инструкции для Claude Code, проверить их на небольшой задаче и исправить расплывчатые формулировки. Сам файл не гарантирует соблюдение правил: перед публикацией всё равно нужно просмотреть изменения и проверить работу сайта.
Что написать в CLAUDE.md для сайта малого бизнеса?
Начните с короткого описания проекта и рабочих правил. Разработчику и ИИ нужен один и тот же контекст: для чего существует сайт, где лежат страницы и какой результат считается готовым. Фразы «пиши качественно» или «соблюдай лучшие практики» не задают проверяемых требований.
В русскоязычном руководстве по Claude Code есть шаблоны CLAUDE.md, а также материалы про скиллы, хуки и субагентов. Шаблон поможет собрать структуру, но пути к файлам и команды нужно взять из своего проекта (GitHub, sfrangulov/claude-code-handbook-ru).
Соберите первую версию файла из следующих блоков. Текст ниже можно использовать как заготовку, заменив общие описания конкретными путями и командами.
- Назначение проекта: «Это сайт компании с каталогом услуг. В текущей задаче сохраняй существующие тексты, цены и адреса страниц, если запрос прямо не требует их изменить».
- Структура: «Перед правкой найди файл нужной страницы и связанные с ней стили. Если для задачи требуется изменить общий компонент, сначала объясни, какие ещё страницы он затрагивает».
- Границы: «Меняй только то, что необходимо для текущего запроса. Посторонние ошибки перечисли в отчёте, без исправлений».
- Проверки: «После правок выполни команды проверки из этого файла. Если команда недоступна или завершается ошибкой, сообщи об этом и не называй задачу полностью проверенной».
- Отчёт: «Перечисли файлы, которые изменил, объясни причину каждой правки и укажи результаты проверок. Отдельно назови то, что осталось проверить вручную».
Не знаете структуру проекта? Сначала попросите Claude Code изучить её без изменений и предложить содержание этих блоков. Проверьте предложенные пути: инструкция со ссылкой на несуществующую папку только запутает следующую задачу.
Как ограничить изменения за пределами задачи?
Опишите действия, перед которыми Claude Code должен остановиться и запросить согласование. Для сайта с каталогом услуг это могут быть изменения общей навигации, зависимостей и настроек публикации. Формулировка «будь осторожен» не объясняет, в какой момент нужно остановиться.
Добавьте отдельное правило: «Без согласования не удаляй файлы, не обновляй зависимости, не меняй настройки сборки и не публикуй сайт. Если задача требует такого действия, объясни причину и дождись ответа». Правило в CLAUDE.md задаёт порядок работы, но не заменяет технические ограничения доступа.
Для каждой задачи уточняйте разрешённую область в самом запросе. Например: «Исправь перенос заголовка на странице услуги при узком экране. Сохрани текст, цвета и поведение кнопки. Сначала назови файлы, которые планируешь изменить, затем дождись согласования».
Такой запрос даёт проверяемую границу. Если Claude Code предлагает заодно переписать меню, попросите объяснить связь с переносом заголовка. Когда прямой связи нет, вынесите меню в отдельную задачу.
Перед запуском убедитесь, что текущая версия проекта сохранена в системе контроля версий или в резервной копии. Не поручайте ИИ удалять прежние правки ради «чистого начала»: среди них могут быть изменения, которые ещё не вошли в опубликованную версию.
Какие команды и проверки добавить в CLAUDE.md?
Впишите команды, которые уже работают в проекте. Обычно это запуск локальной версии сайта, проверка кода, тесты и сборка. Не копируйте команды из чужого шаблона без проверки: одинаковое назначение сайтов ещё не означает одинаковое устройство проекта.
Если команды неизвестны, дайте отдельное поручение: «Найди инструкции запуска и проверки проекта. Ничего не устанавливай и не меняй. Покажи команды и укажи, из каких файлов ты их взял». Затем попросите разработчика подтвердить список или проверьте команды в рабочей копии проекта.
Для каждого типа задачи добавьте критерий приёмки. После изменения кнопки нужно проверить переход по ней. После правки меню нужно открыть его на узком экране и перейти на нужную страницу. Успешная сборка сама по себе не подтверждает, что посетитель сможет выполнить эти действия.
В практическом материале о работе с Claude Code предлагают заранее составлять план тестирования для каждого шага, а после изменений запускать тесты и разбирать ошибки (Хабр, «Как работать с Claude Code, Antigravity и Codex в 2026: база вайбкодинга»). В CLAUDE.md это можно записать так: «Перед правкой назови способ проверки. После правки выполни проверку и сообщи результат».
Повторяемые проверки стоит описать отдельно от общих ограничений проекта. Например, чек-лист сайта можно превратить в скилл Claude Code, чтобы использовать один порядок проверки в похожих задачах. Для проверки интерфейса пригодится разбор того, как проверить доступность сайта с Claude Code, Playwright и axe-core.
Если вы передаёте доработку сайта исполнителю, приложите к задаче CLAUDE.md и критерии приёмки. Тогда результат работы включает не только изменённые файлы, но и перечень проверок с их результатами. Это конкретный состав услуги по доработке сайта после вайбкодинга.
Почему Claude Code выходит за рамки инструкций?
Начните с проверки того, какие инструкции Claude Code учитывает в текущей работе. Попросите его без изменений перечислить правила проекта и назвать файлы, из которых он их взял. Такой ответ помогает обнаружить пропуск или противоречие, хотя сам по себе ещё не доказывает соблюдение правил.
Затем сопоставьте CLAUDE.md с текущим запросом. В файле может стоять запрет на изменение общей вёрстки, а в сообщении — просьба «полностью привести страницу в порядок». Уточните область задачи до запуска: какие блоки меняем, какие сохраняем и что согласовываем отдельно.
Проверьте и сами формулировки. Вместо «не трогай важное» напишите: «Без согласования не меняй меню, адреса страниц и настройки публикации». Вместо «сделай аккуратно» задайте наблюдаемый результат: «На узком экране заголовок не перекрывает кнопку, текст остаётся прежним».
Испытайте файл на небольшой правке в рабочей копии сайта. Попросите исправить один отступ и заранее назвать ожидаемые изменения. После выполнения сравните план с результатом. Если проект использует Git, команда git diff --stat покажет сводку изменений, а git diff — сами правки. При этом новые файлы стоит отдельно проверить через git status.
Если в отчёте есть только фраза «всё работает», запросите команды, их результаты и список ручных проверок. Для задач безопасности нужен ещё более предметный разбор: отчёт Claude Code об уязвимостях сайта нужно проверять по доказательствам, прежде чем принимать предложенные исправления.
Типичные ошибки при настройке CLAUDE.md
- Слишком общие запреты. «Не ломай сайт» замените перечнем действий, которые требуют согласования: удаление файлов, обновление зависимостей, изменение общих компонентов.
- Команды из чужого проекта. Найдите рабочие команды своего сайта и проверьте их до того, как поручать ИИ использовать их при каждой задаче.
- Длинная история вместо действующих правил. Уберите завершённые задачи и старые обсуждения. Оставьте сведения, которые нужны для следующей правки.
- Доверие только итоговому сообщению. Сверьте список файлов с реальными изменениями и самостоятельно откройте затронутую страницу.
- Попытка защитить сайт одним текстовым файлом. Ограничьте доступ к рабочему сайту отдельно, а изменения сначала проверяйте в копии проекта.
Начните с одного действия на минуту: откройте CLAUDE.md и добавьте правило «Посторонние проблемы перечисляй в отчёте; исправляй их только после отдельного согласования».
