Курс

Файл CLAUDE.md

МОДУЛЬ 8: ДЛЯ ПРОДВИНУТЫХ • Урок 4 из 8

Это один из самых важных инструментов для эффективной работы нашей системы.

[ ЧТО ЭТО ТАКОЕ ]

CLAUDE.md в проекте

CLAUDE.md это текстовый файл в папке проекта. Claude читает его автоматически при каждом запуске и следует написанным там правилам. Поэтому он очень важен.

💡 Простыми словами:

Это как инструкция для нового сотрудника: "Вот как мы тут работаем". Ты пишешь правила в файл CLAUDE.md, кладёшь его в папку проекта, и Claude строго их соблюдает.

[ ЗАЧЕМ ЭТО НУЖНО ]

1.

Не повторять одно и то же

Вместо "не трогай файл config.json" в каждом сообщении — записал в CLAUDE.md и забыл.

2.

Защита от ошибок

Claude может случайно удалить важный файл или закоммитить секреты. Правила в CLAUDE.md предотвращают это.

3.

Специфика проекта

Каждый проект особенный. Где-то нельзя трогать определённые папки, где-то нужно всегда спрашивать перед удалением.

4.

Общие правила для команды

Если работаешь с другими — все будут использовать одни правила.

[ КАК СОЗДАТЬ ]

Лучше всего, советуясь с думающей и дорогой LLM. Но если конкретнее:

Способ 1 — автоматически:

Напиши в чате /init — Claude проанализирует проект и создаст CLAUDE.md с базовыми правилами.

Способ 2 — попросить:

Создай CLAUDE.md с правилами безопасности для этого проекта

Способ 3 — вручную:

Создай файл CLAUDE.md в корне проекта. Это обычный текстовый файл.

💡 Быстрое добавление правил:

Во время работы нажми # и напиши новое правило — Claude сам добавит его в CLAUDE.md.

[ ГДЕ МОЖЕТ ЛЕЖАТЬ ]

my-project/
├── CLAUDE.md        ← основной, в корне проекта
├── frontend/
│   └── CLAUDE.md    ← можно в подпапках (для конкретно)
├── backend/
│   └── CLAUDE.md

Варианты расположения:

  • В корне проекта — основной вариант, работает для всего проекта
  • В подпапках — для больших проектов с разными частями
  • CLAUDE.local.md — локальный файл, не добавляй в git (для личных правил)
  • ~/.claude/CLAUDE.md — глобальный, работает для всех твоих проектов

[ ЧТО ПИСАТЬ ]

Типичные секции:

1.

Безопасность

Что нельзя коммитить, какие файлы не трогать.

2.

Git-воркфлоу

Какая основная ветка, как называть коммиты.

3.

Структура проекта

Где что лежит, какие папки важные.

4.

Подтверждения

Когда спрашивать перед действием.

5.

Ссылки на документацию

Можно указать файлы которые Claude должен прочитать:

See: docs/architecture.md for project structure

[ ПРАВИЛА НА АНГЛИЙСКОМ ]

Claude лучше воспринимает инструкции на английском. Есть специальные слова-маркеры:

  • NEVER (никогда) — строгий запрет
  • ALWAYS (всегда) — обязательное действие
  • MUST (должен) — требование
  • IMPORTANT — важное замечание

Эти слова работают как "красные флаги" — Claude обращает на них особое внимание.

⚠️ Важно:

Пиши правила на английском, объяснения можно на русском. Например:

NEVER commit .env files  — это правило
# Здесь хранятся API ключи — это пояснение

[ СОВЕТЫ ]

Пиши коротко

До 500 строк максимум. Лучше ещё меньше. Файл читается каждый раз — длинный файл замедляет работу.

Добавляй правила по необходимости

Claude накосячил? Добавь правило чтобы не повторилось. Файл растёт из реального опыта.

Периодически чисти

Раз в месяц просмотри файл. Удали устаревшее, обнови неактуальное.

Не храни секреты

Никаких API ключей, паролей, токенов в CLAUDE.md — он попадает в git.

[ РЕАЛЬНЫЙ ПРИМЕР ]

Вот как выглядит пример рабочего CLAUDE.md:

Обрати внимание: файл короткий, правила конкретные, написаны на английском с NEVER/ALWAYS.

[ ПРАКТИКА ]

  1. Напиши /init — посмотри что Claude предложит
  2. Добавь своё правило через клавишу #
  3. Проверь что файл появился в корне проекта
  4. Попробуй нарушить правило — Claude должен отказаться или спросить

[ ПРОВЕРКА ]

  • Знаю что такое CLAUDE.md и зачем он нужен
  • Знаю команду /init для создания файла
  • Понимаю что писать — коротко, на английском, только важное
  • Знаю слова-маркеры: NEVER, ALWAYS, MUST
💬 Совет:

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