Claude Codeがなぜ修正漏れを起こすのか？CodeGraphが答える

AIコーディングノート  ·  2026.06.02  ·  約14分

Claude Codeの修正漏れ—CodeGraphとMCPでローカルコード知識グラフを照会

先月、あるチームがClaude Codeに決済モジュールのリファクタを依頼しました。

一見完璧でした：

  • 18ファイルを変更
  • 単体テスト合格
  • CIグリーン

本番ではWebhookコールバックが未修正—6つの隠れた呼び出しがリストに入りませんでした。

これはClaude Codeだけの問題ではありません。Cursor、GitHub Copilot、WindsurfのAIコーディングエージェントも同様—ファイルを読むのであって、コードのつながりを把握するわけではありません。

だからCodeGraphが2026年に広がったのです。ローカルでクエリ可能なコード知識グラフをMCP経由でClaude Codeに接続し、編集前にimpact analysisを走らせます。検索意図：Claude Code 修正漏れ、Cursor Composer、MCP、CodeGraph、大規模リポの索引がCloud Macにある理由。

18
変更済みでも漏れうる
MCP
Claude Code / Cursor
1
.codegraph索引

Claude Codeが修正漏れしやすい理由

「Claude Code 修正漏れ」「Claude Code monorepo」の検索は、モデルの賢さではなくなぜ一箇所の変更が伝播しないかへの疑問です。

Claude CodeはRead、Grep、複数ファイル編集、テスト実行が得意ですが、大規模リポでは呼び出しはグラフです：

  • 公開メソッドの改名—テスト内のextension conformanceが検索に出ない
  • プロトコルフィールド変更—モック・ジョブ・Webhookが別々に存在
  • 40ファイル読んでも41番目の間接参照はcontext外のことがある

「ビルド成功・テスト成功・本番で漏れ」。AIコーディングのボトルネックは既存コードの変更です。Claude Code vs CursorのUXは違っても、漏れの構造は同じ—決定的な影響範囲クエリがない。

Cursor Composerにコード知識グラフが必要な理由

CursorのComposerは大きなdiff向き。しかし公開API・決済契約・パッケージ横断の変更は「どのファイルが検索に出たか」依存のまま—Cursorの修正漏れもClaude Codeと同型です。

コード知識グラフは「誰がPaymentServiceを呼ぶか」を辺として辿れます。codegraph install --target=claude,cursorでIDEとターミナルが同じ必須変更リストを共有。

3つの構造図

本記事オリジナルの図です。

図1 · <code>PaymentService</code>変更前に参照元を列挙
図1 · PaymentService変更前に参照元を列挙
図2 · 通常Agent: Prompt→Search/Read→Edit
図2 · 通常Agent: Prompt→Search/Read→Edit
図3 · CodeGraph Agent: Prompt→CodeGraph→Impact→Edit→Test
図3 · CodeGraph Agent: Prompt→CodeGraph→Impact→Edit→Test

CodeGraphとは

CodeGraph（colbymchenry/codegraph）はtree-sitterでローカル索引し、.codegraph/codegraph.dbに保存。Claude Code／Cursorの代わりではなくリポの地図です。

codegraph_impactなど。iOS／SwiftではProtocol変更前のimpactがgrepより信頼できます。

チームがCodeGraphを標準にするタイミング

週末スクリプトに初日から不要。次のとき標準化：

  • 複数パッケージ・Xcodeターゲットで10ファイル超の変更が日常
  • 「テストOK・ステージングでWebhook不整合」型の事故
  • Claude CodeとCursorが同一モノレポで共有リストが必要

その規模ではCodeGraphはCI・レビュー・固定macOSビルドと並ぶAIコーディングチェック項目になる。

MCPでClaude CodeがCodeGraphを呼ぶ方法

Claude Code MCP検索の答えはModel Context Protocol—グラフ照会をセッション内ツールに。

  1. CodeGraph CLIをインストール
  2. codegraph install --target=claude,cursor --yes
  3. codegraph init -i
  4. CLAUDE.mdで公開API変更前にcodegraph_impact必須

PaymentService.chargeのリファクタ前にMCPでファイル一覧—Webhook漏れを防ぐ。

最小コマンド 
codegraph init -i
codegraph install --target=claude,cursor --yes
codegraph impact "PaymentService.charge" --depth 3

大規模リポの索引：多くのチームがCloud Macを使う

全量codegraph indexはCPU・ディスクIOを食い、10万行超では数十分かかります。MacBookではClaude CodeとXcodeと競合。

そのため：

  • Cloud Mac常駐ノードでcodegraph init -i
  • xcodebuildと同じセルフホストRunnerで実行
  • ローカルAIエージェントは照会のみ

グラフ版とビルド・テストを一致—Cloud Macを参照。

索引とビルドを同じ環境に

索引はCPU/IO負荷が高い。Xcodeビルドと同じmacOSホストで「昨日のローカルグラフ・今日のCI」を防ぐ—Swiftマルチターゲットで重要。

RAG・grep・巨大コンテキストだけでは足りない

手法得意修正漏れの盲点
ベクトルRAG意味的に似た断片本当の呼び出し元は似ていないことがある
Grep文字列一致間接呼び出し・動的ディスパッチ
200K+コンテキスト大量ファイル読み漏れ・コスト
CodeGraphシンボルimpact索引維持・小規模では過剰

CodeGraphで範囲→RAGで文脈→Claude Code/Cursorで編集→テスト。

ワークフロー：Claude Code + CodeGraph

  1. Cloud Macまたはローカルで.codegraph構築
  2. 決済・認証・公開API前にimpactまたはMCP
  3. リストに沿って編集・テスト
  4. Mac mini + Claude Codeと併用可

インストール・MCP・Before/After

手順・Monorepo・FAQ：

Claude Codeの修正漏れ—GitHubのCodeGraphが答える（2026）

本記事は「なぜ」、リンク先は「どう入れるか」。

FAQ

CodeGraphとSourcegraphの違いは？

Sourcegraphは人向けエンタープライズ検索。CodeGraphはAIコーディングエージェント向け—ローカルSQLite、MCPでimpact。併用可。

Swiftに使える？

はい。iOS/macOSマルチターゲット・SPM・Xcode向け。Protocol変更前にimpact。

Claude Codeと併用できる？

推奨。codegraph install後、codegraph_impactをツール呼び出し。

MCPは必須？

CLI単体可。Agentモードで自動照会するならMCP。

修正漏れの一言

ファイルは読むが関係は理解しない—公開シンボル変更前に影響リストが必要。

Composerに知識グラフ？

大diffでも間接呼び出しを逃す—共有索引で必須ファイルを統一。

索引はCloud Mac？

小規模はローカル可。大規模Swift/XcodeはCloud Macで索引、ローカルは照会。

ZavCloud · Cloud Mac

Cloud MacでCodeGraph索引、Claude Codeは編集に専念

索引・Xcodeビルド・MCPを一致—最新グラフで決済モジュールを変更。

Cloud Macプラン
Cloud MacCodeGraph索引を実行