CodeGraph: прединдексированный граф знаний кода для Claude Code

«94% fewer tool calls • 77% faster exploration • 100% local» — именно так авторы описывают суть проекта.

Что это и для кого

Когда Claude Code исследует кодовую базу, он запускает Explore-агентов, которые сканируют файлы через grep, glob и Read — тратя токены на каждый вызов инструмента. CodeGraph даёт этим агентам прединдексированный граф знаний — связи между символами, граф вызовов и структуру кода — и агенты мгновенно обращаются к графу вместо того, чтобы сканировать файлы.

CodeGraph — это локальная система code-intelligence, которая строит семантический граф знаний из любой кодовой базы, обеспечивая структурное понимание связей в коде с помощью tree-sitter для AST-парсинга и SQLite для хранения.

Целевая аудитория:

• Разработчики, активно использующие Claude Code и страдающие от высоких затрат на токены при исследовании больших репозиториев
• Команды, работающие с монорепозиториями или legacy-кодом на десятках тысяч файлов
• Те, кто ценит приватность: никакие данные не покидают машину

Как работает CodeGraph

graph TD
    A[Claude Code: задача] --> B[Explore Agent]
    B --> C{.codegraph/ существует?}
    C -- Да --> D[CodeGraph MCP Server]
    C -- Нет --> E[grep / glob / Read файлов]
    D --> F[SQLite Graph DB]
    F --> G[Символы, рёбра, call graph]
    G --> B
    E --> H[Медленный обход файлов]
    B --> I[Ответ агента]

CodeGraph индексирует кодовую базу один раз с помощью tree-sitter парсинга: каждая функция, класс, метод и связь между ними попадают в локальную SQLite-базу. Claude Code подключается через MCP и, когда нужно понять код, обращается к графу вместо того, чтобы исследовать файлы вручную.

Ключевые возможности

1. Прединдексированный граф символов

Инструмент обеспечивает структурное понимание связей кода — не просто текстовое сходство, — позволяя AI-ассистентам понимать, как код соединён, что от чего зависит и что сломается при изменениях.

2. Широкая языковая поддержка

Поддерживаются TypeScript, JavaScript, Python, Go, Rust, Java, C#, PHP, Ruby, C, C++, Swift, Kotlin, Dart, Svelte, Liquid, Pascal/Delphi.

3. Автосинхронизация через FileWatcher

File watcher использует нативные события ОС (FSEvents/inotify/ReadDirectoryChangesW) с дебаунсированной автосинхронизацией — граф остаётся актуальным по мере написания кода, без какой-либо конфигурации.

4. Полная локальность и приватность

Никакие данные не покидают машину. Не требуются API-ключи. Нет внешних сервисов. Только SQLite-база данных.

5. MCP-инструменты для агентов

Доступны следующие инструменты:

• codegraph_search — поиск символов по имени
• codegraph_context — получение релевантного контекста для задачи
• codegraph_callers — поиск вызывающих функций
• codegraph_callees — поиск вызываемых функций
• codegraph_impact — анализ, что затронет изменение символа
• codegraph_node — детали и исходный код символа
• codegraph_files — структура файлов проекта из индекса

6. Масштабируемость на огромных кодовых базах

Самый крупный протестированный репозиторий — компилятор Swift (25 874 файла, 272 898 узлов): CodeGraph проиндексировал его менее чем за 4 минуты, а агент ответил на сложный вопрос за 35 секунд, сделав 6 вызовов codegraph_explore и ноль чтений файлов.

Установка и начало работы

# Установка глобально через npm
npm install -g @colbymchenry/codegraph

# Или запуск без установки
npx @colbymchenry/codegraph

# Интерактивный установщик (конфигурирует MCP и Claude Code)
codegraph install

# Инициализация в проекте
codegraph init /path/to/project

# Полная индексация
codegraph index

# Инкрементальное обновление
codegraph sync

# Статус индекса
codegraph status

Установщик автоматически конфигурирует MCP-сервер и разрешения. Claude Code начнёт автоматически использовать инструменты CodeGraph, как только в проекте появится директория .codegraph/.

Конфигурация MCP (.claude/settings.json)

{
  "mcpServers": {
    "codegraph": {
      "type": "stdio",
      "command": "codegraph",
      "args": ["serve", "--mcp"]
    }
  }
}

Бенчмарки: реальные результаты

Тестирование проводилось на 6 реальных кодовых базах — сравнивался Explore-агент Claude Code с CodeGraph и без него. Все тесты использовали Claude Opus 4.6 (контекст 1M) с Claude Code v2.1.91, каждый тест запускал одного Explore-агента с одним и тем же вопросом.

С CodeGraph агент ни разу не возвращался к чтению файлов — он полностью доверял результатам codegraph_explore. Без CodeGraph агенты тратили большую часть времени на обнаружение (find, ls, grep), прежде чем начать читать релевантный код. Для Java-кодовой базы хватило всего 1 вызова codegraph_explore, чтобы ответить на весь вопрос.

По итогам бенчмарков: Explore-агенты используют ~94% меньше вызовов инструментов и работают ~82% быстрее.

Тарифы и цены

CodeGraph — полностью бесплатный open-source проект (MIT-лицензия), доступный на GitHub и в npm-реестре. Никаких платных планов, подписок или токенов нет. Единственные затраты — это токены самого Claude Code, которые инструмент как раз и сокращает.

Плюсы и минусы

Сравнение с альтернативами

tokensave — это переписанный с нуля на Rust аналог CodeGraph (Node.js/TypeScript). Оба строят семантические графы кода для AI-агентов, но существенно различаются по масштабу возможностей. CodeGraph стал пионером подхода и остаётся надёжным выбором, если вам нужна только интеграция с Claude Code через npm.

code-review-graph — ещё один локальный граф знаний для Claude Code, строящий персистентную карту кодовой базы; заявленная экономия — 6,8× меньше токенов на ревью и до 49× на повседневных задачах.

Вердикт

CodeGraph — это элегантное и прагматичное решение реальной проблемы: бесконечное «переоткрытие» кода агентами Claude Code от сессии к сессии. Ни одно из существующих решений (markdown-файлы памяти, ручное копирование контекста) не даёт Claude то, что ему действительно нужно — реальное понимание того, как код связан между собой. Именно в этом идея CodeGraph.

Кому подойдёт:

• Разработчикам, работающим с Claude Code на средних и крупных проектах (от 1 000 файлов)
• Тем, кто ценит приватность и не хочет отправлять код во внешние сервисы
• Командам, активно использующим TypeScript, Python, Go, Rust или Java

Кому не подойдёт:

• Пользователям Cursor, GitHub Copilot или других агентов (только Claude Code)
• Проектам, где требуется семантический поиск по смыслу кода, а не по структуре

Рейтинг: 8/10 — мощный инструмент с конкретными измеримыми результатами, ограниченный только привязкой к Claude Code и отсутствием векторного поиска.