В Claude есть папка .claude/, но почему-то большинство вайб-кодеров относятся к ней как к чёрному ящику. Знают, что такая папка есть, видели, как она появляется в корне проекта, но вряд ли открывали её, и уж вряд ли разбирались, что внутри. А там, целая гора вещей, которые смогут изменить ваш подход к работе (лично я сам юзаю только .claude/skills для агентов по разработке).
Проще говоря, это центр управления вашего проекта. Хранятся инструкции, кастомные команды, правила доступа и даже память Claude между сессиями. Как только разберёшься, что/где лежит и почему -- сможешь настроить Claude Code именно так, как нужно тебе или твоей команде.
Сразу важный момент: папок .claude/ две: одна как командный конфиг с коммитом в git (одни и те же правила для команды), и вторая -- глобальная, с личными настройками, локальными состояниями машины, историями сессий и авто-памятью.
Пойдём дальше по файлам/папкам и их предназначениях:
🛑 CLAUDE.md
Самый важный файл и первое, что читает Claude Code. Загружается в системный промпт и остаётся там весь разговор. Что написал -- то и будет делать.
Пиши команды сборки, архитектурные решения, подводные камни, соглашения по импортам и структуру папок. Не пиши то, что должно быть в конфиге линтера или длинные теоретические объяснения.
❗️Оптимальный размер -- до 200 строк. Больше -- модель начинает путаться.
🛑 CLAUDE.local.md
Личный файл только для тебя, он не попадает в репо. Удобно, если у тебя свои предпочтения, которые не нужны всей команде.
🛑 Папка rules/
Когда CLAUDE.md разрастается до 300 строк -- разбиваешь инструкции по отдельным файлам: code-style.md, testing.md, api-conventions.md. Каждый загружается автоматически, каждый редактирует нужный человек. Никто никому не мешает.
🛑 Папка commands/
Создаёшь свои slash-команды. Файл review.md становится /project:review. Коммитятся и доступны всей команде. Удобно для стендапов, commit-сообщений, security-сканов.
🛑 Папка skills/
Skills запускаются сами, когда задача подходит под их описание -- не нужно вводить команду вручную. Сказал "проверь PR на безопасность", Claude сам понял и вызвал нужный skill. Личные skills в ~/.claude/skills/ работают во всех проектах.
🛑 Папка agents/
Субагенты для сложных задач. Каждый -- отдельный файл со своим промптом и набором инструментов. Запускается в изолированном окне, не засоряет основную сессию. Security-аудитору рекомендую давать только Read, Grep и Glob.
🛑 settings.json
Управляет правами Claude: что может запускать, что читать, где спрашивать разрешение. settings.local.json -- то же самое, но только для тебя, не коммитится.
🔥 Бонусом, практическая настройка с нуля:
1. Запусти /init внутри Claude Code. Он сгенерирует стартовый CLAUDE.md, прочитав твой проект. Отредактируй до самого необходимого.
2. Добавь .claude/settings.json с allow/deny правилами под твой стек. Минимум -- разреши команды запуска и запрети чтение .env.
3. Создай одну-две команды для воркфлоу, которые используешь чаще всего. Code review и фикс issue -- хорошие стартовые точки.
4. Когда проект растёт и CLAUDE.md переполняется -- начни разбивать инструкции на файлы в .claude/rules/. Скопируй их по пути, где это имеет смысл.
5. Добавь ~/.claude/CLAUDE.md со своими личными предпочтениями. Что-то вроде "всегда пиши типы перед реализацией" или "предпочитай функциональные паттерны классам".
Этого реально достаточно для 95% проектов. Skills и агенты появляются, когда есть повторяющиеся сложные воркфлоу, которые стоит упаковать.
Оригинал из твиттера можете почитать тут, пост чела набрал уже больше 2х лямов просмотров.
📱 Youtube | 💬Чат | 📱 Канал