День 11: Что такое CLAUDE.md

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

Вы наверняка замечали: каждый раз, открывая новый чат с Claude, приходится заново объяснять базовые вещи. Что вы директор по развитию, а не программист. Что отчёты нужны на русском и без воды. Что когда вы просите «сделай письмо партнёру» — имеется в виду деловой стиль, а не продажный. Это съедает время и раздражает — особенно если вы работаете с Claude несколько раз в день.

Та же история с контекстом проекта. Вы работаете с порталом недвижимости, у вас есть специфические термины, внутренние правила оформления документов, список людей, которых нельзя упоминать публично, договорная терминология, которую нужно выдерживать точно. Каждый раз объяснять это — как вводить нового подрядчика в проект с нуля, хотя подрядчик один и тот же. Только память у него не работает.

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

Что это такое

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

CLAUDE.md — это такой brief. Только не для живого человека, а для Claude.

Технически это обычный текстовый файл в формате Markdown с именем CLAUDE.md. Когда Claude Code запускается в какой-то директории, он ищет этот файл и загружает его содержимое в начало каждого разговора. Всё, что вы напишете в нём, Claude будет «знать» с первой секунды — без того, чтобы вы это повторяли.

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

Хорошая аналогия из управленческой практики: разница между брифингом и дебрифингом. Брифинг — это когда вы вводите нового человека в задачу до начала работы. Дебрифинг — когда объясняете постфактум, что пошло не так. CLAUDE.md — это брифинг. Вместо того чтобы после каждого неточного ответа объяснять «нет, я имел в виду вот что» (дебрифинг), вы один раз описываете контекст заранее. Экономит время и нервы.

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

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

Разберём пошагово, как создать и заполнить CLAUDE.md для директора — на реальных задачах, без абстрактных примеров.

Шаг 1. Определите рабочую директорию

CLAUDE.md работает в той директории, где вы запускаете Claude Code. Если вы работаете с папкой проекта — файл кладётся туда. Если у вас есть общая рабочая папка для всех задач — туда. Один файл на одну рабочую область.

/Users/yourname/work/
└── CLAUDE.md   ← здесь

Шаг 2. Создайте файл

Просто создайте текстовый файл с именем CLAUDE.md в нужной директории. Быстрый старт: команда /init внутри сессии соберёт черновик сама, а если файл уже есть — предложит правки, не перезаписывая. Можно через любой редактор: VS Code, TextEdit в режиме plain text, Obsidian, что угодно. Расширение .md означает Markdown — но вы можете писать и обычный текст, Claude поймёт.

Шаг 3. Заполните три базовых блока

Минимально рабочий CLAUDE.md для директора выглядит так:

# Контекст работы

## Кто я
Директор по развитию в компании, работающей в сфере недвижимости.
Не программист — технически грамотен, но задачи операционные.
Часовой пояс: Москва (UTC+3).

## Как отвечать
- Язык: русский
- Сначала суть, потом детали
- Без вводных фраз вроде «Конечно, я помогу вам с этим»
- Если что-то непонятно — спрашивай, не додумывай
- Честность важнее вежливости: если вижу проблему — говори прямо

## Контекст проекта
Основная задача — подготовка документов, отчётов, писем партнёрам и подрядчикам.
Термин «КЦ» = колл-центр.
Термин «ЖК» = жилой комплекс.
Публичные упоминания работодателя и должности — исключены.

Три блока: кто вы, как общаться, специфика контекста. Этого достаточно для старта.

Шаг 4. Проверьте, что файл читается

Запустите claude в той директории, где лежит файл. Спросите: «Что ты знаешь о моём контексте работы?» Claude должен воспроизвести то, что вы написали в файле. Если воспроизвёл — всё работает.

Шаг 5. Расширяйте постепенно

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

Хорошая практика — держать рядом с рабочим файлом небольшой список «кандидатов на добавление». Что-то не так пошло в разговоре, Claude не понял термин или ответил в неправильном стиле — записываете. Раз в неделю просматриваете список и решаете, что из этого постоянная проблема, а что разовое недоразумение. Постоянное — идёт в файл, разовое — остаётся в чате.

Пример расширенного блока для работы с документами:

## Стиль документов
При подготовке деловых писем:
- Обращение: «Уважаемый» + имя отчество
- Структура: суть в первом абзаце, детали во втором, запрос/действие в третьем
- Без канцеляризмов вроде «в рамках», «по вопросу», «на предмет»
- Подпись: должность не указывать (публичное ограничение)

При подготовке аналитических отчётов:
- Начинать с вывода, потом данные
- Числа округлять до разумного уровня, не «23 847 329 ₽», а «около 24 млн ₽»
- Для внутренних документов допустимы сокращения; для внешних — расшифровывать

Шаг 6. Структурируйте по темам, если файл растёт

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

# CLAUDE.md

## Профиль
## Стиль общения
## Документы: деловые письма
## Документы: аналитические отчёты
## Документы: договоры и ТЗ
## Что не делать

Каждая секция содержит 3-7 конкретных правил. Не больше — иначе Claude начнёт «теряться» в деталях и подчёркивать второстепенное.

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

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

Ошибка 1: Писать CLAUDE.md как список правил для робота

Люди начинают с фраз вроде «ТЫ ОБЯЗАН», «НИКОГДА НЕ», «ВСЕГДА ДЕЛАТЬ». Это не только некрасиво — это менее эффективно. Claude лучше работает с контекстом и объяснениями, чем с командами. Вместо «НИКОГДА не пиши длинно» напишите «Я ценю краткость — лучше три предложения по сути, чем абзац с оговорками». Одно и то же по смыслу, но второй вариант Claude интерпретирует точнее, потому что понимает намерение.

Ошибка 2: Положить CLAUDE.md в неправильную директорию

Claude читает CLAUDE.md из текущей папки и из всех папок выше по дереву. Файл из соседней ветки не загрузится: запустив Claude в /Users/yourname/Documents, вы не получите /Users/yourname/work/CLAUDE.md. Файлы в подпапках подключаются позже — когда Claude начинает работать с файлами оттуда. Нужно или запускать Claude из правильной папки, или держать файл там, где вы реально работаете. Проверяйте командой /context: раздел Memory files покажет, что реально загрузилось.

Ошибка 3: Перегрузить файл и не обновлять

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

Ошибка 4: Писать один раз и забыть

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

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

Нужно, если:

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

Не нужно или не поможет, если:

• Вы используете Claude только через веб-интерфейс claude.ai — там CLAUDE.md не работает, это инструмент Claude Code
• Вы делаете одноразовый запрос по совершенно новой теме — проще объяснить контекст прямо в запросе
• Вы хотите изменить поведение Claude для конкретной сессии, а не для всех — в этом случае лучше объяснить прямо в чате
• Инструкция касается одной конкретной задачи — тогда лучше включить её в сам запрос, а не в CLAUDE.md

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

Ещё один нюанс: CLAUDE.md не отменяет необходимость давать контекст в самом запросе, если задача нестандартная. Файл задаёт постоянный фон — но если сегодня вам нужно написать письмо в совершенно другом стиле, чем обычно, просто скажите об этом в запросе. Инструкция в запросе имеет приоритет над CLAUDE.md. Вы не заперты в своих же правилах — вы всегда можете переопределить их для конкретного случая.

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

День 1 рассказывал о запуске claude в терминале. Именно тогда вы впервые запустили Claude в конкретной директории — CLAUDE.md работает в той же логике. Файл загружается при запуске claude из директории, где он лежит.

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

День 14 покажет использование @path — способ подключать дополнительные файлы прямо из CLAUDE.md. Если ваши инструкции разрастаются, их можно разбить по темам в отдельные файлы и ссылаться на них. Это делает CLAUDE.md компактным, а контекст — модульным.

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

Создайте CLAUDE.md в своей основной рабочей папке. Файл должен содержать ровно три блока: кто вы, как отвечать, три-пять ключевых терминов вашей работы с расшифровкой.

Запустите claude в этой папке и спросите: «Что ты знаешь о моём контексте работы?»

Критерий выполнения: Claude перечислил ваши термины и воспроизвёл ваши правила ответов без того, чтобы вы их повторяли в чате.

Всё — задание выполнено. Файл работает.

Резюме

• CLAUDE.md — текстовый файл в вашей рабочей папке, который Claude читает автоматически при каждом запуске; работает только в Claude Code, не в веб-интерфейсе
• Три базовых блока достаточны для старта: кто вы, как общаться, контекст проекта
• Файл — живой документ: обновляйте его, когда замечаете рассинхронизацию; раз в месяц убирайте устаревшее
• Инструкция в запросе имеет приоритет над CLAUDE.md — вы всегда можете переопределить правило для конкретной задачи
• Не кладите в CLAUDE.md секреты, если папка синхронизируется с облаком