В Claude Code обнаружили проблему, из-за которой модель по умолчанию добавляет в исходный код слишком много подробных комментариев. Они часто описывают очевидные действия и повторяют информацию, которую и так можно понять из самого кода. При этом поведение сохраняется даже в тех случаях, когда пользователь прямо просит минимизировать количество комментариев.
Проблема проявляется независимо от используемого языка и модели. В частности, автор сообщения столкнулся с ней при работе с Claude Opus 4.8. Обычная инструкция в CLAUDE.md не гарантирует соблюдение нужного стиля, а дополнительные правила через систему памяти также не помогают полностью решить проблему. В результате пользователю приходится вручную удалять лишние комментарии после работы модели.
Ожидается, что Claude Code будет придерживаться более сдержанного подхода и добавлять комментарии только там, где они действительно нужны. В первую очередь речь идёт о неочевидных ограничениях и причинах принятых решений, а не о пояснении очевидного поведения кода. Если в настройках проекта отдельно указано минимизировать комментарии, модель должна соблюдать это правило без дополнительных обходных решений.
Автор считает проблему значительной, поскольку она приводит к нежелательным изменениям сразу во множестве файлов и требует дополнительной ручной очистки. Ошибка воспроизводится стабильно при использовании одной и той же команды.
