Опытный пользователь Claude Code разбил CLAUDE.md на 27 файлов

Продвинутый пользователь сообщества Claude Code поделился своим опытом оптимизации работы с файлом CLAUDE.md — основным набором правил для модели Claude. Ранее этот файл представлял собой единый монолитный документ примерно на 800 строк, что приводило к ряду проблем. Автор отметил, что в большом файле инструкции конфликтовали между собой, терялись важные ограничения, а сама модель хуже удерживала нужный контекст при обработке различных сценариев.

Для решения этой проблемы разработчиком была предложена модульная структура из 27 отдельных файлов. В рамках нового подхода все правила разбиты на три уровня. Первый — «ядро» (core), загружаемое всегда и содержащее базовые инструкции, оно занимает около 10 тысяч токенов. Второй уровень — общие инструкции для проекта (shared). И третий — контекстно-зависимые правила (context-specific), которые подгружаются только при работе с определёнными папками путём подключения соответствующих файлов через пути (paths). Такой метод позволяет постоянно держать в контексте только самые необходимые базовые правила, а дополнительный функционал подгружать по мере необходимости.

Монолитный файл CLAUDE.md, занимающий около 23 тысяч токенов системного промпта модели Claude, теперь считается неэффективным. Он «съедает» драгоценные вычислительные ресурсы, смешивает инструкции для разных задач, что затрудняет поддержку и увеличивает вероятность конфликтов. Модульная же система облегчает управление и позволяет использовать только релевантные инструкции для конкретного задания, например, отключая правила для написания Python-кода при работе с Markdown-документацией. Это особенно полезно для ведения баз знаний и одновременного управления несколькими проектами.

Кроме разделения файла, автор подчёркивает, что одной структуры инструкций недостаточно для обеспечения жёсткого соблюдения правил. Для этой цели он использует PostToolUse hooks — скрипты, которые автоматически проверяют параметры (такие как frontmatter, даты, wikilinks) после сохранения файла. Это необходимо, так как модель может не всегда строго выполнять инструкции из CLAUDE.md, а хуки обеспечивают дополнительный контроль и предотвращают ошибки.

В качестве практического совета разработчик рекомендует не начинать сразу с деления на максимальное число файлов, а сначала вынести хотя бы два важных блока — жёсткие ограничения и профиль пользователя. Позже, по мере накопления опыта и выявления проблем, можно добавлять отдельные контекстные файлы. Такой поэтапный подход оптимизирует процесс перехода от монолита к модульности без серьёзных трудностей и потери контроля.