ИНСТРУКЦИЯ · 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 его не видит.

Простое правило: записывайте то, что пришлось объяснить второй раз. Первый случай мог быть случайностью.

СЛЕДУЮЩИЙ ШАГ

Превратите знания в практику.

В статье — идеи. На живых занятиях в Zoom вы примените их к своему проекту с помощью объяснений, промптов и практики.