то знаете боль:
-
Нейросеть начинает бесцельно бегать по файлам
-
Токены сгорают космическими темпами
-
Контекст постоянно вылетает за лимиты
-
Агент теряет нить, перескакивает между файлами и в итоге выдаёт поверхностный результат
Особенно остро проблема стоит, когда нужно не просто ответить на вопрос, а реально разобраться в архитектуре — найти зависимости, понять связи между классами, оценить влияние изменений.
Решение: CodeGraph — строим граф кода и отдаём ИИ только нужное
Разработчик Colby McHenry создал инструмент, который радикально меняет подход к работе ИИ-агентов с большими кодовыми базами.
CodeGraph — это утилита, которая:
-
Индексирует весь репозиторий (даже с тысячами файлов)
-
Строит граф функций, классов и зависимостей между ними
-
Передаёт ИИ-агенту не сырой код, а структурированный контекст — только те части, которые действительно нужны для решения задачи
В результате нейросеть перестаёт «блуждать» по проекту и начинает работать с точной картой связей.
Что умеет CodeGraph: ключевые возможности
| Возможность | Что даёт на практике |
|---|---|
| Индексация репозитория | Понимает структуру проекта за минуты, а не за часы |
| Построение графа зависимостей | Видит, какие функции вызывают другие функции, где используются классы |
| Локальная работа | Всё происходит на вашей машине — никакой утечки кода в облачные API |
| Приватность | Можно использовать с проприетарными проектами без риска |
| Отсутствие лимитов | Не ограничены размером контекстного окна ИИ, потому что передаётся только сжатый граф |
Инструмент работает без ограничений по размеру репозитория. Поддерживает большинство популярных языков программирования (Python, JavaScript, TypeScript, Go, Rust, Java и другие).
Цифры, которые говорят сами за себя
Разработчик протестировал CodeGraph на реальных проектах и получил впечатляющие результаты.
Снижение количества вызовов кода
ИИ-агент перестаёт «стучаться» в каждый файл наугад. Он получает карту и идёт прямо к нужным узлам.
Результат: количество вызовов кода снижается на 92%.
Ускорение изучения проекта
Нейросеть тратит меньше токенов на «разведку» и больше — на решение реальных задач.
Результат: скорость изучения проекта (понимание архитектуры, поиск нужных модулей, анализ зависимостей) вырастает на 71%.
Пример с агентом Hermes
Для ИИ‑агента Hermes CodeGraph построил контекст из 3479 файлов всего за три минуты.
Раньше такая операция либо вылетала за лимиты токенов, либо требовала десятков вызовов и ручной фильтрации файлов.
Как это работает технически
-
Сканирование репозитория — инструмент обходит все файлы проекта, игнорируя бинарники, кэш и стандартные исключения (gitignore)
-
Построение графа — выделяются все функции, классы, методы и точки их вызовов. Строятся направленные связи (кто кого вызывает, кто от кого наследует)
-
Передача ИИ-агенту — агенту отправляется не сырой код тысяч файлов, а компактное описание графа с указанием, какие части кода к каким задачам относятся
-
Точечный доступ к коду — когда агенту действительно нужен конкретный файл или функция, он запрашивает их по индексу, а не перебирает всё подряд
Дополнительный бонус: можно использовать CodeGraph даже с локальными моделями (например, через Ollama или LM Studio). Всё работает приватно, без отправки кода во внешние API.
Кому особенно пригодится CodeGraph
-
Разработчикам крупных проектов (монолиты, микросервисные архитектуры с сотнями сервисов)
-
DevOps-инженерам, которые хотят анализировать влияние изменений на всю систему
-
Исследователям в области AI‑кодинга — для тестирования агентов на реальных репозиториях
-
Техлидам — для быстрого онбординга новых разработчиков (агент объясняет архитектуру, а не вы)
-
Всем, кто устал платить за сгоревшие токены из‑за неэффективного контекстного окна
Пример использования (быстрый старт)
# Установка pip install codegraph # Индексация репозитория codegraph index /path/to/your/repo # Запуск ИИ-агента с использованием графа codegraph query "Где в проекте обрабатывается авторизация пользователей?" --agent claude
Инструмент полностью открыт, распространяется под лицензией MIT. Исходный код доступен на GitHub.
Что в итоге: мастхев для крупных проектов
Если у вас:
-
проект размером от десятков тысяч строк кода
-
ИИ-агент постоянно вылетает за лимиты или жжёт токены вхолостую
-
вы хотите сохранить приватность кода (никаких облачных API)
-
нужно ускорить работу нейросети с кодом в разы
CodeGraph — это мастхев.
Инструмент строит граф зависимостей, отдаёт агенту только нужный контекст и экономит до 92% вызовов кода. Проект индексируется локально за минуты, без ограничений и без утечки данных.
Вопрос для читателей
Работаете ли вы с ИИ-агентами на больших репозиториях? Как решаете проблему лимитов токенов и потери контекста? Делитесь инструментами и подходами в комментариях.






