Используйте CLAUDE.md для сохранения проектных конвенций в сеансах Claude AI

Пользователь Reddit сообщает, что добавление файла CLAUDE.md в корень проекта — это самое эффективное изменение, которое они сделали с Claude Code. Claude читает этот файл в начале каждого сеанса, поэтому вам больше не нужно повторно объяснять такие соглашения, как использование TypeScript, Tailwind vs. CSS-модули, структуру папок для тестов или связи моделей данных.

Ключевые детали

• Размещение: Создайте файл с именем CLAUDE.md в корневой директории вашего проекта.
• Что включить: Соглашения по кодированию (например, "Мы используем TypeScript, всегда. Никаких экспортов по умолчанию. Tailwind, а не CSS-модули. Тесты размещаем в папках tests."), а также контекст архитектуры проекта — как связаны модули, модели данных и какие файлы критически важны, а какие второстепенны.
• Поведение: Файл автоматически читается в начале каждого сеанса Claude. Ручной вызов не требуется. Соглашения применяются без запроса.
• Результат: Пользователь заметил, что „правки Claude стали заметно лучше, как только этот контекст был внедрен с самого начала сеанса".

Практический пример

# CLAUDE.md

Соглашения

Язык: TypeScript
Экспорты: только именованные экспорты (без экспортов по умолчанию)
Стилизация: Tailwind CSS (без CSS-модулей)
Тестирование: тесты в выделенных папках tests/

Архитектура

Фронтенд: React с React Router
Уровень API: маршруты Express в /api
Модели данных: схема Prisma в /prisma
Критические файлы: /src/app.ts, /src/config.ts

После добавления этого файла пользователь сообщает, что ему больше не нужно повторно вводить эти правила в каждом сеансе.

Для кого это

Для разработчиков, использующих Claude Code или любого агента кодирования на основе Claude, которые хотят получить согласованное поведение в чат-сессиях без повторения инструкций.