CLAUDE.md определяет, как Claude воспринимает ваш проект. Хорошо написанный файл означает меньше исправлений, более качественный код и агентов, которые действительно понимают, над чем работают.
Это руководство проведет вас через каждый раздел файла CLAUDE.md: от объявления стека технологий до подсказок для конкретных агентов. Следуйте шагам и создайте свой файл.
CLAUDE.md это файл в формате Markdown, размещенный в корне вашего проекта. Когда Claude Code начинает сессию, он читает этот файл первым. Все его содержимое становится частью контекста Claude: ваш технологический стек, файловая структура, соглашения команды и любые конкретные инструкции, которым должен следовать каждый агент.
Считайте его документом для брифинга. Без него Claude вынужден угадывать, как организован ваш проект. С хорошим CLAUDE.md Claude уже знает, где что находится, каким шаблонам следовать и чего избегать. Разница в качестве вывода значительная.
“10 минут работы над CLAUDE.md экономят часы исправления ИИ-сгенерированного кода, который не соответствует шаблонам вашего проекта.”
По результатам наблюдений за сотнями проектов Claude Code
Структура и конкретность вашего CLAUDE.md напрямую влияют на качество работы Claude в вашей кодовой базе.
Хорошо структурированный CLAUDE.md охватывает эти шесть областей. Каждая дает Claude конкретную информацию, с которой он может работать сразу.
Перечислите ваши фреймворки, библиотеки и их версии в явном виде. Укажите пакетный менеджер, версию Node и все требования к среде выполнения. Claude использует это для генерации совместимого кода без угадывания.
Опишите ваши ключевые директории и что в каждой находится. Компоненты, хранилища, сервисы, API-маршруты, типы. Короткая древовидная диаграмма с однострочным описанием каждой папки работает отлично.
Задокументируйте ваши соглашения по именованию (camelCase для файлов, PascalCase для компонентов), подход к обработке ошибок, порядок импортов и любые правила, специфичные для проекта. Это обеспечивает согласованность вывода Claude с вашим существующим кодом.
Включите ваши команды для разработки, сборки, тестирования и линтинга. Когда Claude нужно проверить работоспособность или предложить скрипт, он будет использовать именно те команды, которые ожидает ваш проект.
Если вы используете несколько агентов (QA, Frontend, Backend, DevOps), добавьте раздел, описывающий, на чем должна сосредоточиться каждая роль. Это особенно полезно при мультиагентной настройке AgentsRoom.
Скажите Claude, чего НЕ делать. Не менять конфигурационные файлы, не трогать систему авторизации, не рефакторить слой базы данных. Явные границы предотвращают нежелательные изменения со стороны агентов.
Не нужно писать все сразу. Начните с основ и расширяйте по мере того, как обнаруживаете, что Claude нужно знать.
Откройте package.json и перечислите каждый фреймворк, библиотеку и инструмент, который использует ваш проект. Запишите версии. Проверьте требования к среде выполнения (версия Node, версия Python, база данных). Из этого получится раздел стека технологий.
package.json + версии среды + база данных
Сделайте быстрый обзор дерева директории src. Определите папки верхнего уровня и напишите однострочное описание для каждой. Сосредоточьтесь на том, где находятся компоненты, хранилища, сервисы, типы и API-маршруты.
Дерево src/ с описанием назначения
Посмотрите на существующий код и отметьте шаблоны: как вы называете файлы, как обрабатываете ошибки, как структурируете импорты, используете default или named экспорты. Запишите их как короткие правила.
Именование, импорты, обработка ошибок, экспорты
Если вы работаете со специализированными агентами, добавьте области фокуса для каждой роли. Frontend-агент должен знать вашу библиотеку компонентов. DevOps-агент должен знать ваш пайплайн деплоя. QA-агент должен знать ваш фреймворк тестирования.
Области фокуса и запрета для каждой роли
AgentsRoom создан с CLAUDE.md как центральным элементом, а не второстепенным дополнением.
Редактируйте CLAUDE.md прямо в AgentsRoom с подсветкой синтаксиса и автоматическим сохранением. Не нужно переключаться на текстовый редактор или IDE.
Наблюдайте в реальном времени, как каждый агент интерпретирует ваш CLAUDE.md. Следите за выводом терминала, чтобы убедиться, что агенты соблюдают ваши соглашения и уважают запрещенные области.
Каждый проект в AgentsRoom имеет свой собственный CLAUDE.md. Переключайтесь между проектами, и каждый агент автоматически загружает нужный контекстный файл для этой кодовой базы.
14 ролей агентов в AgentsRoom напрямую связаны с разделами CLAUDE.md. Определите области фокуса и запрета для каждой роли, и каждый агент получит именно те инструкции, которые предназначены для него.
Скачайте AgentsRoom и используйте встроенный редактор CLAUDE.md, чтобы дать агентам нужный контекст. Лучшие инструкции, лучший код.
Скачать AgentsRoomБесплатно навсегда. Используйте свой API key.