1Коротко
Небольшой текстовый файл CLAUDE.md в папке проекта рассказывает Claude Code, как вы любите, чтобы всё делалось, и он читает его в начале каждой сессии.
2Новые слова
- CLAUDE.md — обычный текстовый файл (.md означает Markdown — простой текст с разметкой) с правилами, договорённостями и полезными командами вашего проекта. Считайте его инструкциями Project (глава 1.5), только для Claude Code.
- Договорённость (Convention) — привычка, которой следует ваш проект: как называются файлы, какой язык, как запускать тесты.
- Область действия (Scope) — где действует правило. Может быть CLAUDE.md для всего вашего компьютера (ваши личные привычки), отдельный для каждого проекта (правила проекта) и один для компании.
3Зачем это вам
Без него каждая сессия начинается с того, что Claude угадывает ваш стиль, а вы снова и снова исправляете одно и то же. С ним Claude ещё до первой строчки знает команду для тестов, правила именования и то, чего трогать нельзя. Команды делят один файл на всех, чтобы у каждого участника был одинаковый Claude.
4Попробуйте сейчас
(платные тарифы)
- В папке проекта попросите Claude Code: Создай CLAUDE.md для этого проекта, где будет: что это за проект, в двух строках; как его запускать; как его тестировать; какие правила именования мы используем; и три вещи, которые ты никогда не должен менять, не спросив.
- Прочитайте файл, который он напишет; исправьте всё, что неверно.
- Начните новую сессию и попросите сделать небольшое изменение. Обратите внимание: он запускает тесты и соблюдает правило именования без напоминаний.
5Что вы увидите
[Картинка появится позже: CLAUDE.md, открытый в редакторе, и сессия, которая ему следует.] Короткий файл, обычно меньше страницы, который Claude упоминает при запуске («Следую CLAUDE.md: запускаю тесты после изменений»). Он работает вместе с вашими общими правилами; файл проекта дополняет их.
6Осторожно
- Держите его коротким и актуальным. Длинный устаревший CLAUDE.md хуже, чем никакого: Claude будет добросовестно выполнять устаревшие правила.
- Не держите рядом с ним никаких секретов (паролей, ключей). Это текстовый файл, которым делятся.
7Дальше
Добавьте строку вроде Если не уверен, спроси, прежде чем менять больше трёх файлов. В главе 6.3 повторяющиеся задачи превращаются в навыки — правила с шагами.