CLAUDE.md: це єдиний файл, який формує, як Claude розуміє ваш проект. Добре написаний файл означає менше виправлень, кращий код і агентів, які дійсно знають, над чим вони працюють.
Цей посібник проведе вас через кожен розділ файлу CLAUDE.md, від декларацій технічного стеку до специфічних підказок для агентів. Слідуйте за ним і створюйте свій файл крок за кроком.
CLAUDE.md: це файл у форматі markdown, який ви розміщуєте в корені вашого проекту. Коли Claude Code починає сесію, він спочатку читає цей файл. Все, що в ньому міститься, стає частиною контексту Claude: ваш технічний стек, структура файлів, конвенції вашої команди та будь-які специфічні інструкції, які ви хочете, щоб кожен агент виконував.
Думайте про це як про документ для брифінгу. Без нього Claude має здогадуватися, як організований ваш проект. З хорошим файлом Claude вже знає, де що знаходиться, які шаблони слід дотримуватися і чого уникати. Різниця в якості виходу значна.
“10-хвилинна інвестиція в CLAUDE.md заощаджує години на виправлення AI-згенерованого коду, який не відповідає шаблонам вашого проекту.”
Спостерігається в сотнях проектів Claude Code
Структура та специфічність вашого CLAUDE.md безпосередньо впливають на те, наскільки добре Claude працює у вашій кодовій базі.
Добре структурований CLAUDE.md охоплює ці шість областей. Кожна з них надає Claude конкретну інформацію, яку він може негайно використовувати.
Перерахуйте ваші фреймворки, бібліотеки та їх версії явно. Включіть ваш менеджер пакетів, версію Node та будь-які вимоги до середовища виконання. Claude використовує це для генерації сумісного коду без здогадок.
Опишіть ваші ключові директорії та що знаходиться в кожній з них. Компоненти, сховища, сервіси, маршрути API, типи. Коротка діаграма дерева з однорядковими описами для кожної папки працює добре.
Задокументуйте ваші шаблони іменування (camelCase для файлів, PascalCase для компонентів), підхід до обробки помилок, порядок імпорту та будь-які специфічні для проекту правила. Це допомагає зберегти вихідні дані Claude узгодженими з вашим існуючим кодом.
Включіть ваші команди розробки, збірки, тестування та перевірки. Коли Claude потрібно перевірити, чи щось працює, або запропонувати скрипт, він використовуватиме точні команди, які очікує ваш проект.
Якщо ви використовуєте кілька агентів (QA, фронтенд, бекенд, DevOps), додайте розділ, що описує, на чому кожна роль повинна зосередитися. Це особливо корисно з багатозадачним налаштуванням AgentsRoom.
Скажіть Claude, чого НЕ робити. Не змінюйте файли конфігурації, не змінюйте систему аутентифікації, не рефакторіть шар бази даних. Явні межі запобігають небажаним змінам з боку агентів.
Вам не потрібно писати все одразу. Почніть з основ і розширюйте, коли виявите, що Claude потрібно знати.
Відкрийте ваш package.json і перелічіть кожен фреймворк, бібліотеку та інструмент, які використовує ваш проект. Зазначте версії. Перевірте ваші вимоги до середовища виконання (версія Node, версія Python, база даних). Це стане вашим розділом технічного стеку.
package.json + версії середовища виконання + база даних
Запустіть швидке дерево вашої директорії src. Визначте папки верхнього рівня та напишіть однорядковий опис кожної. Зосередьтеся на тому, де знаходяться компоненти, сховища, сервіси, типи та маршрути API.
src/ дерево з анотаціями призначення
Перегляньте ваш існуючий код і відзначте шаблони: як ви називаєте файли, як обробляєте помилки, як структуруєте імпорти, чи використовуєте ви експорт за замовчуванням або іменований експорт. Запишіть це як короткі правила.
Іменування, імпорти, обробка помилок, експорт
Якщо ви працюєте зі спеціалізованими агентами, додайте області фокусування для кожної ролі. Агент фронтенду повинен знати вашу бібліотеку компонентів. Агент DevOps повинен знати ваш конвеєр розгортання. Агент QA повинен знати вашу тестову структуру.
Області фокусування для кожної ролі + уникання областей
AgentsRoom побудований навколо CLAUDE.md як першокласної концепції, а не як додаткової думки.
Редагуйте ваш CLAUDE.md безпосередньо в AgentsRoom з підсвічуванням синтаксису та живим збереженням. Не потрібно перемикатися на ваш текстовий редактор або IDE.
Дивіться, як кожен агент інтерпретує ваш CLAUDE.md в реальному часі. Спостерігайте за виводом терміналу, щоб переконатися, що агенти дотримуються ваших конвенцій і поважають ваші уникання областей.
Кожен проєкт в AgentsRoom має свій власний CLAUDE.md. Перемикайтеся між проєктами, і кожен агент автоматично завантажує правильний файл контексту для цієї кодової бази.
14 ролей агентів в AgentsRoom безпосередньо пов'язані з розділами CLAUDE.md. Визначте області фокусу та уникайте областей для кожної ролі, і кожен агент отримає саме ті інструкції, які йому потрібні.
CLAUDE.md is prepended to every Claude turn. A bloated CLAUDE.md silently inflates Claude Code token usage on every message. AgentsRoom puts a per-session token meter on each agent so you can see exactly how much your CLAUDE.md is costing you, with a live cache hit rate to confirm it stays cached.
See the Claude Code token usage trackerЗавантажте AgentsRoom і використовуйте вбудований редактор CLAUDE.md, щоб надати вашим агентам необхідний контекст. Кращі інструкції, кращий код.
Додаток-компаньйон: контролюйте своїх агентів на ходу
Використовуйте свого: Claude, Codex, Antigravity CLI або іншого AI-провайдера.
Надсилайте баги та запити прямо у свій публічний беклог.
Погляд на AgentsRoom в дії.