CLAUDE.md — правила твоего проекта

Каждый новый разговор Claude начинает с чистого листа. Если правила твоего проекта живут только у тебя в голове, объяснять их придётся каждый раз — и каждый раз он будет что-то из этого терять.

Решение — файл CLAUDE.md в корне проекта. Он читается автоматически при старте, и то, что там написано, действует всегда.

Что туда писать

Только то, что не выводится из самого кода и повторяется из раза в раз.

Хороший пример:

# Правила проекта

## Стек
Next.js 14 (App Router), TypeScript, Tailwind. Базу не меняем без обсуждения.

## Как запускать
npm run dev — сервер на порту 3170.

## Жёсткие запреты
- Не трогать папку legacy/ — там старый код, он ещё работает.
- Секреты только в .env, никогда в коде.
- Не делать git push без моей отдельной просьбы.

## Стиль
- Комментарии в коде на русском, сам код на английском.
- Даты в интерфейсе всегда ДД.ММ.ГГГГ.

Всё это — вещи, которые Claude не угадает и которые ты иначе будешь диктовать каждый день.

Что туда НЕ писать

• То, что видно в коде. «У нас есть папка components» — он и так её увидит. Файл станет длинным, а длинный файл читается хуже.
• Историю правок. Для этого есть git.
• Секреты. Пароли и ключи — только в .env, и .env должен быть закрыт от git.
• Всё подряд «на всякий случай». Чем короче файл, тем точнее он работает. Пятьдесят строк по делу лучше трёхсот размытых.

Три уровня

Файлов может быть несколько, и они складываются:

1. CLAUDE.md в корне проекта — правила этого проекта. Обычно лежит в git, чтобы у всей команды было одинаково.
2. CLAUDE.local.md — твои личные заметки по этому проекту. В git не кладут.
3. ~/.claude/CLAUDE.md — общие правила для всех твоих проектов сразу. Например, «объясняй простыми словами, я не программист».

Как его завести быстро

Самый простой путь — попросить самого Claude:

Осмотри проект и предложи содержимое CLAUDE.md: стек, как запускать, что нельзя трогать. Не создавай файл, сначала покажи текст.

Он соберёт черновик, ты вычеркнешь лишнее и добавишь свои запреты — те, о которых он знать не может.

Как понять, что файл работает

Простая проверка: запусти новый разговор и спроси

Какие правила этого проекта ты видишь?

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

Живой файл, а не памятник

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

В следующем уроке — как ничего не бояться ломать, потому что всё можно вернуть.