ИНСТРУКЦИЯ · 6 МИН. ЧТЕНИЯ
Как работать с памятью Claude
Вы в пятый раз объяснили Claude одно и то же, а он снова сделал по-своему. Разбираемся, как устроена его память и почему ваши правила не работают.
Новая сессия начинается с пустого окна: между запусками передаются файлы, а не прошлый диалог. Правила пишете вы, автоматическую память агент ведёт для себя.
Правила передаются как обычные инструкции, а не жёсткая конфигурация. Claude читает их и старается соблюдать, но абсолютной гарантии исполнения нет.
Структура на диске: ~/.claude/ ├── CLAUDE.md — общие привычки ├── rules/ — личные правила └── projects/ — автоматическая память my-app/ ├── CLAUDE.md — правила проекта ├── CLAUDE.local.md — личные, в gitignore └── .claude/ ├── rules/ — правила по темам ├── skills/ — процедуры └── settings.json — hooks
Две папки .claude
Название одинаковое, область действия разная. Папка в домашнем каталоге действует во всех проектах компьютера, папка внутри проекта — только в нём.
Если дизайн-системы проектов различаются, храните их внутри соответствующих проектов. Тогда правила одного проекта не попадут в соседний.
CLAUDE.md
В домашней папке — общие привычки: язык ответов, менеджер пакетов и постоянные запреты.
В корне проекта — команды запуска и тестов, стиль, архитектура и особенности. Файл хранится в Git и доступен команде. Рядом CLAUDE.local.md — личные порты, тестовый пользователь и ссылки на стенд.
Пример CLAUDE.md: # Мой проект ## Команды npm run dev — сервер на порту 5173 npm run build — сборка в dist npm run typecheck — проверка типов ## Ограничения Не добавляй зависимости без обсуждения. Не меняй папку миграций. ## Особенности Порт 6006 занят другим проектом. Запускай Storybook на 6007.
Особенности — самая полезная часть. Команды Claude может найти в package.json, а о занятом порте сам не узнает и будет сталкиваться с ним заново.
Файлы объединяются. Если инструкции противоречат друг другу, Claude может выбрать одну без уведомления.
Около 200 строк — ориентир. В файле на 400 строк важное теряется. Проверяйте каждую строку: станет ли агент ошибаться без неё? Если нет, уберите.
Правила по темам
Всё, что раздувает основной файл, вынесите в .claude/rules: отдельно дизайн-система, работа с базой и тесты.
Для правила можно указать маску: загружать только при открытии подходящих файлов, например компонентов. Claude добавляет соответствующее правило к контексту.
Маска задаётся в заголовке файла перед текстом правила. ** означает произвольную вложенность папок, * — произвольные символы в имени.
Пример .claude/rules/layout.md: --- name: layout description: Правила страниц paths: - "src/**/*.tsx" - "**/*.stories.tsx" --- # Правила страниц Далее текст правила.
Триггер — чтение файла. Если Claude создаёт новый компонент, ничего не открывая, правило с маской может не загрузиться. Правила, нужные при создании файлов, храните без маски.
Навыки
Навык — папка с SKILL.md. При запуске в контекст попадают только имя и описание; полное содержание читается при необходимости.
Пример skills/deploy/SKILL.md: --- name: deploy description: Публикация релиза. Используй при просьбе развернуть проект, выпустить версию или откатить релиз. --- # Публикация релиза Далее шаги процедуры.
Модель видит описание и решает, открывать ли навык. Описание — триггер: пишите конкретно, словами, которыми формулируете задачу. «О релизах» слишком расплывчато.
Навыки подходят для процедур: публикации, разбора инцидента, подготовки релиза. Они не привязаны к одному типу файла.
Hooks
Инструкции модель может пропустить. Hook исполняется независимо от её решения.
Это команда, запускаемая при событии: проверить линтером после изменения, измерить размер файла или запретить запись в папку миграций.
Пример .claude/settings.json: { "hooks": { "PostToolUse": [ { "matcher": "Write|Edit", "hooks": [ { "type": "command", "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/lint.sh" } ] } ] } }
PostToolUse — после выполнения инструмента. matcher — какие инструменты отслеживать, здесь запись и редактирование. command — выполняемая команда. Внутри обычный shell-скрипт, который вы пишете сами.
Путь задан через переменную не случайно: $CLAUDE_PROJECT_DIR указывает корень проекта, а hook может запускаться из другой папки. Относительный путь тогда укажет не туда.
Автоматическая память
Это файлы, которые Claude ведёт для себя. Для сохранения скажите в чате, например: «Запомни, что тестам нужен локальный Redis».
Здесь 200 строк — уже жёсткая граница загрузки. Содержимое дальше неё не попадает в контекст: у файла на 400 строк половина окажется невидимой.
Порядок с нуля
Запустите /init, чтобы получить черновик правил проекта. Сократите его по критерию «без этого агент ошибётся?». Правила отдельных частей кода вынесите в rules, процедуры — в skills, обязательные автоматические действия — в hooks, личные настройки — в local.
Затем выполните /context: команда показывает, что действительно загружено в сессию. Если файла там нет, Claude его не видит.
Простое правило: записывайте то, что пришлось объяснить второй раз. Первый случай мог быть случайностью.


