CLAUDE.md для команды: правила, которые не нужно повторять

Так вам реже придётся заново вводить Claude в курс дела. Возьмём условный расчёт: четыре разработчика тратят по три минуты на вводные в каждой из пяти сессий — итого 60 минут в неделю на повторение контекста. Общий файл инструкций позволяет хранить и обновлять эти вводные в одном месте. Сопоставляйте время, которое он экономит на повторениях, с затратами на его поддержку: гарантированной экономии здесь нет.

Что такое CLAUDE.md и для чего он нужен?

CLAUDE.md — это Markdown-файл с инструкциями, которые Claude Code читает для работы с проектом, с учётом ваших личных предпочтений или правил организации. Представьте его как постоянную памятку команды. Автоматическая память, или auto memory, — рабочий блокнот, который Claude ведёт рядом с ней. Памяткой управляете вы, блокнот заполняет Claude. И то и другое становится контекстом для его решений. Руководство Anthropic по памяти

Главный критерий — что должно сохранять силу от сессии к сессии. Обязательная команда запуска тестов относится к памятке. Замечание о том, что объяснение получилось слишком подробным, может сохраниться как выученное предпочтение. А текущей задаче место в разговоре.

Такое разделение соответствует официальному руководству по структуре каталога. Для начала не нужна большая папка .claude. Заведите памятку, а новые файлы добавляйте только под конкретную задачу.

Где хранить CLAUDE.md: проект, пользователь и организация

Небольшой команде достаточно добавить общий файл в корень репозитория и закоммитить его. Личные предпочтения храните в пользовательском файле, чтобы они случайно не распространились на коллег.

Эти области действия и пути описаны в документации. Управляемые файлы организации нельзя исключить через индивидуальные настройки, но их текст всё равно остаётся инструкцией рекомендательного характера.

При запуске Claude загружает файлы инструкций из рабочего каталога и всех родительских каталогов. Инструкции из вложенных каталогов подгружаются по мере работы с файлами внутри них. Содержимое файлов объединяется: более конкретный файл не отменяет противоречащие ему инструкции из других мест. Следите, чтобы пользовательские и проектные правила не конфликтовали. Как загружаются инструкции

Пример CLAUDE.md для небольшой продуктовой команды

Начните с решений, которые помогают не повторять одни и те же ошибки. Пример ниже рассчитан на продукт на TypeScript с pnpm и уже настроенными скриптами lint, typecheck и test. Прежде чем коммитить файл, замените команды и пути на те, которые вы проверили в своём репозитории.

В каждом разделе одной строкой объясняется его назначение. Это предлагаемые соглашения команды, а не настройки Anthropic по умолчанию.

# Product Team Instructions

## Product Intent
Why: Keep implementation tied to the customer problem.
- Read the task's acceptance criteria before changing code.
- Ask when missing product behavior would change the solution.

## Working Commands
Why: Make verification repeatable across teammates and sessions.
- Use pnpm for this repository; keep pnpm-lock.yaml consistent.
- Run pnpm lint and pnpm typecheck for application changes.
- Run pnpm test for behavior changes; report any checks not run.

## Change Boundaries
Why: Keep reviews small and dependencies deliberate.
- Follow nearby patterns before adding a new abstraction.
- Ask before adding a runtime dependency or changing public APIs.
- Keep unrelated cleanup out of the change.

## Data and Migrations
Why: Make data changes reviewable and reversible where possible.
- Add schema changes through the existing migration workflow.
- Describe compatibility and rollback concerns in the handoff.
- Use synthetic data in examples and tests.

## Quality
Why: Catch user-visible regressions before review.
- Add a focused regression test when fixing a behavior bug.
- Check loading, empty and error states when changing UI flows.
- State remaining uncertainty instead of calling unchecked work done.

## Project References
Why: Point to maintained decisions without copying the whole wiki.
- Read docs/product-decisions.md when product behavior is unclear.
- Read docs/release-checklist.md before preparing a release.

Ссылки в этом примере — обычные указания обращаться к документам по мере необходимости. Создайте эти документы или замените пути. Автоматический импорт здесь намеренно не используется.

Сохраните файл, запустите сессию из репозитория и выполните /context, чтобы проверить список файлов памяти, загруженных при старте. Через /memory можно открыть и отредактировать файл инструкций. Затем поручите Claude небольшую реальную задачу и посмотрите, помогают ли заданные команды и ограничения. Как проверить память

Выносите правила для отдельных типов файлов из общей памятки

Переносите правило в .claude/rules/, если большинству задач оно не нужно. Например, при изменении фронтенда незачем загружать все соглашения для обработчиков API.

Создайте .claude/rules/api.md с заголовком paths. Glob — это шаблон имени файла; src/api/**/*.ts выбирает TypeScript-файлы в указанном каталоге и его подкаталогах.

---
paths:
  - "src/api/**/*.ts"
---

# API Rules
- Validate external input before passing it to application logic.
- Use the existing error response format.
- Add a focused test when changing an endpoint's behavior.

Шаблон определяет, когда инструкция попадёт в контекст. Без paths правило безусловно загружается при старте. Если просто разбить длинную памятку на несколько файлов правил, контекст не уменьшится: для этого нужно ограничить область их загрузки. Правила для определённых путей

Импорт помогает переиспользовать текст, но не экономит контекст

Импорт вроде @docs/team-conventions.md внутри CLAUDE.md добавляет содержимое указанного файла в контекст при запуске. Относительный путь отсчитывается от файла, в котором записан импорт. Саму директиву импорта нужно размещать вне обратных кавычек и блоков кода Markdown: внутри них она остаётся обычным текстом. Импорт проектных файлов за пределами рабочего каталога требует подтверждения. Синтаксис импорта

Импортируйте короткое соглашение, которое уже поддерживает другая команда, если оно нужно в каждой сессии. Для длинного чек-листа релиза лучше оставить обычную ссылку, как в стартовом примере. Импорт меняет организацию памятки, но не объём текста, который Claude читает при запуске.

Уже есть AGENTS.md? Храните инструкции в одном месте

Начиная с версии 2.1.277, при наличии соответствующей поддержки Claude Code может читать AGENTS.md напрямую вместо CLAUDE.md. Но поведение по умолчанию зависит от важного условия: в рабочем каталоге и его родительских каталогах не должно быть ни CLAUDE.md, ни .claude/CLAUDE.md, ни CLAUDE.local.md. Пользовательские и организационные файлы инструкций не мешают этому резервному способу загрузки. Как загружается AGENTS.md

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

Если нужны оба файла, откройте /config и задайте для Project instructions значение claude-md-and-agents-md. Другой вариант — поместить @AGENTS.md в лежащий рядом CLAUDE.md: такой импорт работает и там, где прямая поддержка AGENTS.md недоступна. Не поддерживайте две копии одних и тех же правил команды. Подробнее о выборе — в нашем руководстве по настройке AGENTS.md.

Память Claude Code: что стоит доверить auto memory

Автоматическая память позволяет Claude сохранять полезные предпочтения, исправления и сведения о проекте между разговорами. Он сам решает, что стоит запомнить, и за отдельную сессию может не сохранить ничего. В локальных сессиях эта функция включена по умолчанию. Автоматическая память

По умолчанию файлы находятся в ~/.claude/projects/<project>/memory/. Рабочие деревья и подкаталоги одного репозитория используют общий каталог памяти на вашей машине. Рабочее дерево, или worktree, — ещё одна рабочая копия репозитория, поэтому работа над веткой в нём не создаёт отдельного блокнота. Эти файлы не передаются автоматически коллегам, на другие машины или в облачные среды. Где хранится память

MEMORY.md служит оглавлением. В начале сессии Claude загружает из него первые 200 строк или 25KB — в зависимости от того, какой предел достигнут раньше. Подробные тематические файлы он читает по необходимости. Это ограничение касается загрузки оглавления при старте, а не общего объёма заметок, которые можно хранить. Как загружается автоматическая память

Начинайте с /memory: команда показывает расположение памяти, открывает файлы в редакторе, даёт доступ к папке автоматической памяти и позволяет включать или выключать эту функцию. Через /context проверяйте, какие файлы CLAUDE.md и правил загрузились при запуске. Управление памятью

Явно указывайте, куда сохранить информацию. «Запомни, что я предпочитаю более короткие отчёты о проделанной работе» — просьба записать выученное предпочтение. «Добавь обязательную команду запуска тестов в CLAUDE.md» — просьба обновить поддерживаемую инструкцию. Правило, нужное всей команде, не должно зависеть от заметки в домашнем каталоге одного разработчика.

Не рассчитывайте, что обычный субагент получит этот блокнот. Автоматическая память основного разговора не загружается в обычные субагенты; исключение — форки, наследующие родительский разговор. У субагентов также может быть собственная настроенная память. Если распределяете работу между агентами, обратитесь к нашему руководству по субагентам Claude Code. Как устроена память субагентов

Как отключить автоматическую память?

Выберите способ в зависимости от задачи:

• Для своего пользователя: откройте /memory и выключите автоматическую память. Переключатель сохраняет параметр autoMemoryEnabled в ~/.claude/settings.json.
• Для одного проекта: установите "autoMemoryEnabled": false в его настройках. Для общей настройки проекта используйте .claude/settings.json, для личного переопределения — .claude/settings.local.json.
• При запуске через переменную окружения: задайте CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.

Эти способы отключения и расположение файлов настроек описаны в документации. Отключение автоматической памяти не мешает работе отдельного механизма инструкций CLAUDE.md. Если нужно убрать и старые заметки, просмотрите и удалите соответствующие Markdown-файлы вручную.

Как раз в месяц наводить порядок в памяти

Это короткая редакторская проверка того, что Claude возьмёт с собой в дальнейшую работу. Ежемесячный ритм — предлагаемая привычка команды, а не требование продукта.

1. Откройте /memory и перейдите в папку автоматической памяти. Прочитайте MEMORY.md, затем пройдите по ссылкам к самим заметкам.
2. Удалите устаревший контекст. Уберите прошедшие сроки, отменённые планы и исключения, которые больше не действуют. Сомнительные заметки сверьте с текущим состоянием проекта.
3. Объедините повторяющиеся исправления. Вместо нескольких немного различающихся версий оставьте одну точную формулировку.
4. Перенесите постоянные решения команды в общие инструкции. Соглашение, нужное всем, поместите в закоммиченный CLAUDE.md или правило с ограниченной областью действия, а дублирующую личную заметку удалите.
5. Сократите оглавление. В MEMORY.md оставьте короткие указатели, а подробности вынесите в тематические файлы. Проверьте и число строк, и размер в байтах относительно лимита загрузки при старте.
6. Начните новую сессию. Проверьте список инструкций через /context и на следующей реальной задаче убедитесь, что устаревшие советы больше не всплывают.

Файлы автоматической памяти — редактируемые Markdown-документы. Правила хранения истории разговоров не очищают их автоматически. Удалять неактуальные заметки всё равно должен кто-то из людей. Редактирование и хранение

Пять ситуаций, в которых такая настройка помогает

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

Две небольшие идеи для продукта или услуги

Самая перспективная возможность — аудит инструкций в репозитории. Небольшая команда могла бы заплатить за проверку команд, поиск противоречий в правилах и подготовку короткой памятки с правилами для отдельных областей проекта. Минимальный полезный результат — проверенный pull request и чек-лист для повторного аудита. По оценке DataForSEO, в США фразу «claude project instructions» ищут 260 раз в месяц. Это широкий запрос: интерес к нему выходит за рамки Claude Code. Он указывает на возможность привлечь аудиторию, но не на число покупателей. Универсальный шаблон легко скопировать, поэтому ценность платной услуги должна заключаться в разборе конкретного репозитория.

Локальный отчёт о состоянии памяти мог бы помочь командам с большим числом активных репозиториев. В первой версии такой инструмент мог бы отмечать слишком большие оглавления, ссылки на отсутствующие тематические файлы и предположительно устаревшие заметки, а затем передавать правки разработчику на проверку. По оценке DataForSEO, в США фразу «claude code memory» ищут 1,300 раз в месяц. Это свидетельство интереса к проблеме, а не спроса на конкретный инструмент. Есть серьёзное ограничение: по возрасту файла нельзя понять, устарело ли решение. Содержательные решения должен принимать человек, который знает проект.

Обе оценки — данные обзора англоязычных ключевых слов для США, полученные 11 октября 2026 года через интеграцию сайта с DataForSEO для исследований. Это идеи продуктов, а не встроенные возможности Claude Code. Для одного небольшого репозитория начните с файла инструкций и ежемесячной проверки, прежде чем покупать или создавать что-то из предложенного.

Память задаёт контекст, но не обеспечивает соблюдение правил

Фраза «никогда этого не делай» в CLAUDE.md не делает действие невозможным. То же относится к автоматической памяти и текстовым инструкциям всей организации. Claude может неверно истолковать расплывчатое указание или столкнуться с противоречащими друг другу правилами. Предупреждение Anthropic

Если действие нужно блокировать независимо от решения Claude, используйте хук PreToolUse — механизм, который срабатывает перед действием инструмента. Напоминание о защищённых файлах может объяснить намерения команды, но для блокировки нужен реализованный технический контроль. Настройка описана в нашем руководстве по хукам Claude Code.

Что касается объёма контекста, ориентируйтесь на памятку, которую реально поддерживать в актуальном состоянии. Anthropic рекомендует делать отдельные файлы CLAUDE.md короче 200 строк, но эта рекомендация не связана с лимитом загрузки MEMORY.md при старте. Не раздувайте стартовый файл ради воображаемой нормы и не считайте, что перенос всего текста в импорты сократит расход контекста. Как писать эффективные инструкции

Частые вопросы небольших команд

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

Если нужна помощь, чтобы превратить эти соглашения в надёжный процесс разработки, посмотрите нашу услугу разработки ИИ-систем для продакшена.