Розуміння папки .claude/: центральний контрольний центр Claude Code, повний аналіз CLAUDE.md, команд, навичок і дозволів

Більшість користувачів Claude Code знають

.claude/

існування папки, але ніколи насправді її не відкривали. AI інженер Акшай нещодавно підготував повний гід, який аналізує функції кожного файлу цієї папки та як налаштувати її так, щоб Claude працював саме так, як вам потрібно.

Дві папки, а не одна

Спершу потрібно прояснити поширену помилку:

.claude/

папка має дві частини, а не одну.

Рівень проекту (ваш проект/.claude/): зберігає спільні налаштування команди, коміти до Git, щоб усі дотримувалися однакових правил і команд

Глобальний рівень (~/.claude/): особисті налаштування та міжпроектні, що впливають лише на ваш комп’ютер

CLAUDE.md: найважливіший файл

Щоразу при запуску Claude Code, перша дія — це читання

CLAUDE.md

та завантаження його у системний підказковий рядок (system prompt), щоб він постійно дотримувався інструкцій у ньому.

Що потрібно записати:

команди для побудови, тестування, lint (наприклад, npm run test)

важливі архітектурні рішення

неочевидні зауваження (наприклад, «Увімкнено строгий режим TypeScript, невикористані змінні викличуть помилку»)

правила іменування, стиль обробки помилок

Що не слід писати: правила для linter, повні документи, довгі теоретичні пояснення.

Акшай рекомендує тримати CLAUDE.md у межах 200 рядків — якщо він буде довшим, рівень дотримання команд Claude фактично знизиться через обсяг контексту.

rules/ папка: модульні команди, підходять для розширення командної групи

Коли CLAUDE.md стає все більш об’ємним,

.claude/rules/

— це рішення. Кожен Markdown-файл представляє окрему тему, наприклад code-style.md, testing.md, api-conventions.md, і Claude автоматично зчитує всі файли.

Ще більш потужна функція — «правила області шляху»: додавання YAML-метаданих у файли правил дозволяє завантажувати правила лише для файлів у певних шляхах, що запобігає зайвому навантаженню контексту непотрібними правилами.

commands/ папка: власні команди з косою рискою

Кожен Markdown-файл у

.claude/commands/

стає командою з косою рискою. review.md відповідає /project:review, fix-issue.md — /project:fix-issue.

Найкорисніша функція — у файлах команд використовувати

!

синтаксис для виконання shell-команд і вставки їхнього виводу — наприклад, автоматичне отримання git diff і вставка у підказки, щоб Claude «бачив» ваші зміни у коді. Особисті команди у ~/.claude/commands/ доступні для всіх проектів.

skills/ та agents/: автоматичний запуск проти визначених підагентів

Основна різниця між Skills і agents у способі їхнього запуску:

Skills: Claude автоматично визначає, коли викликати навичку, без ручного введення команд. Кожна навичка має власний каталог і SKILL.md, а також може мати додаткові файли підтримки.

Agents: визначають спеціалізованих підагентів із окремими системними підказками, інструментами та налаштуваннями моделі. У складних задачах Claude створює ізольований контекст для агента, щоб уникнути перевантаження основної сесії великою кількістю токенів.

У агентів у полі

tools

можна обмежити їхню поведінку — наприклад, для безпеки агент лише зчитує, без можливості запису. Поле model дозволяє обрати легкий варіант моделі для цілеспрямованих задач, щоб зекономити кошти.

settings.json: біллінг-листи та чорні списки

.claude/settings.json

керує дозволеними або забороненими діями Claude:

allow — список дозволених команд для безпосереднього виконання (наприклад, npm run *, git *)

deny — список заборонених команд (наприклад, rm -rf *, читання .env)

Дії, що не вказані у списках: Claude запитує підтвердження перед виконанням.

Особисті налаштування можна зберігати у

.claude/settings.local.json

, який ігнорується Git і не потрапляє до репозиторію.

З чого почати?

Рекомендується Акшаєм початковий порядок дій: спершу виконати

/init

для створення початкового CLAUDE.md, додати базові налаштування у settings.json, а потім створити один-два найчастіше використовувані власні команди — решту додавати поступово за потребою.

Головне розуміння:

.claude/

— це ваш протокол для повідомлення Claude «хто ви, що таке проект, і які правила потрібно дотримуватися». Чим ясніше налаштування, тим менше часу витрачається на корекцію роботи Claude.

Ця стаття допоможе зрозуміти .claude/ папку: контрольний центр Claude Code, повний аналіз CLAUDE.md, команд, навичок і прав доступу, вперше опубліковано на ABMedia.