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

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

Начальный

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

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

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

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

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

Claude Code загружает память из нескольких мест и объединяет их в порядке загрузки, начиная с самой широкой области действия, — поэтому инструкция проекта попадает в контекст после пользовательской инструкции:

  • Управляемая политика — инструкции уровня организации, которые поставляет ваша команда IT/DevOps. Путь зависит от ОС: /Library/Application Support/ClaudeCode/CLAUDE.md на macOS, /etc/claude-code/CLAUDE.md на Linux и WSL, C:\Program Files\ClaudeCode\CLAUDE.md на Windows.
  • Пользовательские инструкции (~/.claude/CLAUDE.md) — ваши личные предпочтения во всех проектах.
  • Инструкции проекта (./CLAUDE.md или ./.claude/CLAUDE.md, закоммичены) — как устроен этот репозиторий. Общие с вашей командой. Если в вашем репозитории используется AGENTS.md, он может загружаться вместо этих файлов или вместе с ними.
  • Локальные инструкции (./CLAUDE.local.md) — заметки по проекту только для вас, например URL песочницы. Добавьте файл в .gitignore.

Файлы в иерархии каталогов выше вашего рабочего каталога загружаются при запуске; файлы в подкаталогах загружаются по требованию, когда Claude обращается к чему-то в этой области.

Pro tip
  • Один файл стал тесен? Разнесите инструкции по .claude/rules/*.md — по одной теме на файл, они обнаруживаются рекурсивно. Правила без frontmatter paths загружаются при запуске с тем же приоритетом, что и .claude/CLAUDE.md; добавьте frontmatter paths, чтобы правило загружалось только тогда, когда Claude работает с подходящими файлами, — это экономит контекст.
Изучите слои памяти
Нажмите Enter или пробел, чтобы перевернуть карточку. Используйте стрелки влево и вправо для перехода между карточками.Показан термин.
1 / 6

Вторая половина: автопамять​

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

Файлы CLAUDE.mdАвтопамять
Кто пишетВыClaude
Что содержитИнструкции и правилаВыводы и закономерности
Область действияПроект, пользователь или организацияОтдельно для каждого репозитория, общая для всех worktree

И то, и другое — контекст, а не принуждение: Claude относится к ним как к рекомендациям, которые можно взвесить, а не как к конфигурации, которой он обязан подчиняться. Чтобы жёстко заблокировать действие независимо от того, что решит Claude, используйте хук PreToolUse.

Watch out
  • Автопамять загружает только первые 200 строк или 25 КБ — раздутый MEMORY.md молча обрезается. Полную разбивку стоимости запуска смотрите в Аудите бюджета контекста.

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

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

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

/init

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

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

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

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

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

Импорты​

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

Две ловушки синтаксиса, о которых стоит узнать до того, как они вас укусят:

  • Пробелы требуют обратных слэшей. @Design\ Docs/api-conventions.md работает; без обратного слэша путь обрывается на первом пробеле. А если взять его в кавычки, файл не импортируется вовсе.
  • Обратные кавычки отключают импорт. Разбор импортов пропускает code-спаны и огороженные блоки, поэтому `@README` остаётся обычным текстом, а @README сам по себе импортирует файл. Так можно упомянуть путь, не загружая его.

Полный справочник смотрите в официальной документации по памяти.

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

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

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

0/6
  1. Какой файл Claude Code читает в начале каждой сессии как постоянный брифинг по вашему проекту?
  2. Что делает выполнение /init в проекте?
  3. Какой рекомендуемый способ включить большой существующий документ, например гайд по стилю?
  4. Куда помещать личные заметки по конкретному проекту — те, которые вы не хотите коммитить?
  5. Кто пишет автопамять?
  6. Когда загружается CLAUDE.md, лежащий в подкаталоге?
Key takeaways
  • CLAUDE.md — настройка с максимальной отдачей: она сразу улучшает каждую будущую сессию.
  • Память загружается от самого широкого слоя: управляемая политика, затем пользовательский (~/.claude/CLAUDE.md), проектный (./CLAUDE.md или ./.claude/CLAUDE.md), затем локальный (./CLAUDE.local.md). Файлы в подкаталогах загружаются по требованию.
  • Автопамять — вторая половина: собственные заметки Claude, отдельно для каждого репозитория, загружаются в каждую сессию. И то, и другое — контекст, а не принуждение: чтобы жёстко что-то заблокировать, используйте хук.
  • Один файл стал тесен? Разнесите его по .claude/rules/*.md и ограничьте область правил через frontmatter paths.
  • Начните с /init, затем сократите черновик до того, что действительно верно.
  • Держите его коротким и правдивым — используйте @imports (максимум четыре перехода) для больших документов и никогда не коммить секреты.

Дальше​