Курс

Папка проекта

МОДУЛЬ 2: УСТАНОВКА И НАСТРОЙКА • Урок 5 из 9

Claude Code видит только ту папку, которую ты открыл. Открыл папку с проектом — он видит все файлы внутри. Не открыл — ничего не видит.

Это как рабочий стол. Разложил документы — работаешь. Убрал в ящик — их нет.

[ ЗАЧЕМ НУЖНА ПАПКА ]

В 📁 папке живёт всё, что относится к проекту:

  • Экспортированные автоматизации из N8N
  • Промпты для AI-агентов
  • Заметки и документация
  • Схемы, планы, TODO

Claude читает эти файлы и понимает контекст. Спрашиваешь "что не так с моей автоматизацией?" — он открывает файлы, внимательно их изучает, и уже потом объясняет.

[ КАК ОРГАНИЗОВАТЬ ПАПКУ ]

Вот один из рабочих вариантов. Не идеальный, но вполне допустимый.

Структура папки проекта

Корень проекта — главная папка. В ней несколько подпапок и пара файлов:

  • docs/ — документация по проекту
  • prompts/ — промпты для AI-агентов
  • templates/ — скачанные json шаблоны (бэкап на случай если N8N кердык)
  • archive/ — старые файлы, которые щас не нужны, но могут пригодиться
  • PROJECT_STATUS.md — где мы сейчас находимся, статус проекта
  • TODO.md — что делаем дальше, задачи на сегодня
Папка docs

Папка docs/ — здесь всё про то, как проект устроен:

  • workflows/ — описания автоматизаций (что делают, как работают)
  • architecture/ — архитектура, описание как все работает и связано
  • resources/ — дополнительные материалы, полезные ссылки итд
Папка prompts

Папка prompts/ — промпты для агентов. Каждый файл это один агент:

  • Копирайтер
  • Генератор картинок
  • Анализатор данных

Когда промпты лежат в одном конкретном месте, легче их находить и редактировать (а редактировать промпты тебе придется раз двести, пока не доведёшь до идеала)

💡 Это не единственный способ:

Структура зависит от проекта. Маленький проект = хватит свободного формата. Большой = потребуется продуманная организация файлов и документов. Главное, чтобы ты сам понимал где что лежит, и чтобы твоему агенту (!) было удобно ориентироваться в этой структуре (его можно прям спросить: «тебе комфортно, бро?»).

[ МИНИМУМ ДЛЯ СТАРТА ]

Если только начинаешь, не усложняй.

Структуру усложнишь когда проект вырастет.

[ КАК ОТКРЫТЬ В VS CODE ]

Перетащи папку на окно VS Code. Всё.

Или: File → Open Folder → выбери папку.

После этого слева появится панель с файлами. Claude увидит всё что внутри.

VS Code Open Folder

Добавить новую папку в проект можно в этом же меню.

[ CLAUDE.md — КОНТЕКСТ ДЛЯ АГЕНТА ]

В папке проекта можно создать файл CLAUDE.md — агент читает его автоматически и следует написанным там правилам.

Минимальный пример:

# Проект: Telegram-бот для магазина

База: Airtable
Автоматизация: принимает заказы, записывает в базу, уведомляет менеджера

Теперь Claude сразу понимает контекст. Не нужно объяснять каждый раз.

💡 Это важная тема:

Правильно оформленный CLAUDE.md делает агента эффективнее в разы. Файл должен быть коротким и структурированным — есть конкретные правила как его писать. Подробно про оформление и примеры — в курсе "Claude Code", урок "Файл CLAUDE.md".

⚠️ Тоже важно:

Без CLAUDE.md агент каждый раз спрашивает или пытается понять "а что это за проект?". А с ним сразу понимает как в проекте всё устроено.

[ ЭКСПОРТ ИЗ N8N ]

Чтобы Claude увидел твою автоматизацию:

  1. Открой workflow в N8N
  2. Три точки справа сверху → Download
  3. Сохрани в папку проекта

Теперь можешь спросить:

Посмотри мой workflow. Что можно улучшить?

Claude откроет JSON, разберётся в структуре, ответит.

💡 Это ручной способ:

Скачивать JSON каждый раз — рабочий вариант для старта. Но в следующих уроках мы подключим N8N-MCP, и агент получит прямой доступ к твоему N8N: сможет видеть все workflow, шаблоны и ошибки без ручного экспорта.

[ ПРОВЕРКА ]

Напиши Claude:

Какие файлы ты видишь в папке?

Если перечислил — всё работает.

[ МОДУЛЬ 1 ЗАВЕРШЁН ]

Установлено:

  • VS Code
  • Claude Code
  • Папка проекта

Дальше подключаем N8N-MCP — расширение которое даёт Claude знания про все ноды и шаблоны N8N.

💬 Совет:

Нииичего сложно.