Без программистского жаргона. Разберёмся, где у Claude Code лежат «правила игры», что он читает в первую очередь, когда вы начинаете разговор, и что делает по команде «прочитай проект».
Три вещи, которых новичку хватает на старте. Всё остальное ниже — когда реально понадобится.
Прочитайте один раз — и дальше всё будет понятно. Каждое слово — с бытовым сравнением.
Зачем вам это знать: если понимать, что Claude читает первым, вы поймёте, куда писать правила, чтобы он точно их увидел и выполнил.
Когда вы открываете новый разговор, Claude (точнее — его «администратор», харнесс) сам, автоматически читает несколько файлов с правилами. Всегда в одном и том же порядке — сверху вниз:
Зачем вам это знать: чем точнее ваша просьба, тем меньше лишнего Claude читает — и тем быстрее и качественнее работает.
Здесь порядок уже не жёсткий. В отличие от старта разговора, тут Claude сам решает, что открыть первым. Обычно он идёт от общего к частному:
Зачем вам это знать: есть два «этажа» настроек. Поняв разницу, вы будете класть правило туда, где оно сработает как нужно.
Этаж 1 — общий. Папка с именем .claude у вас в домашней папке. Правила отсюда действуют во всех ваших проектах сразу.
Этаж 2 — проектный. Такая же папка .claude, но внутри конкретного проекта. Правила отсюда действуют только в этом проекте и при совпадении перебивают общие.
Зачем вам это знать: чтобы знать, какой файл открыть, когда хотите что-то изменить — и не трогать лишнего.
| Файл | Простыми словами — зачем он | |
|---|---|---|
| CLAUDE.md | Ваши правила и пожелания обычным текстом: как себя вести, как отвечать, что важно. Главный файл для новичка. | общее |
| settings.json | Технические настройки: что Claude можно делать без спроса, какие авто-действия включены. | общее |
| *.local.json | То же самое, но лично для вас — не уходит в общий шкаф команды. | личное |
| skills (папка) | Готовые наборы умений под конкретные задачи (сделать презентацию, проверить текст и т.д.). | общее |
| agents (папка) | Помощники-специалисты, которым можно поручить отдельную часть работы. | общее |
| commands (папка) | Ваши быстрые команды — короткие словечки, которые запускают целое действие. | общее |
| memory (папка) | Долгая память: факты о вас, которые Claude помнит между разговорами. Чтобы что-то сюда попало — просто скажите в чате «запомни, что…». | личное |
А как выглядит этот CLAUDE.md внутри? Никакого кода — обычный список пожеланий. Вот рабочий пример, который можно скопировать и поправить под себя:
Зачем вам это знать: иногда правила противоречат друг другу. Полезно знать, какое победит.
Правило простое: чем «ближе» правило к конкретной задаче, тем оно сильнее. Снизу вверх сила растёт:
Зачем вам это знать: если хотите правило вида «каждый раз, когда…», то обычной просьбы мало — нужен hook. Новичку это нужно не в первый день — но полезно знать, что так вообще можно.
Если вы хотите, чтобы что-то срабатывало автоматически и всегда — например, «каждый раз после изменения файла проверяй его на ошибки» — это настраивается через hook (авто-действие). Просто написать об этом в правилах недостаточно: такие штуки выполняет «администратор» (харнесс), а не сам Claude.
Бывают разные моменты, когда hook может сработать:
Зачем вам это знать: чтобы случайно не выложить личное в общий доступ — и наоборот, чтобы общие правила увидели коллеги.
Простое правило по имени файла: если в названии есть словечко .local — файл личный и остаётся только у вас. Без него — общий, его увидит вся команда.
Эти файлы видят все участники проекта.
Остаётся на вашем компьютере.
Зачем вам это знать: на этих пяти граблях спотыкаются почти все в начале. Прочитали — обошли.