Управление памятью Claude
Узнайте, как управлять памятью Claude Code между сессиями с различными местоположениями памяти и лучшими практиками.
Claude Code может запоминать ваши предпочтения между сессиями, такие как руководящие принципы стиля и общие команды в вашем рабочем процессе.
Определение типа памяти
Claude Code предлагает четыре местоположения памяти в иерархической структуре, каждое из которых служит разной цели:
Тип памяти | Местоположение | Назначение | Примеры использования | Доступно для |
---|---|---|---|---|
Корпоративная политика | macOS: /Library/Application Support/ClaudeCode/CLAUDE.md Linux: /etc/claude-code/CLAUDE.md Windows: C:\ProgramData\ClaudeCode\CLAUDE.md | Инструкции для всей организации, управляемые IT/DevOps | Стандарты кодирования компании, политики безопасности, требования соответствия | Все пользователи в организации |
Память проекта | ./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 могут использоваться как для инструкций, разделяемых с вашей командой, так и для ваших индивидуальных предпочтений.
Управление памятью на уровне организации
Корпоративные организации могут развертывать централизованно управляемые файлы CLAUDE.md, которые применяются ко всем пользователям.
Чтобы настроить управление памятью на уровне организации:
- Создайте файл корпоративной памяти в соответствующем местоположении для вашей операционной системы:
- macOS:
/Library/Application Support/ClaudeCode/CLAUDE.md
- Linux/WSL:
/etc/claude-code/CLAUDE.md
- Windows:
C:\ProgramData\ClaudeCode\CLAUDE.md
- Разверните через вашу систему управления конфигурацией (MDM, Group Policy, Ansible и т.д.), чтобы обеспечить последовательное распространение на всех машинах разработчиков.
Лучшие практики памяти
- Будьте конкретными: “Используйте отступ в 2 пробела” лучше, чем “Форматируйте код правильно”.
- Используйте структуру для организации: Форматируйте каждое отдельное воспоминание как маркированный пункт и группируйте связанные воспоминания под описательными заголовками markdown.
- Периодически пересматривайте: Обновляйте воспоминания по мере развития вашего проекта, чтобы убедиться, что Claude всегда использует самую актуальную информацию и контекст.