Почему Claude Code пропускает правки?Ответ — CodeGraph

Заметки об AI coding  ·  2026.06.02  ·  ~14 мин

Claude Code missed edits; CodeGraph and MCP query a local code knowledge graph

В прошлом месяце команда поручила Claude Code рефакторинг платёжного модуля.

На бумаге всё идеально:

  • Изменено 18 файлов
  • Юнит-тесты прошли
  • CI зелёный

После релиза: webhook-callback невернышесть скрытых вызовов не попали в список.

Это не только Claude. Cursor, Copilot, WindsurfAI coding-агенты читают файлы, а не всегда понимают связи в коде.

Поэтому в 2026 выстрелил CodeGraph: локальный граф знаний о коде через MCP для Claude Code и impact analysis до правок. И почему индекс часто на Cloud Mac.

18
файлов — риск остаётся
MCP
Claude Code / Cursor
1
индекс .codegraph

Почему 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.

Три схемы

Оригинальные иллюстрации статьи.

Рис. 1 · Ссылки перед изменением <code>PaymentService</code>
Рис. 1 · Ссылки перед изменением PaymentService
Рис. 2 · Обычный agent
Рис. 2 · Обычный agent
Рис. 3 · CodeGraph workflow
Рис. 3 · CodeGraph workflow

Что такое 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 — запросы к графу как инструменты сессии.

  1. Установить CLI
  2. codegraph install --target=claude,cursor --yes
  3. codegraph init -i
  4. В 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+Много файловПропуски, цена
CodeGraphImpact по символамПоддержка индекса

CodeGraph → RAG → правки → тесты.

Workflow: Claude Code + CodeGraph

  1. Собрать .codegraph
  2. Impact/MCP перед API
  3. Править по списку
  4. 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.

ZavCloud · Cloud Mac

Индекс CodeGraph на Cloud Mac

Индекс, Xcode и MCP в одной линии.

Тарифы Cloud Mac
Cloud MacИндекс CodeGraph