Graphify в Claude Code 2026: карта проекта за 4 секунды

Поставить Graphify: что увидишь после каждой команды

Пакет на сайте пакетов называется graphifyy, с двумя буквами y на конце, а команда после установки короткая, graphify. Это самая частая причина, по которой человек решает, что «ничего не поставилось»

Шаг 1. Установщик uv. Это магазин приложений для окна команд: он ставит инструменты на Python в отдельные папки и ничего в системе не ломает. После brew install uv побегут строки загрузки, и окно вернёт приглашение ввода. Если Mac ответил «command not found: brew», значит Homebrew у тебя не стоит, и он не нужен: вставь официальную строку установки с сайта uv, она же стоит в README Graphify, и нажми Enter:

curl -LsSf https://astral.sh/uv/install.sh | sh

После неё закрой окно команд и открой заново тем же способом, чтобы оно увидело новую команду. Проверка для любого пути: uv --version печатает номер версии. Это даёт тебе способ ставить и сносить такие инструменты одной строкой

Шаг 2. Сам Graphify. После uv tool install graphifyy появится строка вроде «Installed 30 packages» и имя команды graphify. Проверка: graphify --version печатает версию, у меня 0.9.69. Если в ответ пришло «command not found», выполни uv tool update-shell и открой новое окно команд: команда лежит в папке, которую окно ещё не видит

Шаг 3. Подключение к помощнику. Третья строка, graphify install, копирует скилл в настройки Claude Code и печатает, куда положил. С этой секунды помощник понимает команду /graphify. Если хочешь держать всё внутри одного проекта, добавь --project: файлы лягут в папку проекта, и их можно отдать коллеге вместе с кодом

Шаг 4. Правила чтения карты. Четвёртая строка, graphify claude install, велит помощнику читать карту вместо файлов и печатает две строки: куда записана секция graphify и что перехватчики зарегистрированы. Что это значит и как проверить, разобрано ниже в разделе про подключение

Исходники инструмента открыты и лежат на GitHub, у страницы проекта 121,8 тысячи звёзд. Качать их руками не нужно: команды выше берут готовый пакет. Страница пригодится, когда захочешь прочитать, что изменилось в новой версии

Если Claude Code у тебя ещё не стоит, сначала пройди установку Claude Code одной строкой, потом возвращайся сюда. А если ставишь надстройки не первый раз, сверься со списком из 12 надстроек Claude Code: Graphify туда не входит, он закрывает отдельную дыру

Как понять, что карта собралась

После /graphify . загляни в папку проекта. Там появилась graphify-out, внутри три главных файла: graph.json (сама карта для машины), graph.html (карта для глаз) и GRAPH_REPORT.md (отчёт словами). Открой graph.html двойным щелчком, он откроется в браузере

Ты увидишь тёмный экран с цветными точками и линиями. Каждая точка это файл, класс или функция твоего проекта, линия между ними значит «этот файл использует тот». Справа список COMMUNITIES: инструмент сам разбил проект на разделы, как оглавление книги, и у каждого раздела стоит число элементов. В самом низу строка с итогами. У меня на проекте Flask она выглядела так: 2168 nodes · 3449 edges · 192 communities, то есть 2168 элементов, 3449 связей, 192 раздела

Отчёт GRAPH_REPORT.md весит 37 килобайт при исходниках почти в 1,9 мегабайта: в 49 раз меньше. Ровно это и экономит лимиты: помощник читает 37 килобайт оглавления вместо мегабайт кода. В отчёте есть строка Token cost: 0 input · 0 output. Она подтверждает, что карту собрал не ИИ, а обычная программа на твоём компьютере, и наружу код не уходил

Что у тебя будет с другим числом. Маленький проект на десять файлов даст десятки элементов и один или два раздела, это нормально. Пустая карта с нулём элементов значит, что команду запустили не в той папке: проверь, что в окне команд ты стоишь внутри проекта, а не на рабочем столе

Подключить карту к Claude Code, чтобы он читал её, а не файлы

Карта в папке ещё не значит, что помощник в неё смотрит. Подключение делает четвёртая команда из начала статьи. Если ты её пропустил, вот она: скопируй строку, вставь в окно команд внутри папки проекта и нажми Enter. В ответ увидишь две строки: куда записана секция graphify и что перехватчики зарегистрированы

graphify claude install

Что она пишет. В файл CLAUDE.md (памятку, которую Claude Code читает в начале каждого чата) добавляется раздел graphify с правилами: на вопрос про код сначала спросить карту командой graphify query, полный отчёт читать только для обзора архитектуры, после правок кода обновить карту. В настройки проекта добавляются два перехватчика: правила, которые срабатывают до того, как помощник полезет искать по файлам или читать их подряд, и подсовывают ему путь через карту. Если ты уже вёл памятку руками, посмотри разбор CLAUDE.md: секция graphify встанет рядом с твоими правилами и не сотрёт их. Чем вообще правят то, что помощник держит в голове между чатами, разобрано в статье про контекст-инжиниринг

Если ставил с флагом --project на первом шаге, этот раздел и перехватчики у тебя уже стоят: у меня graphify install --project записал их сразу, и повторный graphify claude install ответил, что всё уже настроено

Теперь, когда ты спрашиваешь «где у меня считается цена в корзине?», помощник запускает запрос к карте и получает короткий список: какие файлы и функции связаны с корзиной и в какой строке лежит каждая. Тот же вопрос можно задать и руками, чтобы увидеть, что он получает:

graphify query "где считается цена в корзине"

В ответ придёт список элементов с адресом файла и строки. У меня вопрос про создание объекта приложения вернул 16 элементов и 13 связей, это меньше тысячи токенов вместо чтения десятка файлов целиком. Токены это кусочки слов, которыми считают объём текста и по которым тают лимиты: чем меньше кусочков помощник прочитал, тем дольше держится полоса

Ту же карточку показывает и graph.html: набери имя в поле Search nodes, и справа появится блок NODE INFO с файлом, числом связей и списком соседей

Три вопроса, которые можно задать карте руками или через помощника, и что приходит в ответ:

Если имя встречается в нескольких файлах, инструмент честно скажет об этом и попросит уточнить путь: у меня так вышло с именем Flask, оно есть в четырёх местах

Как понять, что лимиты перестали сгорать впустую

Самый честный способ проверить, а не поверить: задать помощнику один и тот же вопрос про проект дважды, до карты и после, каждый раз в новом чате, и сравнить, сколько он работал

Я так и сделал на клоне проекта Flask. Две одинаковые копии проекта, в одной карта и перехватчики стоят, в другой нет. Вопрос один: в каком файле определён главный класс и в каком файле лежит функция, которая регистрирует маршрут. Модель одна и та же, настройки только из папки проекта, чтобы ничего постороннего не мешало

Ответ совпал слово в слово, а прочитано на треть меньше, заново прочитанного, за которое платишь полной ценой, в 3,4 раза меньше, ходов на два меньше. На одном вопросе разница кажется мелкой. За день ты задаёшь таких вопросов десятки, и каждый новый чат без карты начинается с того же перечитывания

Как повторить у себя. В Claude Code набери /usage: подписчикам Pro и Max он показывает полосы расхода плана и разбивку, кто его съел. Запомни положение полосы, задай вопрос про свой проект в новом чате без карты, посмотри, на сколько полоса сдвинулась и сколько ходов сделал помощник. Поставь карту, повтори в новом чате. Второй раз помощник должен сделать меньше ходов и меньше раз открыть файлы: вместо чтения по одному ты увидишь в его действиях команду graphify query. Что изменилось в самих лимитах этой осенью, разобрано в статье про лимиты Claude Code с 14 сентября

Одно условие, без которого проверка провалится: после правок в коде карту надо обновить командой graphify update .. Она отрабатывает за секунды и нейросеть не трогает. Устаревшая карта хуже её отсутствия: помощник пойдёт по старым адресам, не найдёт и начнёт читать файлы заново

Если у тебя другой случай

Работаешь не в Claude Code, а в Cursor, Codex или Gemini. Первые два шага те же, а подключение своё: graphify cursor install, graphify codex install, graphify gemini install. Для Cursor и Codex правила ложатся в их файлы инструкций, перехватчиков там нет

В проекте не только код, а ещё документы, PDF и картинки. Код инструмент разбирает сам, а смысл документов достаёт через помощника: команда /graphify . внутри Claude Code прочитает их той моделью, на которой работает твой чат, и это потратит лимит один раз. Если документы в карте не нужны, добавь --code-only, и наружу не уйдёт ничего

Проект большой, карта открывается медленно. У меня graph.html на 2168 элементов открывался 9 секунд. Если элементов десятки тысяч, собирай без картинки: /graphify . --no-viz. Отчёт и карта для помощника при этом остаются. Как вести большой проект в Claude Code целиком, от плана до проверки, разобрано в схеме из четырёх звеньев

Хочешь, чтобы карта обновлялась сама. Команда graphify hook install вешает обновление на каждое сохранение изменений в истории проекта. Тогда шаг «не забыть обновить» исчезает. Это одна из тех привычек, которые отличают людей с результатом, их разбор в статье про три привычки Claude Code

Windows. Окно команд Windows считает слэш в начале строки разделителем пути. В самом Claude Code пиши /graphify . как везде, а в окне команд без слэша: graphify .

Что ломается и что делать

Первые две строки я поймал у себя, остальные взяты из раздела про сбои у самих авторов:

Источники

Страницы открыты 27 сентября 2026 года. Карта, кадры и замер токенов сняты мной на своём компьютере

• Graphify на GitHub - установка, команды, подключение к Claude Code, раздел Troubleshooting
• Пакет graphifyy на PyPI - официальное имя пакета с двумя y
• BENCHMARKS.md проекта - сборка карты без единого запроса к нейросети
• Установка uv - строки установки для Mac, Windows и Linux
• Справка Claude Code по перехватчикам - как срабатывают правила до вызова инструмента
• Справка Claude Code по расходу - команда /usage для подписчиков Pro и Max
• Собственный прогон 27 сентября 2026 года: сборка карты на клоне проекта Flask, подключение к Claude Code, один вопрос помощнику без карты и с картой

Памятка: Graphify в Claude Code за шесть команд

Открыть через неделю без статьи

Частые вопросы