Четыре уровня CLAUDE.md

Почему это важно именно вам

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

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

С CLAUDE.md вы настраиваете контекст один раз — и он применяется автоматически. Но есть нюанс: один файл не решает всё. Правила для личной переписки мешают работе с рабочими проектами. Настройки конкретного проекта не нужны в остальных папках. Именно поэтому Claude Code поддерживает четыре уровня — от глобального до проектного.

Что это такое

Четыре уровня CLAUDE.md — это как папки полномочий в компании. Разные уровни применяются в разных ситуациях, более конкретные перекрывают более общие.

Аналогия из жизни. В компании есть корпоративный регламент (для всех), инструкция отдела маркетинга (для отдела), правила конкретного проекта «Запуск нового продукта» (для команды проекта) и личные заметки менеджера в рабочей папке (только для себя). Это ровно те же четыре уровня.

Важно понять: CLAUDE.md — это не «настройки» в привычном смысле, не галочки в интерфейсе. Это текстовый файл, который Claude читает в начале каждого разговора. Он просто добавляет содержимое этого файла к вашему запросу — невидимо для вас, но весомо для результата. Именно поэтому написать там «кратко и по делу» реально работает: Claude буквально видит эту инструкцию перед тем, как отвечать.

Каждый раз, когда вы запускаете Claude в какой-либо папке, он ищет файлы контекста по цепочке: от самого общего к самому конкретному. Нашёл — прочитал. Не нашёл — пропустил. Всё прочитанное объединяется в единый контекст. Это и есть механизм четырёх уровней.

Вот как они называются у Claude:

Уровень 1 — Managed Policy (/Library/Application Support/ClaudeCode/CLAUDE.md на macOS). Системный уровень, который устанавливает администратор. В корпоративной среде это правила для всей организации: запреты, требования к конфиденциальности, обязательные форматы отчётов. Если вы работаете на личном ноутбуке — этого файла скорее всего нет, и создавать его не нужно. Но если работаете в компании с IT-отделом, именно там могут лежать корпоративные ограничения.

Уровень 2 — User (~/.claude/CLAUDE.md). Ваши личные глобальные настройки. Применяются в любой папке, в любом проекте. Именно здесь описываете, кто вы, как предпочитаете общаться, какие форматы ответов удобны. Этот файл существует на вашем компьютере в домашней папке и читается всегда — независимо от того, в какой папке вы сейчас работаете. Именно с него стоит начать.

Уровень 3 — Project (./.claude/CLAUDE.md или ./CLAUDE.md в корне проекта). Настройки конкретной рабочей папки. Когда вы открываете Claude в папке «Маркетинг Q2» — он читает именно этот файл. Здесь описываете контекст проекта, специфику задач, профессиональные термины, которые не надо объяснять, ограничения на работу с данными. Claude ищет этот файл в текущей папке и рекурсивно вверх по дереву папок — так что если запустить Claude в подпапке проекта, он найдёт CLAUDE.md в родительской папке.

Уровень 4 — Local (./CLAUDE.local.md). Личные настройки поверх проектных. Не попадают в git. Удобно, если над проектом работает несколько людей, а у вас есть личные предпочтения, которые другим не нужны. Например, вы хотите, чтобы Claude при работе с этим проектом всегда сначала показывал сводку, а потом детали — но это ваш стиль, не командной стандарт.

Приоритет работает снизу вверх

Более конкретный уровень добавляет контекст к более общему. Файл проекта не отменяет глобальный — Claude читает оба. Но если в глобальном написано «отвечай кратко», а в проектном — «давай развёрнутые пояснения с примерами», проектная инструкция будет приоритетнее.

Как работает на практике

Уровень 2: User — ваш личный профиль

Откройте файл:

nano ~/.claude/CLAUDE.md

Это ваш глобальный профиль. Он читается в любой папке, при любом запросе. Пишите здесь то, что справедливо всегда и везде.

Пример содержимого для директора:

# Профиль пользователя

## Кто я
Директор по развитию. Работаю с документами, отчётами, письмами, аналитикой.
Технически грамотен, но не разработчик.

## Стиль общения
- Отвечай по-русски
- Сначала суть, потом детали
- Без вводных конструкций ("Конечно!", "Отличный вопрос!")
- Не объясняй очевидное
- Если неуверен — скажи прямо, не выдавай гипотезу за факт

## Форматы
- Таблицы для сравнений и списков данных
- Bullet-списки для шагов и рекомендаций
- Заголовки в отчётах для структуры
- Markdown по умолчанию

## Ограничения
- Не упоминай имена клиентов и контрагентов без явного запроса
- Рабочие данные — конфиденциальны

После сохранения — Claude читает это при каждом запуске из любой папки.

Уровень 3: Project — контекст рабочей папки

Создайте папку .claude внутри вашей рабочей папки:

mkdir -p ~/работа/маркетинг/.claude
nano ~/работа/маркетинг/.claude/CLAUDE.md

Здесь — всё специфичное для этой папки. Проекты, термины, правила работы с конкретными документами.

Пример для папки маркетинга:

# Маркетинг — рабочая папка

## Контекст
Это папка маркетинговых материалов и аналитики.
Основные задачи: анализ отчётов, подготовка презентаций, работа с данными по каналам.

## Специфика
- Данные по KPI: CTR, CPL, ROAS, CPA — это профессиональные термины, объяснять не нужно
- «Каналы» — источники трафика (Яндекс.Директ, таргет, SEO)
- «Бюджет» считается в рублях, если не указано иное
- Партнёры и подрядчики упоминаются по кодовым именам из реестра

## Форматы вывода
- Для аналитики — таблицы с числами
- Для рекомендаций — нумерованные списки
- Для сводок — резюме + развёрнутый раздел

## Файлы в папке
- отчёты/ — выгрузки из систем аналитики
- планы/ — медиапланы и бюджеты
- материалы/ — тексты и баннеры

Два варианта размещения

Проектный CLAUDE.md можно положить либо в .claude/CLAUDE.md внутри папки, либо прямо в корне как CLAUDE.md. Оба варианта работают. Папка .claude/ удобнее: всё, что связано с Claude, лежит в одном месте.

Уровень 4: Local — личные настройки поверх проекта

В той же папке, рядом с CLAUDE.md:

nano ~/работа/маркетинг/CLAUDE.local.md

Пример:

# Личные настройки (не для git)

## Мои предпочтения
- В аналитических задачах — сначала показывай тренды, потом детали
- Я сам в курсе структуры папок, не объясняй её в ответах
- При работе с бюджетами — всегда добавляй итоговую строку

## Рабочие пути (мой ноутбук)
- Основные выгрузки: ~/Downloads/аналитика/
- Шаблоны: ~/работа/шаблоны/

CLAUDE.local.md не должен попадать в git

Если папка с проектом синхронизируется через git или облако с коллегами — добавьте CLAUDE.local.md в .gitignore. Этот файл для личных настроек, которые не нужны другим.

Как проверить, что Claude читает ваши файлы

Запустите Claude в папке и спросите:

claude
/context

В разделе Memory files будет фактический список загруженных файлов. Спрашивать модель «что у тебя загружено» — не проверка: она может ответить по памяти, а не по факту. Если что-то не подгружается — проверьте путь к файлу.

Ещё один способ проверки — намеренно написать в CLAUDE.md что-то уникальное и проверить, работает ли это:

# Тест контекста
При любом запросе начинай ответ с фразы "Контекст загружен."

Сохранили, запустили Claude, написали любой вопрос. Если ответ начинается с «Контекст загружен» — файл читается. Потом уберите этот тест.

Что писать в каждом уровне: практические примеры

Чтобы не гадать, что куда класть, вот конкретная разбивка по типам инструкций.

В глобальный ~/.claude/CLAUDE.md:
- Ваша роль и сфера работы
- Предпочтения в стиле общения
- Язык ответов
- Форматы по умолчанию (таблицы, bullet-списки, заголовки)
- Базовые ограничения (не упоминать конфиденциальные данные)
- Часовой пояс и локальные особенности (если важны)

В проектный .claude/CLAUDE.md:
- Что это за папка и какие задачи здесь решаются
- Специфические термины, аббревиатуры, названия
- Структура данных в папке: что где лежит
- Правила работы с конкретными типами документов
- Особые форматы вывода для этого проекта
- Кодовые имена или маскировка конкретных данных

В CLAUDE.local.md:
- Личные рабочие пути на вашем конкретном компьютере
- Предпочтения, которые не нужны коллегам
- Временные инструкции для текущего этапа работы
- Напоминания для себя

Реальная структура для директора

Вот практичная структура, с которой удобно работать:

~/.claude/CLAUDE.md                         # глобальный профиль: кто вы, стиль

~/работа/
├── маркетинг/
│   ├── .claude/
│   │   └── CLAUDE.md                       # контекст маркетинга
│   └── CLAUDE.local.md                     # личные предпочтения
│
├── финансы/
│   ├── .claude/
│   │   └── CLAUDE.md                       # контекст финансов
│   └── CLAUDE.local.md
│
└── договоры/
    └── .claude/
        └── CLAUDE.md                       # контекст юридических документов

Каждая рабочая папка — свой контекст. Claude автоматически подхватывает нужный файл в зависимости от того, из какой папки вы его запустили.

Частые ошибки

Ошибка 1. Писать всё в глобальный файл

Глобальный ~/.claude/CLAUDE.md читается всегда. Если туда положить контекст конкретного проекта — он будет мешать при работе в других папках. Правило простое: если инструкция справедлива для любой задачи — в глобальный. Если только для конкретной папки — в проектный.

Признак проблемы: в глобальном файле больше 30-40 строк специфичных инструкций. Это сигнал, что часть надо перенести на проектный уровень.

Ошибка 2. Конфликтующие инструкции на разных уровнях

Если в глобальном написано «всегда отвечай кратко, не больше 5 предложений», а в проектном — «давай подробные объяснения с примерами», Claude будет пытаться совместить несовместимое. Результат — непредсказуемый.

Как исправить: в проектном файле явно напишите, что перекрывает глобальное. «В этом проекте — развёрнутые ответы, глобальное правило "кратко" не применяется».

Ошибка 3. Класть CLAUDE.local.md в облачную синхронизацию

Если ваша рабочая папка синхронизируется через Яндекс.Диск, iCloud или Dropbox — CLAUDE.local.md улетит в облако. Если папку видят коллеги — они увидят ваши личные настройки. Это не катастрофа, но неудобно. Добавьте в .gitignore или настройте исключение в клиенте синхронизации.

Ошибка 4. Забыть обновить проектный файл при смене задачи

Проектный CLAUDE.md пишется один раз и потом забывается. Через месяц в нём описан уже неактуальный контекст: другая структура папок, изменились метрики, появились новые подрядчики. Claude честно работает по устаревшим инструкциям.

Как исправить: раз в месяц-полтора пробегитесь по проектным файлам. Пять минут актуализации экономят часы путаницы.

Ошибка 5. Пытаться уместить слишком много в один файл

Соблазнительно написать в глобальном CLAUDE.md исчерпывающий документ на 200 строк: профиль, история, предпочтения по каждому типу задач, ссылки на все проекты. Проблема в том, что это занимает место в контексте каждого запроса. Claude Code имеет ограничение на размер контекста, и если ваш CLAUDE.md занимает несколько тысяч токенов — меньше места остаётся для самого разговора.

Как исправить: глобальный файл — короткий, принципиальный. Не больше 50-60 строк. Детали и специфика — на проектный уровень.

Чувствительные данные в CLAUDE.md

Не пишите в CLAUDE.md пароли, токены API, личные данные клиентов. Эти файлы часто попадают в синхронизацию или git. Для конфиденциальных данных — переменные окружения или отдельные файлы с ограниченным доступом.

Частая ситуация: переход между контекстами

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

Без проектных CLAUDE.md вы каждый раз объясняете контекст заново. С ними — просто открываете нужную папку, и Claude уже знает, в каком режиме работать.

Практический порядок такой: перед тем как начать задачу, убедитесь, что открыли правильную папку в терминале. Запустили Claude — он подхватил контекст. Это занимает секунды, но меняет качество работы.

# Для маркетинговых задач
cd ~/работа/маркетинг
claude

# Для финансовых документов
cd ~/работа/финансы
claude

# Для работы с договорами
cd ~/работа/договоры
claude

Каждый раз — разный контекст, разные инструкции, одинаково точные результаты.

Когда нужно / когда нет

Глобальный ~/.claude/CLAUDE.md нужен всегда, как только вы начали использовать Claude регулярно. Это ваш постоянный профиль. Без него каждый раз объясняете одно и то же.

Проектный .claude/CLAUDE.md нужен, когда папка специализирована: одна тема, специфические термины, особые правила вывода. Маркетинговая аналитика, финансы, юридические документы — всё это достаточно специфично, чтобы иметь свой контекст.

Проектный CLAUDE.md не нужен для временных папок: скачал файлы, обработал, удалил. Не нужен для папки «Разное» без чёткой темы — там нечего описывать.

CLAUDE.local.md нужен, если над проектом работает несколько человек или вы хотите отделить личные предпочтения от командных. Если работаете только вы — можно не заморачиваться, достаточно проектного файла.

Практический критерий: задаёте ли вы один и тот же вопрос дважды?

Если два раза подряд объяснили Claude одно и то же в одной и той же папке — пора записать это в CLAUDE.md этой папки. Третий раз — никогда не объясняйте то, что уже написали.

Связь с другими уроками

День 11 — CLAUDE.md: первый шаг — базовый урок о том, что такое CLAUDE.md и зачем он нужен. Если вы только создаёте первый файл, начните с него, потом возвращайтесь сюда.
День 13 — @path: включение файлов в контекст — следующий уровень управления контекстом: как подтянуть конкретный файл или папку прямо в запросе.
День 15 — Auto Memory — автоматическая память Claude, которая дополняет ручные настройки CLAUDE.md. Понимание обоих механизмов важно, чтобы не дублировать инструкции.

Задание на сегодня

Создайте или обновите ваш глобальный ~/.claude/CLAUDE.md с минимальным профилем.