Управление памятью Claude
Узнайте, как управлять памятью Claude Code между сессиями с различными местоположениями памяти и лучшими практиками.
Claude Code может запоминать ваши предпочтения между сессиями, такие как руководящие принципы стиля и общие команды в вашем рабочем процессе.
Определение типа памяти
Claude Code предлагает три местоположения памяти, каждое из которых служит разной цели:
Тип памяти | Местоположение | Назначение | Примеры использования |
---|---|---|---|
Память проекта | ./CLAUDE.md | Инструкции для проекта, общие для команды | Архитектура проекта, стандарты кодирования, общие рабочие процессы |
Память пользователя | ~/.claude/CLAUDE.md | Личные предпочтения для всех проектов | Предпочтения стиля кода, ярлыки личных инструментов |
Память проекта (локальная) | ./CLAUDE.local.md | Личные предпочтения, специфичные для проекта | (Устарело, см. ниже) Ваши URL песочницы, предпочтительные тестовые данные |
Все файлы памяти автоматически загружаются в контекст Claude Code при запуске.
Импорты CLAUDE.md
Файлы CLAUDE.md могут импортировать дополнительные файлы, используя синтаксис @path/to/import
. Следующий пример импортирует 3 файла:
Разрешены как относительные, так и абсолютные пути. В частности, импорт файлов в домашней директории пользователя - это удобный способ для членов вашей команды предоставить индивидуальные инструкции, которые не проверяются в репозиторий. Ранее CLAUDE.local.md служил аналогичной цели, но теперь устарел в пользу импортов, поскольку они лучше работают в нескольких git рабочих деревьях.
Чтобы избежать потенциальных коллизий, импорты не оцениваются внутри markdown кодовых промежутков и блоков кода.
Импортированные файлы могут рекурсивно импортировать дополнительные файлы с максимальной глубиной 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 для вашей кодовой базы с помощью следующей команды:
Советы:
- Включайте часто используемые команды (сборка, тестирование, линтинг), чтобы избежать повторных поисков
- Документируйте предпочтения стиля кода и соглашения по именованию
- Добавляйте важные архитектурные паттерны, специфичные для вашего проекта
- Воспоминания CLAUDE.md могут использоваться как для инструкций, общих с вашей командой, так и для ваших индивидуальных предпочтений.
Лучшие практики памяти
- Будьте конкретными: “Используйте отступы в 2 пробела” лучше, чем “Форматируйте код правильно”.
- Используйте структуру для организации: Форматируйте каждое отдельное воспоминание как пункт списка и группируйте связанные воспоминания под описательными markdown заголовками.
- Периодически пересматривайте: Обновляйте воспоминания по мере развития вашего проекта, чтобы убедиться, что Claude всегда использует самую актуальную информацию и контекст.