Claude Codeで大規模プロジェクトを扱う開発者の多くが直面する共通の問題がある。コードベースの規模が大きくなると、AIに構造を探索させるたびに長い待ち時間が発生し、ファイルスキャンが延々と続き、ツール呼び出しが山積みになり、トークンが大量に消費される。作業はなかなか進まず、コストだけが先に膨らんでしまうのだ。
オープンソースツール「CodeGraph」は、この問題に別のアプローチで挑む。事前にコードベースのセマンティック知識グラフを構築しておくことで、Claude Codeはグラフを直接参照し、ファイルを一つずつスキャンする必要がなくなる。
公式は6つの実際のオープンソースコードベースで比較テストを実施した。TypeScript、Python、Rust、Java、Swift、C++など多言語プロジェクトをカバーし、VS CodeやSwiftコンパイラのような超巨大コードベースも含まれている。その結果、平均でツール呼び出しが92%削減され、探索速度が71%向上した。
個別プロジェクトにおける改善はさらに顕著だ。
- VS Code（4,002個のTypeScriptファイル）：CodeGraphなしでは52回のツール呼び出し、1分37秒かけて原因を特定。使用後はわずか3回の呼び出し、17秒で完了し、82%の高速化を達成。
- Swiftコンパイラ（25,874個のSwift/C++ファイル）：CodeGraphなしでは37回の呼び出し、2分8秒で質問に回答。使用後はわずか6回の呼び出し、35秒で完了し、ファイル読み込みはゼロ。
- クロスランゲージのClaude Codeプロジェクト（Python+Rust）：CodeGraphなしでは40回の呼び出し、1分8秒。使用後は3回の呼び出し、39秒で完了し、言語を跨いだ呼び出しチェーンを直接識別可能。
すべてのテストはClaude Opus 4.6（1Mコンテキスト）と同じクエリを使用しており、結果の再現が可能だ。例えばVS Codeでは「拡張機能ホストとメインプロセスの通信ロジック」、Excalidrawでは「共同編集とリアルタイム同期の実装原理」、Alamofireでは「Session.request()からURLSession層へのリクエストフローパス」といった質問が用いられた。
CodeGraphは関数呼び出しチェーン、クラス継承関係、モジュール参照を自動的に識別し、コード変更前の影響範囲分析も可能にする。これにより、一箇所の修正が全体に波及する問題を未然に防ぐ。
現在、TypeScript、Python、Go、Rust、Java、C++、Swift、Dart、Svelte、Vueなど19の主要開発言語をサポート。同時に、13種類のフロントエンド・バックエンドフレームワークのルーティングルールを認識し、URLパスと対応するハンドラ関数を直接関連付けることが可能だ。
すべてのデータはローカルのSQLiteデータベースに保存され、外部サービスへのアップロードは一切行われない。追加のAPIキーも不要。インストール後はファイル変更を自動監視し、保存時に増分同期でグラフを更新するため、基本的にメンテナンスは不要だ。
インストールと設定はわずか3ステップ。
- インストールコマンドを実行する：
npx @colbymchenry/codegraphインタラクティブなインストーラーが、グローバルインストール、Claude CodeのMCPサービス設定、権限付与などを自動的に完了させる。
- Claude Codeを再起動し、MCPサービスを読み込む。
- 対象プロジェクトのディレクトリに移動し、初期化コマンドを実行する：
codegraph init -i初期化が完了すると、Claude Codeはプロジェクト以下の.codegraphディレクトリを検出し、自動的にCodeGraphのツールを呼び出してコード探索を完了させる。AIに追加の指示を与える必要はない。
あるユーザーから、このツールはClaude Codeのみをサポートしているのかという質問が寄せられた。現在のところ、公式に適応が行われているのはClaude Codeのみであり、他のAIコーディングツールには未対応とのことだ。また、評価データの信頼性を気にするユーザーもいるが、すべてのテスト詳細、テスト環境、クエリ文、結果データはオープンソースリポジトリで公開されており、誰でも再現可能である。
さらに、インデックス作成速度の遅さを指摘するフィードバックに対して、公式は解決策を提示している。SQLiteのWASMバージョンを使用している場合、パフォーマンスはネイティブバージョンより5～10倍低下する可能性がある。該当するOSのCコンパイルツールをインストールし、better-sqlite3を再コンパイルしてネイティブバックエンドに切り替えることで、インデックス速度を大幅に向上できる。
プロジェクトのオープンソースリポジトリはこちら： https://github.com/colbymchenry/codegraph 。Claude Codeで巨大なコードベースを頻繁に扱ったり、リファクタリングを行ったりする開発者に最適だ。時間とトークンの両方を節約できる。