12 лайфхаков Claude Code: CLAUDE.md, план, субагенты и хуки

Claude Code становится в разы полезнее, когда вы перестаёте использовать его как «чат с доступом к файлам» и начинаете настраивать: короткий CLAUDE.md, режим планирования для крупных задач, субагенты для исследования, хуки для жёстких правил и свои команды для повторяющихся процессов. Ниже — 12 приёмов, которые мы используем в Emaya при ежедневной разработке сервисов для Битрикс24.

Все команды сверены с официальной документацией Claude Code; инструмент обновляется часто, поэтому при расхождениях ориентируйтесь на неё.

Контекст и память

1. Короткий CLAUDE.md с тем, чего нет в коде

Команда /init генерирует стартовый CLAUDE.md по вашему проекту. Дальше работа в основном в том, чтобы удалять лишнее. Claude и так читает код — не описывайте структуру папок. Пишите то, чего он не узнает сам:

# Проект: сервис сводок по сделкам Битрикс24
- Запуск локально: npm run dev (порт 3040)
- Деплой: только через ./deploy.sh, никогда не правь файлы на сервере
- Токены портала лежат в .env, в код их не вставлять
- Даты в ответах API Битрикс24 — в часовом поясе портала
- Перед миграцией БД — бэкап и вопрос мне

Если правило касается только части проекта, вынесите его в .claude/rules/ с указанием путей — тогда оно подгружается, только когда Claude работает с этими файлами.

2. Ссылайтесь на файлы через @

Вместо «посмотри файл с авторизацией» напишите @src/auth.js. Claude сразу получит содержимое. Для папки @src/components он получит список файлов.

3. Чистите контекст вовремя

Длинная сессия со множеством тем начинает «плыть». Два инструмента:

• /clear — начать с чистого листа, когда задача сменилась;
• /compact с подсказкой, что сохранить: /compact оставь изменения API и команды для тестов.

Правило из документации, которое работает: если после двух поправок Claude всё ещё идёт не туда — /clear и новый, более точный промпт вместо третьей поправки.

Планирование и контроль

4. Режим планирования для всего крупного

Shift+Tab переключает режимы разрешений; в plan mode Claude читает файлы и предлагает план, ничего не меняя.

Нужно добавить выгрузку сводки в Excel и отправку
её в чат Битрикс24 каждое утро в 9:00. Изучи проект
и предложи план: какие файлы, какие риски, как проверить.
Код пока не пиши.

Поправьте план до того, как написана первая строка. Это дешевле любого рефакторинга.

5. Esc и откат

• Esc останавливает Claude посреди действия, при этом сделанное сохраняется — можно скорректировать курс.
• /rewind или двойной Esc на пустой строке открывает меню отката: можно вернуть код, разговор или и то и другое к более раннему шагу.

Это позволяет смело пробовать смелый вариант — и откатиться, если не вышло. Важно: откат касается правок, которые Claude сделал своими инструментами редактирования; он не заменяет git.

6. Дайте Claude способ проверить себя

Лучший промпт — тот, где есть критерий готовности:

Исправь расчёт дней на стадии. Готово — когда
npm test проходит и для сделки 1234 в тестовых данных
получается 12 дней, а не 0.

Тесты, команда проверки типов, скриншот ожидаемого результата — всё, что Claude может запустить и сравнить.

Делегирование

7. Субагенты для исследования

Чтение большого проекта забивает контекст. Попросите:

Используй субагента, чтобы разобраться, как в проекте
устроена работа с вебхуками Битрикс24. Верни краткую
схему: файлы, функции, где хранится токен.

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

8. Параллельные сессии через worktree

claude --worktree feature-export

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

Автоматизация

9. Свои команды через skills

Повторяющуюся процедуру — релиз, деплой, генерацию отчёта — оформите как skill: файл .claude/skills/<имя>/SKILL.md с описанием шагов. Его можно вызывать как slash-команду, например /deploy. Для действий с последствиями (выкатка на прод) в настройках skill можно запретить Claude запускать его самостоятельно — только вы вручную.

---
description: Выкатить проект на прод
disable-model-invocation: true
---
1. Запусти тесты, при ошибке — остановись.
2. Сделай коммит и пуш.
3. Запусти ./deploy.sh и проверь, что /health отвечает 200.

10. Хуки для правил без исключений

Если вы трижды написали в CLAUDE.md «никогда не трогай папку migrations», а он трогает — это работа для хука. Хуки настраиваются в .claude/settings.json и выполняются всегда: перед вызовом инструмента, после него, при попытке завершить ответ.

Писать JSON руками не обязательно:

Напиши хук, который блокирует любые правки в папке
migrations и в файле .env.

Затем проверьте результат командой /hooks. Типичные хуки: запрет правок защищённых файлов, автоформатирование после правки, проверка типов перед завершением ответа.

11. Скриншоты и браузер

Вставьте скриншот ошибки или макета в терминал (Ctrl+V, на Windows — Alt+V) или просто перетащите файл. Claude прочитает текст ошибки или сверстает по макету.

Вот скриншот того, как сейчас выглядит таблица на телефоне,
и макет, как должно быть. Исправь вёрстку.

Claude Code также можно подключить к браузеру Chrome через официальное расширение — тогда он сам откроет страницу, кликнет по кнопкам, прочитает консоль и сделает скриншот, чтобы проверить результат.

12. Git разговорным языком

Что я изменил с последнего коммита? Сделай коммит
с понятным описанием на русском.

Создай ветку fix/export, перенеси туда последние
правки и открой pull request с описанием изменений.

Правило, которое спасает проекты: коммит после каждого рабочего шага. Тогда любой неудачный эксперимент — это одна команда отката.

Как это выглядит в одном рабочем цикле

Собранные вместе, приёмы дают простой ритм, по которому мы работаем над большинством задач:

1. Новая задача — чистый контекст. /clear или новая сессия.
2. План. Plan mode, читаем, правим, утверждаем.
3. Реализация маленькими шагами с критерием готовности: тест, команда проверки или скриншот.
4. Проверка. Claude запускает тесты, хуки не дают закончить с ошибками, при необходимости — проверка в браузере.
5. Коммит с понятным описанием.
6. Деплой через skill, который вы запускаете вручную.
7. Обновление CLAUDE.md, если узнали что-то новое о проекте: «добавь в CLAUDE.md, что API портала возвращает максимум 50 записей за запрос».

Последний пункт часто пропускают, а зря: каждое такое правило экономит время во всех будущих сессиях.

Бонус: работа на несколько дней

/rename экспорт-сводок даёт сессии имя, а claude --resume экспорт-сводок на следующий день возвращает к ней со всей историей. claude -c продолжает последний разговор в текущей папке.

Итог

Настройка Claude Code занимает час, а экономит недели: меньше повторений, меньше поломок, меньше ручных проверок. Именно так мы собираем инструменты для Битрикс24 и сервисы на вайб-коде. Если ваш проект уже собран, но начал разваливаться от правок, — загляните в «Аптечку вайб-кода». Начинающим рекомендуем сначала статью «Claude Code: как установить и начать».