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 worktrees.

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

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

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

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

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

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

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

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

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

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

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

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

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

Лучшие практики работы с памятью

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