Как написать хороший CLAUDE.md для Claude Code

Файл CLAUDE.md Claude Code читает автоматически в начале каждой сессии. Большинство гайдов рассказывают о нём как об инструменте разработчика: стек, команды, архитектура. Но Claude Code сегодня используют не только программисты: консультанты, аналитики, маркетологи, предприниматели. Для всех них CLAUDE.md работает ровно так же. Это персональный бриф: кто вы, как с вами работать и что нужно знать о текущей задаче.

Глобальный CLAUDE.md хранится один раз и применяется ко всем проектам

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

Пример для AI-эксперта с серьёзным бэкграундом:

# Профиль

Никита Бурьков, основатель Laplas AI.
Ex-CPO NtechLab — мирового лидера в области компьютерного зрения (2019-2023).
15+ лет в IT, 200+ AI-проектов в 20 странах.

Laplas AI работает с бизнесом по трём направлениям:
- Корпоративное обучение по AI (630+ человек, мастер-классы,
  стратегические сессии, воркшопы под индустрию)
- AI-консалтинг: аудит бизнеса, выявление точек роста,
  стратегия внедрения
- Разработка AI-решений: ассистенты, агенты, RAG-системы,
  интеграции с CRM/ERP, автоматизация процессов

## Типичные задачи
- Анализ компаний клиентов перед встречами
- Подготовка AI-аудитов и коммерческих предложений
- Написание статей для корпоративного блога
- Создание презентаций и договоров

## Как работаем
- Отвечай на русском
- Обращение неформальное
- Я диктую голосом: возможны опечатки, понимай по контексту

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

Проектный CLAUDE.md даёт контекст конкретной задачи или клиента

Проектный файл (CLAUDE.md в корне рабочей папки) описывает конкретную работу. Создайте папку под клиента или проект, положите туда CLAUDE.md, и каждая сессия начнётся с нужного контекста. Не нужно каждый раз объяснять Claude, кто этот клиент и что требуется.

Пример для подготовки AI-аудита клиента:

# Клиент: ООО «СтройГрупп»

Строительная компания, 200 сотрудников, Москва.
Коммерческое строительство. Отдел продаж (12 чел.),
проектный отдел (30 чел.), снабжение.

## Задача
Подготовить AI-аудит: где внедрение даст быстрый ROI,
где нет смысла.

## Формат выходных документов
- Структура: проблема / AI-решение / инструмент / эффект
- Стиль: деловой, без жаргона
- Объём раздела: 150-200 слов

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

# Блог laplas.io

AI-консалтинговая компания. Аудитория: собственники
и топ-менеджеры МСБ.

## Тон
- Прямо, без воды
- Конкретные цифры, не «значительно быстрее»
- Честно: говорим и когда AI не нужен

## Технические требования
- HTML-формат: p, h2, h3, ul, li, pre
- Без em-дашей в тексте
- Slug на транслите, латиница, дефисы

Для разработчиков: стек, команды и архитектурные ограничения

Если вы пишете код, проектный CLAUDE.md включает технический контекст. Особенно важны причины нетривиальных решений: без них Claude может «улучшить» то, что трогать не нужно.

# ShopFront

Next.js 14, App Router, Stripe, Prisma ORM.

## Команды
- `npm run dev`: dev-сервер (порт 3000)
- `npm run test`: Jest
- `npm run build`: production build

## Правила
- TypeScript strict, без `any`
- Named exports, не default exports
- Изменения схемы только через Prisma-миграции
- Stripe-логика изолирована в src/lib/stripe/

Три вещи, которые не нужно включать в CLAUDE.md

Правила форматирования кода. Отступы, кавычки, точки с запятой: это работа линтера. ESLint и Prettier дешевле и надёжнее. Не дублируйте их конфиг в CLAUDE.md.

Инструкции только для одной задачи. Если правило нужно раз в квартал, оно не должно загружаться в каждую сессию. Для таких случаев в Claude Code есть скиллы: они подгружаются по запросу и не засоряют контекст.

Устаревшие разделы. Пересматривайте файл раз в несколько месяцев. Цель простая: каждая строка должна влиять на поведение Claude. Если убрать строку и ничего не изменится, уберите.

Команда /init создаёт черновик для кодового проекта за секунды

Запустите /init в корне репозитория. Claude проанализирует структуру, определит стек и тестовый фреймворк, и сгенерирует стартовый файл. После этого доработайте его вручную.

Для бизнес-задач /init не поможет: там нет кода для анализа. Зато можно попросить Claude прямо в чате: «Составь CLAUDE.md для моей роли» и описать контекст в двух предложениях.

Добавьте CLAUDE.md в git: вся команда получит одинаковый контекст

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

Если хотите разобраться, как Claude Code и другие AI-инструменты встроить в ваш конкретный рабочий процесс, напишите: t.me/bulldoze.