Папка `.claude` — центр управления проектом

Цель: понять что `.claude/` — это не чёрный ящик. Это центр управления поведением Claude в твоём проекте. Здесь большинство людей теряет 80% пользы.

Две директории `.claude`

Важный момент, о котором почти не говорят: их две, не одна.

Директория	Что там	Коммитится в git
`<project>/.claude/`	Командные настройки, правила, скиллы, агенты	✅ Да
`~/.claude/`	Личные настройки, история сессий, личные агенты	❌ Нет

Проектная расшаривается с командой. Личная — только твоя.

Структура проектной `.claude/`

.claude/
├── settings.json        # permissions, hooks, MCP
├── CLAUDE.md            # главные инструкции (можно в корне проекта)
├── CLAUDE.local.md      # личные инструкции (автоматически в .gitignore)
├── rules/               # модульные правила с path-scoping
│   ├── api-conventions.md
│   ├── testing.md
│   └── security.md
├── skills/              # переиспользуемые workflow
│   └── deploy/
│       ├── SKILL.md
│       └── templates/
├── agents/              # кастомные субагенты
│   └── security-reviewer.md
├── commands/            # свои slash-команды
│   └── daily-standup.md
└── hooks/               # shell-скрипты на события
    └── bash-firewall.sh

Структура личной `~/.claude/`

~/.claude/
├── CLAUDE.md            # user-level инструкции (поверх проектных)
├── agents/              # личные агенты — доступны во всех проектах
├── skills/              # личные скиллы
├── commands/            # личные slash-команды
└── projects/
    └── <project-hash>/
        └── memory/      # персистентная память по проекту

Иерархия загрузки

Когда ты запускаешь claude в проекте, контекст собирается в таком порядке:

User-level — ~/.claude/CLAUDE.md
Project-level — <project>/CLAUDE.md или <project>/.claude/CLAUDE.md
Directory-level — CLAUDE.md в текущей поддиректории (если есть)
Rules с path-scoping — .claude/rules/*.md чьи paths: совпадают с редактируемыми файлами
Personal overrides — CLAUDE.local.md в корне проекта

Всё это собирается в системный промпт. Поэтому:

Держи файлы короткими (токены тратятся каждое сообщение)
Используй path-scoping для специфичных правил (Модуль 3)
CLAUDE.local.md для личных предпочтений которые не коммитятся

Минимальный `.claude/` с первого дня

Для начала нужны только 2 вещи:

CLAUDE.md в корне проекта — следующий урок
.claude/settings.json с базовыми permissions — к этому вернёмся в Модуле 3

Всё остальное — по мере роста потребностей.

Проверить текущую конфигурацию

/memory

Эта команда показывает какие файлы памяти загружены. Полезно для дебага когда "Claude не следует моим правилам".

Практика (5 минут)

В корне твоего проекта создай .claude/ если его нет
Посмотри что там уже: ls -la .claude/
Запусти claude в проекте
Введи /memory — посмотри что загружается
Если CLAUDE.md ещё нет — не паникуй, делаем его в следующем уроке

Что дальше

Следующий урок: CLAUDE.md правильно. Разберём пример на 20 строк который покрывает весь проект, и объясним почему файлы длиннее 200 строк игнорируются.