Баг в Claude Code: импорт в CLAUDE.md ломается из‑за пробела в пути

В статье на Habr AI описан баг, обнаруженный в Claude Code – инструменте от Anthropic, позволяющем агенту читать файлы, указанные в документе CLAUDE.md. При указании пути к импортируемому файлу, содержащему пробел, система неверно обрабатывает строку: путь обрезается до первого пробела, файл не загружается, а пользователь не получает сообщения об ошибке.

Как воспроизвести:

1. Создать пустой проект и разместить в нём несколько файлов‑справочников, имена которых содержат пробел (например, Общие справочники/Справочник 1.md).
2. В CLAUDE.md добавить строку импорта, например import "Общие справочники/Справочник 1.md".
3. Запустить Claude Code и попросить агента перечислить видимые им файлы, запретив чтение содержимого.
4. Агент ответит, что файл не найден, хотя в пути явно указан.

Автор эксперимента отметил, что ссылка в CLAUDE.md не гарантирует автоматическое чтение файла – каждый тип ссылки имеет свои правила загрузки. При этом в консоли не появляется ни предупреждения, ни ошибки, что делает проблему трудноуловимой.

Влияние:

• Прерывание импорта приводит к тому, что агент работает без необходимой справочной информации, что ухудшает качество генерации кода и ответов.
• Разработчики, использующие общие справочники с пробелами в названиях, сталкиваются с «молчаливой» потерей данных.

Возможные обходные решения:

• Избегать пробелов в именах файлов и каталогов, использовать snake_case или kebab-case.
• При необходимости оставить читаемые названия, добавить символы экранирования (\ ) в пути, хотя официальной поддержки этого метода нет.

Что дальше: Пока Anthropic не опубликовала официального исправления, рекомендуется адаптировать структуру проекта под ограничения Claude Code. Следите за обновлениями в репозитории продукта и в официальных анонсах.

Источник: Habr AI – Как дать Claude Code документацию, которую он прочтёт