Claude Code может запоминать ваши предпочтения между сессиями, такие как руководящие принципы стиля и общие команды в вашем рабочем процессе.

Определение типа памяти

Claude Code предлагает три местоположения памяти, каждое из которых служит разной цели:

Тип памятиМестоположениеНазначениеПримеры использования
Память проекта./CLAUDE.mdИнструкции для проекта, общие для командыАрхитектура проекта, стандарты кодирования, общие рабочие процессы
Память пользователя~/.claude/CLAUDE.mdЛичные предпочтения для всех проектовПредпочтения стиля кода, ярлыки личных инструментов
Память проекта (локальная)./CLAUDE.local.mdЛичные предпочтения, специфичные для проекта(Устарело, см. ниже) Ваши URL песочницы, предпочтительные тестовые данные

Все файлы памяти автоматически загружаются в контекст Claude Code при запуске.

Импорты CLAUDE.md

Файлы CLAUDE.md могут импортировать дополнительные файлы, используя синтаксис @path/to/import. Следующий пример импортирует 3 файла:

См. @README для обзора проекта и @package.json для доступных npm команд для этого проекта.

# Дополнительные инструкции
- git рабочий процесс @docs/git-instructions.md

Разрешены как относительные, так и абсолютные пути. В частности, импорт файлов в домашней директории пользователя - это удобный способ для членов вашей команды предоставить индивидуальные инструкции, которые не проверяются в репозиторий. Ранее CLAUDE.local.md служил аналогичной цели, но теперь устарел в пользу импортов, поскольку они лучше работают в нескольких git рабочих деревьях.

# Индивидуальные предпочтения
- @~/.claude/my-project-instructions.md

Чтобы избежать потенциальных коллизий, импорты не оцениваются внутри markdown кодовых промежутков и блоков кода.

Этот кодовый промежуток не будет рассматриваться как импорт: `@anthropic-ai/claude-code`

Импортированные файлы могут рекурсивно импортировать дополнительные файлы с максимальной глубиной 5 переходов. Вы можете увидеть, какие файлы памяти загружены, выполнив команду /memory.

Как Claude ищет воспоминания

Claude Code читает воспоминания рекурсивно: начиная с cwd, Claude Code рекурсивно поднимается до / и читает любые файлы CLAUDE.md или CLAUDE.local.md, которые находит. Это особенно удобно при работе в больших репозиториях, где вы запускаете Claude Code в foo/bar/, и имеете воспоминания как в foo/CLAUDE.md, так и в foo/bar/CLAUDE.md.

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

Быстрое добавление воспоминаний с помощью ярлыка #

Самый быстрый способ добавить воспоминание - начать ваш ввод с символа #:

# Всегда используйте описательные имена переменных

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

Прямое редактирование воспоминаний с помощью /memory

Используйте слэш-команду /memory во время сессии, чтобы открыть любой файл памяти в вашем системном редакторе для более обширных дополнений или организации.

Настройка памяти проекта

Предположим, вы хотите настроить файл CLAUDE.md для хранения важной информации о проекте, соглашений и часто используемых команд.

Создайте CLAUDE.md для вашей кодовой базы с помощью следующей команды:

> /init 

Советы:

  • Включайте часто используемые команды (сборка, тестирование, линтинг), чтобы избежать повторных поисков
  • Документируйте предпочтения стиля кода и соглашения по именованию
  • Добавляйте важные архитектурные паттерны, специфичные для вашего проекта
  • Воспоминания CLAUDE.md могут использоваться как для инструкций, общих с вашей командой, так и для ваших индивидуальных предпочтений.

Лучшие практики памяти

  • Будьте конкретными: “Используйте отступы в 2 пробела” лучше, чем “Форматируйте код правильно”.
  • Используйте структуру для организации: Форматируйте каждое отдельное воспоминание как пункт списка и группируйте связанные воспоминания под описательными markdown заголовками.
  • Периодически пересматривайте: Обновляйте воспоминания по мере развития вашего проекта, чтобы убедиться, что Claude всегда использует самую актуальную информацию и контекст.