CLAUDE.md: Встраиваемый файл сокращает количество токенов в выводе Claude на 63%

Что делает CLAUDE.md

CLAUDE.md — это один файл, который вы помещаете в корень вашего проекта. Когда Claude Code читает его, поведение меняется немедленно без модификаций кода. Он специально нацелен на поведение вывода: подобострастие, многословие и шум форматирования.

Проблема, которую он решает

По умолчанию Claude тратит токены на поведение, которое не добавляет ценности:

• Начинает ответы с "Конечно!", "Отличный вопрос!", "Абсолютно!"
• Заканчивает "Надеюсь, это поможет! Дайте знать, если что-то нужно!"
• Использует длинные тире (--), умные кавычки, Unicode-символы, которые ломают парсеры
• Переформулирует ваш вопрос перед ответом
• Добавляет непрошенные предложения сверх того, о чём вы просили
• Переусложняет код ненужными абстракциями
• Соглашается с неверными утверждениями ("Вы абсолютно правы!")

Результаты тестирования

Те же 5 запросов протестированы без CLAUDE.md (базовый уровень) и с CLAUDE.md (оптимизированный):

• Объяснить async/await: 180 слов → 65 слов (сокращение на 64%)
• Ревью кода: 120 слов → 30 слов (сокращение на 75%)
• Что такое REST API: 110 слов → 55 слов (сокращение на 50%)
• Исправление галлюцинаций: 55 слов → 20 слов (сокращение на 64%)
• Итого: 465 слов → 170 слов (сокращение на 63%)

Примерно 384 выходных токена сохранено на 4 запросах. Примечание: Это ориентировочный показатель на основе 5 запросов, а не статистически контролируемое исследование.

Когда это помогает, а когда нет

Работает лучше всего для:

• Автоматизированных конвейеров с большим объёмом вывода (боты для резюме, циклы агентов, генерация кода)
• Повторяющихся структурированных задач, где многословие Claude по умолчанию накапливается за сотни вызовов
• Команд, которым нужен согласованный, парсируемый формат вывода между сессиями

Не стоит использовать для:

• Одиночных коротких запросов (файл загружается в контекст каждого сообщения, вызывая чистый рост токенов при низком выводе)
• Случайного разового использования (накладные расходы не окупаются при низком объёме)
• Исправления глубоких проблем, таких как галлюцинированные реализации или архитектурный дрейф
• Конвейеров, использующих несколько новых сессий на задачу
• Надёжности парсеров в масштабе (используйте структурированный вывод, например, режим JSON)
• Исследовательской или архитектурной работы, где дискуссия и альтернативы являются целью

Вопросы стоимости

Сам файл CLAUDE.md потребляет входные токены на каждое сообщение. Экономия происходит за счёт сокращённых выходных токенов. Чистая выгода положительна только тогда, когда объём вывода достаточно высок, чтобы компенсировать постоянные входные затраты. При низком использовании это стоит больше, чем экономит.

Поддержка моделей

Тестирование проводилось только на Claude. Правила не зависят от модели и должны работать на любой модели, которая читает контекст, но результаты на локальных моделях, таких как llama.cpp, Mistral или других, не тестировались.