Это первый файл, который Claude Code ищет при запуске. Он лежит в корне проекта, рядом с папкой .claude/, и содержит основные инструкции: кто вы, что за проект, как Claude должен себя вести, что ему запрещено.
Допустим, вы делаете веб-приложение. Вы хотите, чтобы Claude знал, на чем оно написано, и не трогал определенные файлы. Минимальный CLAUDE.md может выглядеть так:
# Проект Веб-приложение для управления задачами. Фронтенд: React. Бэкенд: FastAPI. База данных: PostgreSQL. ## Правила - Пиши на TypeScript, не на JavaScript. - Используй функциональные компоненты, не классовые. - Не меняй файлы в папке /migrations/ без подтверждения. - Не удаляй существующие тесты. ## Стиль - Отвечай коротко и по делу. - Если не уверен — спроси, а не додумывай.
Десять строк — и Claude уже понимает стек, ограничения и стиль общения. Без этого файла каждый из этих пунктов пришлось бы проговаривать вручную в начале каждой сессии.
Когда файл начинает расти. На старте десяти строк достаточно. Но со временем появляются новые правила, описания модулей, инструкции по работе с API. Файл разбухает до 200–300 строк, и Claude тратит на его чтение все больше контекстного окна — того объема информации, который он может удерживать «в голове» одновременно.
Рекомендация — держать CLAUDE.md в пределах 100 строк. Но куда девать все остальное?
Claude Code поддерживает подключение внешних файлов. Работает это так: вы создаете отдельный файл — например, docs/architecture.md — и описываете в нем архитектуру подробно, на сколько угодно строк. А в CLAUDE.md вместо этого описания ставите одну строку со знаком @ и путем к файлу:
@docs/architecture.md
Когда Claude Code запускается и читает CLAUDE.md, он встречает эту строку, идет по указанному пути, открывает файл и подтягивает его содержимое. Вы не копируете текст вручную — Claude делает это сам.
Таких ссылок может быть несколько. Например, итоговый CLAUDE.md может выглядеть так:
# Проект Веб-приложение для управления задачами. @docs/architecture.md @docs/api-guidelines.md @~/.claude/CLAUDE.md
Три строки с @ — три файла, которые Claude подтянет автоматически. Сам CLAUDE.md остается коротким и читаемым, а детали хранятся там, где их удобно поддерживать и обновлять.
Персональные настройки. Обратите внимание на последнюю строку в примере — @~/.claude/CLAUDE.md. Она отличается от остальных: путь начинается с ~/, что означает вашу домашнюю директорию. Этот файл не лежит внутри проекта. Он хранится на вашем компьютере отдельно и содержит ваши личные предпочтения — то, что не зависит от конкретного проекта.
Например,…