Как разложить инструкции Claude Code и не раздувать контекст
CLAUDE.md добавляет постоянные инструкции в контекст Claude Code. Команды сборки, соглашения по коду и структуру проекта не приходится объяснять заново в каждой сессии.
В документации Anthropic личный файл инструкций для всех проектов хранится в папке настроек Claude домашнего каталога пользователя. Общий для команды файл лежит в корне проекта или в его папке настроек Claude. Локальный файл с личными инструкциями проекта размещают в корне и добавляют в исключения Git, чтобы не закоммитить.
Уровни складываются, а не заменяют друг друга: проектные инструкции идут после пользовательских, локальные после проектных. Я бы не использовала локальный файл для отмены командных правил: без правки исходных инструкций в контексте останутся оба требования.
Kosareva Cloud предоставляет OpenAI-совместимый и Anthropic-совместимый API-шлюз.
Команда /init анализирует кодовую базу и создаёт CLAUDE.md с командами сборки, тестирования и соглашениями проекта. Существующий файл не перезаписывает, а предлагает улучшения. Я бы оставила в нём то, что нужно каждой сессии; многошаговую процедуру вынесла бы в skill, правила части проекта в path-scoped rule.
Ориентир Anthropic — менее двухсот строк на файл. Импорт помогает разложить текст по файлам, но не экономит контекст: подключённые файлы загружаются вместе с инструкциями. Относительный путь считается от файла с импортом. Кавычки вокруг пути отключают импорт, поэтому оформлять его как строковое значение нельзя.
CLAUDE.md остаётся контекстом, а не гарантией соблюдения правил: для безусловного запрета действия документация предлагает PreToolUse hook. Для существующего проекта я бы начала с команды /context all и раздела Memory files: проверьте, загрузился ли нужный файл, прежде чем дописывать правила.