Как предотвратить гниение CLAUDE.md: Относитесь к правилам как к коду
После 18 месяцев использования Claude Code в производственных проектах u/mm_cm_m_km выявил самую частую точку отказа: файл CLAUDE.md гниет. Не потому, что Claude его игнорирует, а потому что разработчики постоянно добавляют правила, никогда их не очищая. Результат — раздутый файл на 500 строк, который расходует токены на каждом шаге и расходится с реальной кодовой базой.
1. CLAUDE.md как указатель, а не инструкция
Держите CLAUDE.md в пределах 30–50 строк. Он должен служить оглавлением, указывающим на конкретные файлы для конкретных задач, а не стеной всех ваших когда-либо установленных предпочтений. Claude перечитывает файл на каждом шаге; короткие файлы дешевы, длинные тратят токены и внимание.
2. Каждый раздел отвечает на один из двух вопросов
- Какое поведение вы хотите? (правило) — должно быть в
CLAUDE.md. - Где найти актуальную правду? (источник) — должно быть URL или путем к файлу, который Claude может перечитать при выполнении задачи.
Смешивание правил и источников — вот как файлы бесконечно растут. Держите правило коротким, источник — внешним.
3. Проверяйте до слияния, а не после
Правила незаметно устаревают, когда вы переименовываете вещи, рефакторите хуки или удаляете функции. Исправление — не «будьте внимательнее», а шаг CI. Автор создал GitHub-приложение agentlint (agentlint.net), которое проверяет поверхность правил в каждом PR: противоречия между файлами, ссылки на удаленные пути, правила, описывающие функции, которые ваша версия не поддерживает.
4. Удаляйте больше, чем добавляете
Почти каждый CLAUDE.md получает одно новое правило в неделю и не удаляет ни одного. Через полгода получается Франкенштейн. Дисциплина: за каждое новое правило найдите одно для удаления. Это позволило автору держать файл в пределах 100 строк.
Основная идея: относитесь к правилам как к коду. Код имеет тесты, ревью и обнаружение дрейфа. Правилам нужно то же самое.
📖 Source: r/ClaudeAI
👀 Смотрите также
Как сократить расходы на OpenClaw Agent на 80% с помощью смены модели
Пользователь отслеживал использование токенов в течение 14 дней и обнаружил, что 67% расходов приходилось на задачи, где дешевые модели Flash соответствовали качеству Opus. Переход на Flash по умолчанию и использование /model во время сессии сократили расходы с ~$170 до ~$35 в месяц.
禁用 Opus 4.7 人类步调行为的 CLAUDE.md 条目
Три директивы CLAUDE.md, которые отключают предложения перерыва, завышенные оценки времени и разбиение на фазы в Claude 4.7 Opus во время длительных сессий программирования.
Обеспечение соответствия ИИ-агентов: Подходы на основе начальной загрузки языка и инструментов
Разработчик делится практическими методами повышения соответствия ИИ-агентов, включая использование негативного языка в начальных инструкциях и переход от мягких правил к жёстко заданным инструментам при необходимости.
Слепые зоны в постах о рабочих процессах Claude Code: восстановление, ограничения и управление разрешениями
Распространенные сценарии использования Claude Code описывают идеальный путь, но упускают восстановление после неудачных правок, контроль ограничений и управление разрешениями — критически важные аспекты для реальной работы.