Чем больше проект, тем дороже каждый запрос к Claude Code: модель заново читает файлы, чтобы понять структуру. Есть более дешёвый путь — построить карту проекта один раз и объяснить Claude Code, что сначала нужно смотреть в неё, а сырые файлы читать только по явной просьбе. Разбираем, как это настроить и зачем нужен именно граф, а не просто список файлов.
Суть подхода: карта вместо пересканирования
Обычный Claude Code при старте сессии ориентируется по файлам вручную — открывает, читает, сопоставляет. Если структура проекта сложная, это происходит заново каждый раз. Открытые community-навыки (например, Graphify) решают это иначе: один проход сканирует всю папку и строит граф — узлы файлов и связи между ними — который дальше и служит компактной картой вместо десятков разрозненных файлов в контексте.
Шаг 1 — поставить навык для построения графа
Такие навыки устанавливаются как обычный Claude Code skill — команда из README проекта, без правки исходного кода. После установки навык доступен как отдельная команда, которая сканирует текущую папку и строит граф связей между файлами: конфигами, промптами, настройками.
Шаг 2 — прописать правило в CLAUDE.md
Сам по себе установленный навык не используется автоматически — Claude Code не обязан обращаться к графу, если ему явно не сказать. Правило добавляется в CLAUDE.md, который Claude Code читает перед стартом любой сессии:
## Навигация по контексту
1. Сначала запрашивай граф проекта, а не листай файлы по одному.
2. Читай сырые файлы только тогда, когда это явно нужно для
конкретной правки — не сканируй всё подряд «на всякий случай».
3. Если граф устарел (после крупных изменений структуры) —
перестрой его заново перед следующей задачей.
Без этой записи навык просто лежит рядом с проектом и не подключается к рабочему процессу.
Шаг 3 — что видно в самой карте
После построения граф показывает не файлы по отдельности, а связи: какие конфиги используются в каких промптах, какие модули друг на друга ссылаются. Это компактная схема, а не список из десятков строк — и именно она заменяет ручное пролистывание файлов при каждом новом запросе.
Шаг 4 — как это меняет планирование задач
Когда у Claude Code есть карта, план работы строится по конкретным связям, а не по предположениям: сначала определяется, какие файлы и конфиги реально относятся к задаче, затем — порядок правок. На практике это меньше вопросов вида «а какой файл тут поправить» и меньше правок мимо цели с первого раза.
Полная инструкция для CLAUDE.md
Финальный блок, который стоит держать в CLAUDE.md целиком (можно адаптировать формулировки под свой проект, смысл правил менять не стоит):
## Навигация по контексту
1. Сначала запрашивай граф проекта.
2. Читай сырые файлы только по прямой просьбе.
3. Перестраивай граф после структурных изменений.
Как это делаем мы
В базе знаний qvib.pro больше пятисот открытых карточек — в том числе по настройке CLAUDE.md и работе с контекстом Claude Code, без директов и кодовых слов. Идея «карта проекта вместо пересканирования» — тот же принцип, на котором строится наш движок qvib: он держит структуру проекта явно, а не восстанавливает её заново при каждой генерации.
Ссылки по теме
- Раздел «Skills Claude»: qvib.pro/arsenal/skills/claude-skills
- Промпты для настройки CLAUDE.md: qvib.pro/arsenal/prompts/claude-md-context
- Как работает движок qvib: qvib.pro/