概要
CodeGraph はコードベースに対して事前インデックス化されたナレッジグラフを構築し、Claude Code の探索エージェントがファイルをスキャンすることなくシンボル関係を迅速にクエリできるようにします。19 以上の言語とフレームワークのルート認識をサポートし、完全にローカルで動作し、ツール呼び出しを最大 96% 削減し、探索速度を 70% 以上向上させます。
README プレビュー
\n\n# CodeGraph\n\n### Supercharge Claude Code with Semantic Code Intelligence\n\n**94% fewer tool calls · 77% faster exploration · 100% local**\n\n[](https://www.npmjs.com/package/@colbymchenry/codegraph)\n[](https://opensource.org/licenses/MIT)\n[](https://nodejs.org/)\n\n[](#)\n[](#)\n[](#)\n\n\n\n### Get Started\n\n```bash\nnpx @colbymchenry/codegraph\n```\n\nInteractive installer configures Claude Code automatically\n\n#### Initialize Projects\n\n```bash\ncd your-project\ncodegraph init -i\n```\n\n\n\n\n\n---\n\n## Why CodeGraph?\n\nWhen Claude Code explores a codebase, it spawns **Explore agents** that scan files with grep, glob, and Read — consuming tokens on every tool call.\n\n**CodeGraph gives those agents a pre-indexed knowledge graph** — symbol relationships, call graphs, and code structure. Agents query the graph instantly instead of scanning files.\n\n### Benchmark Results\n\nTested across 6 real-world codebases comparing Claude Code's Explore agent **with** and **without** CodeGraph:\n\n> **Average: 92% fewer tool calls · 71% faster**\n\n| Codebase | With CG | Without CG | Improvement |\n|----------|---------|------------|-------------|\n| **VS Code** · TypeScript | 3 calls, 17s | 52 calls, 1m 37s | **94% fewer · 82% faster** |\n| **Excalidraw** · TypeScript | 3 calls, 29s | 47 calls, 1m 45s | **94% fewer · 72% faster** |\n| **Claude Code** · Python + Rust | 3 calls, 39s | 40 calls, 1m 8s | **93% fewer · 43% faster** |\n| **Claude Code** · Java | 1 call, 19s | 26 calls, 1m 22s | **96% fewer · 77% faster** |\n| **Alamofire** · Swift | 3 calls, 22s | 32 calls, 1m 39s | **91% fewer · 78% faster** |\n| **Swift Compiler** · Swift/C++ | 6 calls, 35s | 37 calls, 2m 8s | **84% fewer · 73% faster** |\n\n\nFull benchmark details\n\nAll tests used Claude Opus 4.6 (1M context) with Claude Code v2.1.91. Each test spawned a single Explore agent with the same question.\n\n**Queries used:**\n| Codebase | Query |\n|----------|-------|\n| VS Code | "How does the extens
FAQ (5)
feature_inquiryCodegraphはコード変更後に自動的に同期しますか？
はい、Codegraphはバージョン0.9.4以降、MCPサーバーが動作している場合、ファイル変更のたびに自動的に同期します。内蔵のFileWatcherを使用し、記号とエッジを約3秒以内にインクリメンタルに再インデックスするため、手動のcodegraph syncやcodegraph indexコマンドは不要です。以前のバージョンでは、コード変更後に手動でcodegraph indexを実行して更新する必要がありました。
トラブル対応codegraphは、barrel re-exportsを通じてインポートされたコンポーネントに対して、なぜ呼び出し元が0と表示するのですか？
これはcodegraph v0.9.8以前の既知のバグで、特定のバレル形式が解決されず、エッジの欠落やライブコンポーネントの誤った 0 callers/impact を引き起こします。影響を受ける形式: export { default as X } from './X.svelte'、裸の import from './' または from '.'、およびワークスペースのパッケージサブパスインポート（@scope/pkg/sub）。修正（PRs #657, #659）はすでにマージされており、v0.9.8の次のリリースで出荷されます。最新バージョン（v0.9.9+）にアップグレードして解決してください。一時的な確認として、codegraph callees <file> を使用して、インポートが未解決/生のノードとして表示されるかどうかを確認できます。
トラブル対応Windows で codegraph daemon を起動するか、ブランチを切り替えるときにコンソールウィンドウが一瞬表示されるのはなぜですか？
codegraph v0.9.7以降にアップグレードしてください。v0.9.6のこのバグにより、git.exeの実行（例：git ls-files、git rev-parse）がwindowsHide: trueなしで行われ、コマンドプロンプトのウィンドウが表示される問題が発生していました。v0.9.7での修正により、すべてのgit/npmの子プロセスにwindowsHideが追加され、ちらつきが解消されました。
トラブル対応Windows上でcodegraph MCPサーバーを実行しているとき、コンソールウィンドウが1秒ごとに点滅するのはなぜですか？
Windows 上の codegraph v1.6.1 では、デフォルトのファイルウォッチャーが約 1 秒ごとに git ls-files を実行します。MCP ホストが CREATE_NO_WINDOW を指定した GUI プロセスから起動される場合、Node.js は windowsHide: true を付けずに git.exe を spawn するため、そのたびに Windows が表示状態の conhost ウィンドウを作成してしまいます。回避策として、ウォッチャーを無効にしてください:
codegraph serve --mcp --no-watchその後、必要に応じてインデックスを手動で更新してください:
codegraph sync恒久的な修正は、ウォッチャー/git の spawn 呼び出しが Node.js の spawn/exec に windowsHide: true を渡すようにすることです。その修正を含むリリースが利用可能な場合は、アップグレードしてください。
トラブル対応なぜ codegraph は Delphi/Object Pascal でチェーンされたメソッド呼び出しの呼び出し元と呼び出し先を見逃すのですか？
これは codegraph 1.6.2 の既知のバグです。Delphi extractor は MD5FileSized(TMeta.ExtendedPath(APath)).IsSame(AKey) のようなチェーン呼び出しにおいて外側のメソッドのみを記録し、レシーバー呼び出し（MD5FileSized）とその引数内の呼び出し（ExtendedPath）を取りこぼします。PR #2787（main にマージ済み）で修正されており、式形式と括弧なし文形式の両方についてレシーバー呼び出しとその引数の呼び出しをインデックス化し、さらに TButton(Sender).Caption のような型キャストされたレシーバーにも対応しています。1.6.2 以降のリリースにアップグレードしてください。一時的な回避策として、lib/dist/extraction/tree-sitter.js にパッチを適用してください。extractPascalCall では、レシーバー名の処理（約7317行目）の後に this.extractPascalCall(innerCall); を追加し、extractPascalParenlessCall では、非クラスレシーバー分岐（約7411行目）に if (receiver.type === 'exprCall') this.extractPascalCall(receiver); を追加してください。