Файл CLAUDE.md

⏱️ Примерное время: 8 минут · 🎯 Урок 8 курса Claude Code 101

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

Какую проблему он решает

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

CLAUDE.md решает это. Это Markdown-файл, который вы добавляете в корень проекта, и Claude Code читает его автоматически при каждом старте сессии. Считайте его онбординг-скриптом вашей кодовой базы. Содержимое CLAUDE.md добавляется к вашему промпту.

Пример

Вот как выглядит типичный CLAUDE.md:

# Проект
Это приложение на Next.js 15 с App Router, Tailwind и Drizzle ORM.

# Команды
- Dev-сервер: `pnpm dev`
- Тесты: `pnpm test`
- Линт: `pnpm lint`

# Стиль кода
- Отступ в 2 пробела
- Предпочитать именованные экспорты
- Все API-роуты в app/api/
- По возможности использовать server actions вместо API-роутов

Всё просто. Теперь, если попросить Claude Code создать React-компонент, он уже знает использовать Tailwind для стилей и следовать вашим соглашениям.

CLAUDE.md — для команд

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

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

Советы

Сохраняйте поправки в память. Если вы постоянно поправляете Claude — например, говорите всегда использовать server actions вместо API-роутов — явно попросите Claude сохранить это правило в память. В следующий раз он уже будет знать.
Ссылайтесь на документацию проекта. Если в проекте есть документация, на которую Claude должен ссылаться, используйте символ @ с путём к файлу:

` ## README.md Прочитай, если нужно больше информации: @README.md `

Начните без него. Мы рекомендуем начать проект без CLAUDE.md, чтобы увидеть, где вы постоянно поправляете модель. Это делает ваш CLAUDE.md компактным и сфокусированным только на нужной информации. Когда будете готовы — запустите /init, чтобы Claude сгенерировал его за вас.

Резюме

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