Что такое проект
Ещё одно понятие, с которым часто приходится сталкиваться при работе с Claude Code - это проект. По сути, проект - это та папка, в которой мы выполнили команду claude. Мы находимся в этой директории, она активная, и сессия Claude Code будет работать внутри этого проекта.
В корне проекта, когда вы будете выполнять команды, создавать инструкции, навыки, агентов, создаётся служебная директория .claude. Она скрытая по умолчанию. Здесь можно видеть навыки, настройки проекта и то, что добавляют другие используемые технологии.
Любая папка на компьютере может быть проектом Claude Code. Проект не обязан содержать какие-то файлы - он может быть вообще пустым, либо в нём могут быть текстовые файлы. Главное, что проект запускается из определённой директории.
Файл CLAUDE.md
Хорошая практика - создать в корне проекта служебный файл CLAUDE.md. Это специальный файл с инструкциями по проекту - по сути, вводный промпт, который выполняется каждый раз, когда вы запускаете команду claude изнутри этого проекта. Claude Code автоматически подтягивает содержимое этого файла в контекст - не нужно отдельно указывать, чтобы он его смотрел.
Внутри могут быть текстовые инструкции в формате Markdown. Поскольку содержимое каждый раз попадает в контекст, важно, чтобы файл не разрастался - я, как правило, держу его в пределах 200 строк. Большой контекст снижает производительность модели и дороже по токенам, и делать это для каждой сессии не очень хорошо. Поэтому нужно чистить содержимое файла и держать в нём конкретную и актуальную информацию. Всё, что можно вынести в навыки и агентов, должно быть вынесено туда - но это отдельный разговор, о котором поговорим позже.
Что писать в CLAUDE.md
Как правило, это вводная информация о проекте, которая нужна для каждой сессии:
- какие технологии и стек используются, на каком языке написано, какая архитектура;
- инструкции, как действовать в специфических ситуациях, как решать те или иные ошибки;
- кастомные инструкции, которые помогут Claude Code проще разобраться в проекте и каждый раз не проводить исследование, чтобы выяснить важные вещи.
Таким образом, CLAUDE.md - файл, который помогает экономить токены, увеличить производительность и скорость работы и выполнять работу эффективнее. По сути, ничего сложного здесь нет: проект - это папка, в которой мы выполнили команду claude и в которой лежат основные файлы. Все вложенные файлы тоже относятся к этому проекту.
