Дайте Claude контекст: CLAUDE.md и лучшие подсказки

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

CLAUDE.md — это простой файл markdown, который Claude автоматически читает в начале каждой сессии в этом каталоге. Думайте о нём как о брифинге, который вы дали бы способному новому коллеге в его первое утро: как работает команда, чего избегать и где находятся важные части.

Вам не нужно ссылаться на него в подсказках или прикреплять его вручную. Если файл существует, Claude уже его прочитал.

Claude ищет в нескольких местах и объединяет найденное, от общего к конкретному:

Большинству команд нужен только файл в корне проекта. Зафиксируйте его в git, чтобы вся команда получила выгоду.

Файлы в вашем рабочем каталоге и выше читаются при запуске сессии и доставляются Claude как пользовательское сообщение сразу после системного приглашения (не встроены в само системное приглашение). Файлы CLAUDE.md подкаталогов загружаются по требованию позже, когда Claude читает файлы в этом подкаталоге. Нет суммирования или усечения, и он не перечитывается с диска при каждом ходе. Если вы отредактируете файл во время сессии, изменение будет применено при следующем запуске /compact или открытии через /memory; в противном случае оно вступит в силу в вашей следующей сессии.

Для клиентов Claude for Enterprise картина затрат лучше, чем может показаться из фразы «загружается при каждом запросе». Claude Code применяет кэширование подсказок Anthropic к CLAUDE.md. Первый запрос в сессии платит полную цену входных токенов для файла; последующие запросы в течение примерно пяти минут друг от друга попадают в кэш и выставляются по гораздо более низкой ставке чтения кэша. Кэш адресуется по содержимому, поэтому любое изменение CLAUDE.md его инвалидирует, и следующий запрос снова платит полную цену.

На практике это означает, что значительный CLAUDE.md стоит полные токены один раз за сессию, плюс один раз после любого перерыва, достаточно длительного для истечения кэша, а не один раз за сообщение. Всё ещё стоит держать файл компактным для пространства контекстного окна и соотношения сигнала к шуму, но вам не нужно экономить строки исключительно для контроля расходов за сообщение. На панели управления использованием Enterprise файл будет отображаться почти полностью как токены чтения кэша, а не как стандартные входные токены.

В любом проекте введите /init. Claude изучит кодовую базу и создаст для вас черновик CLAUDE.md, охватывающий команды сборки, команды тестирования, обзор структуры и любые обнаруженные соглашения. Проверьте черновик, удалите всё неточное и зафиксируйте. Это займёт около пяти минут и окупится постоянно.

Стремитесь к файлу, который короткий и информативный — примерно под 200 строк. Каждая строка загружается в контекст при каждом запросе, поэтому каждая должна быть стоит своей цены.

Стоит включить:

Не стоит включать:

Относитесь к нему как к живому документу адаптации, а не как к спецификации.

Вы также можете добавить его во время сессии: откройте /memory, чтобы отредактировать файл напрямую, или просто попросите Claude «запомнить» правило, и он добавит его в правильный CLAUDE.md для вас.

Это не общие советы по инженерии подсказок; это привычки, которые имеют наибольшее значение специально, когда Claude читает и редактирует реальную кодовую базу.

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

❌ «Откройте userService.ts, найдите функцию validate, добавьте проверку на null на строке 42.»

✅ «Пользователи без электронной почты вызывают сбой на этапе валидации. Сделайте так, чтобы это обрабатывалось корректно, и добавьте тест.»

Вставьте полный трассировочный стек вместо его резюме. Точное имя файла, номер строки и сообщение — это то, что позволяет Claude быстро найти правильное место.

Для всего, что касается более чем пары файлов, нажмите Shift+Tab дважды, чтобы перейти в режим плана (первое нажатие входит в acceptEdits) и спросите:

«Спланируйте, как вы добавили бы ограничение скорости к публичному API. Не меняйте ничего пока.»

Проверьте план, отрегулируйте его в разговоре, затем переключите режимы и скажите «выполни шаг 1.» Это ловит неправильные понимания до того, как они превратятся в diff из двенадцати файлов.

Claude может самостоятельно искать в кодовой базе, но если вы уже знаете соответствующий файл, скажите об этом — это быстрее и использует меньше токенов. Используйте @ для ссылки на пути, например @src/auth/login.ts.

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

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

Если первый ответ неправильный, вам не нужно переформулировать весь запрос. Просто скажите, что не так — например, «Это меняет публичный API; сохраните сигнатуру той же.» Claude сохранит всё остальное и отрегулирует только эту точку.