CLAUDE.md: как настроить инструкции для Claude Code

Смотреть урок

Claude Code может каждый раз работать по вашим правилам — без необходимости заново объяснять стек, структуру проекта и ограничения.

Для этого нужен CLAUDE.md — файл с постоянными инструкциями, который Claude читает в начале каждой сессии.

Что внутри:
🔹 где хранить глобальные и проектные инструкции
🔹 как писать правила конкретно, а не общими фразами
🔹 что фиксировать в блоках Gotchas и Never Do
🔹 практическое задание: создать свой CLAUDE.md и проверить его в работе

💡 Если Claude второй раз ошибается в одном и том же месте, лучше не исправлять его снова вручную, а добавить это правило в CLAUDE.md.

CLAUDE.md: как настроить инструкции для Claude Code

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

По сути, это постоянный набор инструкций для Claude внутри конкретной кодовой базы.

Без CLAUDE.md Claude каждый раз начинает работу с общими правилами. Он не знает наших соглашений по коду, архитектуру проекта, предпочтительные библиотеки или уже обнаруженные ограничения. Хорошо составленный CLAUDE.md позволяет не объяснять всё это заново в каждой сессии.

1. Что такое CLAUDE.md и зачем он нужен

CLAUDE.md — Markdown-файл с инструкциями для Claude Code.

После его добавления Claude может автоматически учитывать:

  • принятые стандарты кода;
  • используемые библиотеки и паттерны;
  • архитектуру проекта;
  • правила работы с Git;
  • стиль commit messages;
  • особенности проекта, на которых он уже ошибался раньше.

Например, вместо того чтобы каждый раз писать:

Используй Zod для валидации.

Не используй default exports.

Перед commit запускай тесты.

...мы можем один раз записать эти правила в CLAUDE.md.

В результате Claude начинает работать не как универсальный помощник, которому постоянно нужно объяснять контекст, а как инструмент, уже знакомый с правилами конкретного проекта.

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

2. Где хранить CLAUDE.md

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

В корне проекта
CLAUDE.md
Инструкции относятся только к этому проекту. Файл можно хранить в Git вместе с остальным кодом, поэтому одни и те же правила будут доступны всей команде.

В папке .claude

🔒

Этот материал доступен участникам Клуба. Войдите или оформите доступ, чтобы читать целиком, открывать видео и комментировать.

Войти Вступить / купить доступ