Анатомия папки .claude: зачем она нужна и почему путает людей

Если вы искали «анатомия папки .claude», вы, вероятно, пытаетесь разобраться, что делает эта папка, почему она вводит людей в заблуждение и на что стоит обратить внимание.

Ветка Reddit от марта 2026 года разложила всё по полочкам. Разработчик, который пострадал из-за неясных правил размещения, составил шпаргалку по структуре директории .claude/, событиям хуков, settings.json, конфигурации MCP, структуре навыков и порогам управления контекстом.

Главная путаница: глобальный vs проектный уровень

Главный источник путаницы — разница между глобальной директорией ~/.claude/ и проектной директорией .claude/.

Глобальная директория находится в домашней папке и определяет общее поведение для всех проектов. Проектная директория .claude/ расположена внутри конкретного репозитория и переопределяет или расширяет глобальную конфигурацию.

Соглашения о размещении

Навыки размещаются в .claude/skills/. Каждый навык имеет собственную директорию с файлом SKILL.md.

Агенты размещаются в .claude/agents/, а не разбросанными файлами в корневой папке.

Настройки находятся в .claude/settings.json на проектном уровне или ~/.claude/settings.json глобально.

Хуки — оперативные, а не пассивные

Самая частая ошибка — слишком узкий matcher. Хук PostToolUse, сматчивающий только «Write», пропустит правки через «Edit» или «MultiEdit». Более широкий паттерн «Edit|MultiEdit|Write» покрывает больше случаев.

Четыре вещи, которые действительно важны

1. Область действия — Глобальный vs проектный уровень — это первое решение.

2. Соглашения о размещении — Навыкам нужен SKILL.md, агенты идут в agents/.

3. Контент vs оркестрация — Навыки, агенты, настройки, хуки и MCP — не эквивалентные понятия.

4. Признаки дрейфа — Документация меняется быстро. Если ваша перестала работать, проверьте, не изменились ли базовые соглашения.

Папка .claude объединяет область действия, структуру и поведение. Освоив эту трёхуровневую модель, вы увидите в папке не мусор, а операционную карту.