Структура проекта и CLAUDE.md
Эта глава — одна из самых важных. Правильная организация проекта экономит кучу нервов и времени. А файлы настроек для ИИ — это то, что превращает хаотичный вайб-кодинг в предсказуемый процесс.
Как организовать папки
Золотое правило: один проект = одна папка.
Создай на компьютере одну общую папку для всех проектов. Внутри неё — отдельная папка под каждый проект:
📁 Projects/ ← общая папка (одна на все проекты)
📁 my-website/ ← проект: сайт-визитка
📁 telegram-bot/ ← проект: Telegram-бот
📁 habit-tracker/ ← проект: трекер привычек
📁 baza/ ← проект: этот гайдПроще говоря
Представь шкаф. В каждом ящике — вещи одного типа: в одном носки, в другом футболки. Если свалить всё в одну кучу — ничего не найдёшь. С проектами так же: каждый проект живёт в своём ящике (папке). Никогда не смешивай файлы разных проектов.
Почему это важно для вайб-кодинга: когда ты запускаешь Claude Code в папке проекта, он видит только файлы этой папки. Если в одной папке лежат два разных проекта — ИИ запутается и может редактировать не те файлы.
Файлы настроек Claude Code
Claude Code использует несколько специальных файлов и папок, которые определяют, как ИИ себя ведёт. Разберём каждый.
Глобальный CLAUDE.md — правила для ВСЕХ проектов
Где лежит: ~/.claude/CLAUDE.md (в домашней папке пользователя)
Этот файл содержит общие правила, которые Claude Code будет соблюдать в любом проекте. Сюда пишешь то, что актуально всегда, не для какого-то конкретного проекта.
Что рекомендуем туда написать:
# Глобальные правила
## Язык
- Общайся со мной на русском
- Код и комментарии в коде — на английском
## Безопасность
- Не удаляй файлы без моего разрешения
- Перед значительными изменениями — спроси подтверждение
- Не удаляй и не перезаписывай данные без спроса
## Стиль работы
- Не добавляй фичи, о которых я не просил
- Не рефактори код, если я не просил
- Если видишь ошибку — скажи о ней, но не чини без спросаПроще говоря
Глобальный CLAUDE.md — это как общие правила дома. «В обуви не ходить, после 23:00 не шуметь». Они действуют для всех, кто заходит — то есть для всех проектов. Ты настраиваешь их один раз.
Проектный CLAUDE.md — правила для КОНКРЕТНОГО проекта
Где лежит: в корне папки проекта, например my-website/CLAUDE.md
Этот файл описывает контекст конкретного проекта: что это за проект, какие технологии используются, какие есть правила и ограничения.
Пример для сайта-визитки:
# Сайт-визитка Андрея
## О проекте
Одностраничный сайт-визитка с ссылками на соцсети.
## Стек
- HTML, CSS, JavaScript
- Без фреймворков, всё максимально просто
## Правила
- Тёмная тема
- Адаптивность под мобильные устройства
- Никаких внешних зависимостей — всё в одном файлеПроще говоря
Если глобальный CLAUDE.md — это правила дома, то проектный CLAUDE.md — это инструкция для конкретной комнаты. «В гостиной не курить, пульт от ТВ лежит на полке справа». ИИ читает её и сразу понимает контекст: что это за проект, что можно, что нельзя.
Папка .claude/ — настройки и память
Где лежит: ~/.claude/ (глобальная) и .claude/ в корне проекта
В этой папке Claude Code хранит свои настройки, память между сессиями и конфигурацию. Тебе обычно не нужно туда лезть, но полезно знать, что она существует.
Что там может быть:
settings.json— настройки разрешений (что ИИ может делать без спроса)memory/— память ИИ между разговорами- Конфигурация MCP-серверов
CODE_MAP.md — карта проекта
Когда проект вырастает и в нём появляется больше 10 файлов, полезно создать файл CODE_MAP.md в корне проекта. Это компактный указатель: какой файл за что отвечает.
Пример:
## Структура
main.py — точка входа, запуск приложения
config.py — настройки (API-ключи, пути)
bot.py — логика Telegram-бота
:handle_message() — обработка входящих сообщений
:send_digest() — отправка дайджеста
utils.py — вспомогательные функции
:fetch_rss() — скачивание RSS-ленты
NOTE: кеширует результат на 1 часЗачем: когда ты начинаешь новую сессию с ИИ, он читает CODE_MAP.md и сразу понимает весь проект. Без карты ему пришлось бы открывать и читать каждый файл по очереди — это медленнее и тратит больше ресурсов.
Проще говоря
CODE_MAP.md — это план этажа в торговом центре. Можно ходить по всем магазинам и искать нужный. А можно посмотреть на план и сразу понять: «одежда на втором этаже, еда в подвале». ИИ делает то же самое — смотрит в карту и сразу знает, где что лежит.
Рекомендуемые правила для n8n в CLAUDE.md
Если ты работаешь с n8n (автоматизациями) через MCP-сервер, добавь в свой глобальный CLAUDE.md такой блок:
## Правила для n8n
### Разрешения
- READ-операции (поиск, просмотр, список workflow) — разрешены автоматически
- CREATE — создание новых workflow — с подтверждением пользователя
- UPDATE — значительные правки workflow — с подтверждением пользователя
- DELETE workflow — ЗАПРЕЩЕНО КАТЕГОРИЧЕСКИ
### Почему
Удалённый workflow восстановить нельзя. Значительные правки могут сломать
работающую автоматизацию. Лучше спросить, чем потом восстанавливать.Важно
Правило запрета удаления workflow — это не просто рекомендация. Удалённый workflow в n8n невозможно восстановить. Одно неосторожное действие ИИ — и работающая автоматизация пропала навсегда. Поэтому удаление запрещаем на уровне правил.
Итого: структура проекта вайб-кодера
Вот как выглядит хорошо организованный проект:
📁 my-project/
📄 CLAUDE.md ← правила для ИИ (что за проект, как работать)
📄 CODE_MAP.md ← карта проекта (если 10+ файлов)
📁 .claude/ ← настройки Claude Code (автоматически)
📁 src/ ← исходный код проекта
📄 package.json ← зависимости (если JavaScript/Node.js)
📄 requirements.txt ← зависимости (если Python)
📄 .gitignore ← какие файлы НЕ сохранять в GitА на уровне всей системы:
📁 ~/.claude/
📄 CLAUDE.md ← глобальные правила (для всех проектов)
📄 settings.json ← глобальные настройки
📁 memory/ ← память между сессиями
📁 Projects/
📁 project-1/
📄 CLAUDE.md ← правила для этого проекта
📄 CODE_MAP.md
...
📁 project-2/
📄 CLAUDE.md
...Что дальше?
Проект организован. В следующей главе разберёмся с серверами и доменами — что это такое и как работает на практике.