Перейти к основному содержимому

CLAUDE.md и файлы памяти

Начальный

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

What you'll learn
  • Почему CLAUDE.md — единственная настройка Claude Code с максимальной отдачей
  • Как иерархия памяти объединяется от глобального к специфичному для проекта
  • Как сгенерировать стартовый файл с помощью /init и сократить его
  • Что должно быть в CLAUDE.md — и что туда не стоит включать
  • Как @imports позволяют ссылаться на документы, не дублируя их

Почему это настройка с максимальной отдачей​

Без него вы заново объясняете свой проект каждую сессию («мы используем pnpm, тесты лежат в __tests__, не трогай /generated…»). С ним Claude уже всё знает. Хорошие инструкции здесь сразу улучшают каждое будущее взаимодействие.

Иерархия памяти​

Claude Code читает память из нескольких мест и объединяет их, примерно от наиболее глобального к наиболее специфичному:

  • Пользовательская память — ваши личные предпочтения во всех проектах.
  • Память проекта (./CLAUDE.md, закоммичена) — как устроен этот репозиторий. Общая с вашей командой.
  • Вложенная — положите CLAUDE.md в подпапку для правил, которые действуют только там.
Изучите слои памяти
Нажмите Enter или пробел, чтобы перевернуть карточку. Используйте стрелки влево и вправо для перехода между карточками.Показан термин.
1 / 4

Сгенерируйте отправную точку​

Guided walkthrough1 of 3
  1. Claude анализирует код и автоматически составляет для вас черновик CLAUDE.md.

Сгенерировать черновик CLAUDE.md

/init

Возьмите готовую заготовку в Шаблонах CLAUDE.md.

Что в него класть​

  • Что представляет собой проект, в двух предложениях.
  • Технологический стек и как его запускать / тестировать / линтить.
  • Соглашения, которые Claude не может вывести сам (именование, структура, стиль коммитов).
  • Ограничители: «прогоняй тесты, прежде чем объявлять работу завершённой», «никогда не редактируй /vendor», «никогда не коммить секреты».

Что в него НЕ класть​

Watch out
  • Claude следует CLAUDE.md буквально — устаревшие, расплывчатые или желаемые-за-действительное инструкции активно вредят.
  • Описывайте, как проект на самом деле работает сегодня; короткое и правдивое лучше длинного и мечтательного.
  • Избегайте огромных вставленных документов (вместо этого используйте @imports), секретов и правил, которым вы на самом деле не следуете.
  • Периодически пересматривайте файл, чтобы он оставался точным по мере развития проекта.

Импорты​

Подтягивайте существующие документы вместо их дублирования — например, ссылайтесь на ваш гайд по стилю через импорт @path/to/file, чтобы был единый источник истины. Точный синтаксис смотрите в официальной документации по памяти.

Pro tip
  • Единый источник истины: ссылайтесь на файл через @imports, а не вставляйте его содержимое в CLAUDE.md.
  • Если документ уже существует, дайте на него ссылку — не копируйте его. Копии устаревают.

Проверьте себя​

Проверьте себя

0/3
  1. Какой файл Claude Code читает в начале каждой сессии как постоянный брифинг по вашему проекту?
  2. Что делает выполнение /init в проекте?
  3. Какой рекомендуемый способ включить большой существующий документ, например гайд по стилю?
Key takeaways
  • CLAUDE.md — настройка с максимальной отдачей: она сразу улучшает каждую будущую сессию.
  • Память объединяется от глобального к специфичному: enterprise-политика, затем пользовательские, проектные и вложенные файлы CLAUDE.md.
  • Начните с /init, затем сократите черновик до того, что действительно верно.
  • Включите краткое описание проекта, команды запуска/тестов/линта, соглашения и ограничители.
  • Держите его коротким и правдивым — используйте @imports для больших документов и никогда не коммить секреты.

Дальше​