Что происходит в первую очередь при каждом открытии среднего или крупного проекта в Claude Code или Cursor? Агент начинает активно вызывать grep, ls, cat, чтобы понять структуру кода. Десятки вызовов инструментов, тысячи токенов — и только в конце выясняется, «где находится входной файл этого проекта».
Идея CodeGraph проста: вместо того чтобы заставлять агента каждый раз исследовать всё заново, лучше заранее построить граф знаний кода, чтобы он мог обращаться к нему напрямую.
Какую реальную проблему он решает
Эта проблема серьёзнее, чем я думал изначально. В проекте с более чем 200 файлами первый сеанс Claude Code обычно требует 30–50 вызовов инструментов, чтобы сформировать базовое понимание структуры кода. Если считать по тарифам Claude API, только на «понимание проекта» каждый раз уходит от нескольких до десятков центов.
Подход CodeGraph заключается в превращении этого разового исследования в многоразовый индекс:
- Предварительная индексация: перед началом работы агента сканируется вся кодовая база и строится граф функций, классов, модулей и зависимостей.
- Локальная работа: данные индекса хранятся на 100% локально, без необходимости в облачных API.
- Поддержка нескольких агентов: совместим с Claude Code, Codex, Cursor, OpenCode — достаточно, чтобы агент поддерживал протокол MCP.
Каков результат? Согласно записям коммитов проекта, последняя оптимизация производительности сократила количество вызовов инструментов примерно на 70%, а потребление токенов — на 35%. Эти цифры взяты не из официальной рекламы, а прямо из сообщения коммита: perf(mcp): answer-directly steering — ~35% cheaper, ~70% fewer tool calls.
Статус проекта: очень активный
Данные GitHub проекта CodeGraph говорят сами за себя:
- 12 534 звезды, прирост за неделю 6 731 — второе место в трендах на этой неделе
- 287 коммитов, последний — 1 час назад (добавлена поддержка языков Lua/Luau)
- 34 открытых issue, 63 PR — активное участие сообщества
- 22 ветки, 7 тегов — упорядоченный темп разработки
Автор colbymchenry поддерживает проект в одиночку, но высокая частота слияния PR указывает на быстрый рост вовлечённости сообщества. Большинство из 63 ожидающих PR касаются поддержки языков и исправления ошибок, а не раздувания функционала.
Порог входа для практического использования
Судя по структуре файлов, путь установки CodeGraph довольно прозрачен:
- Наличие директорий
.claude/skillsи.cursor/rulesговорит о том, что предварительная настройка уже выполнена для двух основных платформ агентов - В директории
src/находится основная логика индексации - В
__tests__/обеспечено полное тестовое покрытие - Список поддерживаемых языков постоянно расширяется (недавно добавлены Lua/Luau)
Однако есть один нюанс, который стоит учитывать: в настоящее время он зависит от протокола MCP. Если ваш инструмент-агент не поддерживает MCP, подключить его не получится. Хорошая новость в том, что Claude Code и Cursor уже движутся в сторону поддержки MCP, но это означает, что вам, возможно, потребуется обновить версию инструментов.
Кому это подойдёт
Если вы ежедневно используете AI-агентов для программирования в средних и крупных проектах (100+ файлов), CodeGraph почти наверняка поможет вам сэкономить деньги и время. Индекс создаётся один раз, и в каждом последующем сеансе можно напрямую запрашивать структуру кода, не заставляя агента исследовать всё с нуля.
Если вы лишь изредка пишете небольшие скрипты или проект сам по себе невелик, выгода от этого инструмента будет неочевидной — затраты на индексацию могут превысить затраты на прямое исследование.
В каких сценариях я бы его использовал
Мой повседневный рабочий процесс: поддержка сайта на Astro, около 200 файлов Markdown + несколько десятков компонентов Astro/JS. Каждый раз, когда я прошу Claude Code помочь с рефакторингом или поиском проблем, время, затрачиваемое им на первичное исследование кода, действительно раздражает. Если CodeGraph будет работать стабильно, он станет одним из первых инструментов, которые я подключу.
Сначала запущу индексацию, а затем понаблюдаю за изменением количества вызовов инструментов. Если данные из коммитов (сокращение на 70%) подтвердятся на моём проекте, стоимость использования этого инструмента будет практически нулевой — сэкономленные на токенах средства с лихвой перекроют затраты на хранение индекса.
Далее посмотрю, добавит ли он поддержку большего количества фреймворков для агентов, и удастся ли автоматизировать механизм обновления индекса (как граф будет инкрементально обновляться после изменений в коде).
Основной источник: GitHub - colbymchenry/codegraph