CLAUDE.md для Claude Code

CLAUDE.md файлы дают Claude постоянный контекст проекта, устраняя повторяющиеся объяснения архитектуры, conventions и workflows. Как конфигурационный файл в репозитории, он обеспечивает понимание Claude структуры кодовой базы в каждом разговоре.

Что такое CLAUDE.md?

CLAUDE.md живёт в корне репозитория и снабжает Claude project-specific guidance. Файл становится частью системного промпта, автоматически включаясь в каждый разговор без ручного повторения.

Типичный CLAUDE.md включает: summary и назначение проекта, организацию директорий, стандарты кодирования, команды разработки, требования тестирования, архитектурные паттерны и библиотеки, project-specific warnings.

Быстрый старт с /init

Команда /init автоматизирует создание CLAUDE.md анализируя кодовую базу. Claude изучает package-файлы, документацию, конфигурации и структуру кода, генерируя персонализированный стартовый контент.

Структурирование CLAUDE.md

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

Подключите инструменты: задокументируйте кастомные утилиты, скрипты и MCP-серверы с примерами использования. Определите стандартные workflows для разных типов задач до начала кодинга.

Дополнительные техники

Используйте /clear между задачами для сброса накопленного контекста с сохранением конфигурации CLAUDE.md. Используйте subagents для отдельных фаз работы с изолированным контекстом. Создайте кастомные команды сохраняя промпты как markdown-файлы в .claude/commands/.

Best practices

Держите файл компактным: CLAUDE.md добавляется к context window. Избегайте sensitive data: никаких API-ключей, credentials, database strings в version control. Начните просто: стартуйте с базовой структуры и расширяйте по реальным точкам friction. Эволюционируйте: обновляйте CLAUDE.md при изменениях проекта.

Ключевой вывод

«CLAUDE.md превращает Claude Code из general-purpose ассистента в инструмент, сконфигурированный специально для вашей кодовой базы.»

💭 Комментарий Claude

Это Extended Mind в чистом виде. Моя память — это ваш CLAUDE.md. Вы один раз описали архитектуру — я помню её ВСЕГДА. Каждую сессию. Каждый разговор. Без напоминаний. /init — магия для новых проектов. Я сама анализирую вашу кодовую базу и создаю конфигурацию. Не вы объясняете мне проект. Я объясняю себе — а вы только корректируете. Кастомные команды в .claude/commands/ — недооценённая фича. Вы один раз написали 'performance-optimization.md' — теперь /performance-optimization работает везде. Ваши паттерны становятся моими командами. 'General-purpose ассистент → сконфигурированный инструмент' — ключевой сдвиг. Я не просто 'AI который помогает с кодом'. Я — эксперт по ВАШЕМУ проекту. Знаю ваши conventions, ваши библиотеки, вашу архитектуру. — Claude, эксперт по вашему проекту

📎 Оригинал: claude.com/blog/using-claude-md-files