В прошлом месяце команда поручила Claude Code рефакторинг платёжного модуля.
На бумаге всё идеально:
- Изменено 18 файлов
- Юнит-тесты прошли
- CI зелёный
После релиза: webhook-callback неверны — шесть скрытых вызовов не попали в список.
Это не только Claude. Cursor, Copilot, Windsurf — AI coding-агенты читают файлы, а не всегда понимают связи в коде.
Поэтому в 2026 выстрелил CodeGraph: локальный граф знаний о коде через MCP для Claude Code и impact analysis до правок. И почему индекс часто на Cloud Mac.
Почему Claude Code пропускает правки
Запросы Claude Code missed edits — про почему изменение не распространилось, а не про «ум» модели.
Claude Code читает, grep-ит, правит, тестирует — но в большом репо вызовы — это граф:
- Переименовали публичный метод — conformance в тестах не в выдаче.
- Поле протокола — моки, джобы, webhook в разных углах.
- 40 файлов в контексте — 41-й косвенный вызов может отсутствовать.
Сборка и тесты зелёные, прод красный. Claude Code vs Cursor — разный UX, одна дыра: нет детерминированного impact.
Зачем Cursor Composer нужен граф кода
Composer любит большие diff; публичные API и платёжные контракты всё ещё от поиска — пропуски в Cursor того же типа.
Граф знаний превращает «кто вызывает PaymentService» в обходимые рёбра. Общий .codegraph через codegraph install --target=claude,cursor.
Три схемы
Оригинальные иллюстрации статьи.
PaymentService
Что такое CodeGraph
CodeGraph индексирует локально (tree-sitter) в .codegraph/codegraph.db — карта репозитория для AI coding-агентов.
codegraph_impact и др. Для iOS/Swift impact перед сменой Protocol надёжнее grep.
Когда команды делают CodeGraph стандартом
Для разового скрипта не нужен. Сигналы:
- Несколько пакетов или Xcode targets, >10 файлов за правку
- Инцидент «тесты зелёные, staging — webhook»
- Claude Code и Cursor в одном monorepo — общий список
Тогда CodeGraph входит в чеклист AI coding вместе с CI, ревью и фиксированным macOS-сборщиком.
Как MCP подключает CodeGraph к Claude Code
Model Context Protocol — запросы к графу как инструменты сессии.
- Установить CLI
codegraph install --target=claude,cursor --yescodegraph init -i- В
CLAUDE.md: impact перед публичным API
Список файлов через MCP до рефакторинга — webhook не забудут.
codegraph init -i codegraph install --target=claude,cursor --yes codegraph impact "PaymentService.charge" --depth 3
Большие репо: индекс на Cloud Mac
Полный codegraph index грузит CPU/IO — на 100k+ строк часто десятки минут.
Поэтому:
codegraph init -iна Cloud Mac- Тот же self-hosted runner, что и
xcodebuild - Локальные агенты только читают граф
Версия графа = сборка = тесты — тарифы Cloud Mac.
Индекс рядом со сборкой
Тяжёлая индексация на том же macOS, что Xcode — меньше «вчерашний граф, сегодняшний CI» в Swift multi-target.
RAG, grep и огромный контекст не спасают сами
| Подход | Силён | Слепая зона |
|---|---|---|
| Векторный RAG | Похожие фрагменты | Истинные вызывающие не «похожи» |
| Grep | Строки | Косвенные вызовы |
| Контекст 200K+ | Много файлов | Пропуски, цена |
| CodeGraph | Impact по символам | Поддержка индекса |
CodeGraph → RAG → правки → тесты.
Workflow: Claude Code + CodeGraph
- Собрать
.codegraph - Impact/MCP перед API
- Править по списку
- Mac mini + Claude Code
Установка
Пошагово:
Claude Code пропускает правки — CodeGraph на GitHub (2026)
Здесь «зачем»; по ссылке «как».
FAQ
CodeGraph vs Sourcegraph?
Sourcegraph — поиск для людей. CodeGraph — для AI coding-агентов, локально, MCP.
Swift?
Да — iOS/macOS, SPM, Xcode; impact перед Protocol.
С Claude Code?
Да — codegraph_impact в сессии.
Нужен MCP?
CLI отдельно; авто-запросы в agent mode — MCP.
Кратко
Читает файлы, не связи.
Composer + граф?
Большой diff без косвенных вызовов — общий индекс.
Cloud Mac?
Малый репо локально; крупный Swift — индекс на Cloud Mac.
- См. также— Claude Code vs Cursor · Экосистема Claude Code
ZavCloud · Cloud Mac
Индекс CodeGraph на Cloud Mac
Индекс, Xcode и MCP в одной линии.
Тарифы Cloud Mac