Claude CodeやCursorを使い込んでいると、ある時点で「料金が思ったより高い」と感じる瞬間がくる。
コードベースが大きくなるほど、AIは「状況を理解するため」に大量のトークンを消費する。その多くは実は不要な情報で、真に必要なコンテキストはごく一部だ——このムダを解消するために作られたのがCodeGraphだ。
・CodeGraphが解決する問題とは何か
・59%トークン削減・49%高速化の仕組み
・Claude Code・Cursor・Codexへの導入方法
・月額コスト削減の試算
Claude Codeのトークン代が半分以下になる──CodeGraphとは何か
CodeGraphは、colby mchenry氏がGitHubで公開したオープンソースツールだ。Claude Code・Cursor・Codex・OpenCodeといったAIコーディングエージェントのトークン消費を大幅に削減するMCPサーバーとして動作する。スター数は12,200以上（2026年5月時点）で、GitHub Trendingに急浮上している。
仕組みをひと言で言うと「コードベースのAI向け辞書を事前に作っておく」ものだ。AIがファイルを直接読む代わりに、CodeGraphが生成した「セマンティックな知識グラフ」を参照することで、トークン消費を抑えながら正確なコンテキストを提供する。
なぜAIコーディングはトークンを食いすぎるのか
通常のAIコーディング作業では、「このメソッドを直して」と言われたAIはまず関連ファイルを探すためにディレクトリを探索し、複数のファイルを読み込み、全体の依存関係を把握しようとする。
この探索プロセスで使われるトークンは、実際の「修正作業」に使われるトークンよりずっと多いことが多い。特に大きなコードベースでは、「コンテキスト収集」の段階でコストの大半が消える。
CodeGraphはこの問題に正面から取り組む。
59%トークン削減・49%高速化の仕組み
CodeGraphの公式ベンチマーク（実世界の7プロジェクトで測定）では、以下の結果が示されている。
| 指標 | 改善幅 |
|---|---|
| トークン削減 | 平均59%削減 |
| コスト削減 | 平均35%削減 |
| 処理速度 | 49%高速化 |
| ツール呼び出し回数 | 70%削減 |
特筆すべきは大規模リポジトリへの効果だ。VS Codeのような大規模コードベースでは73%のトークン削減を達成している。逆に小さなリポジトリ（Ginフレームワーク程度）でも23%削減はある。
コード知識グラフとは
CodeGraphが生成する「知識グラフ」は、コードの関数・クラス・変数・ファイル間の関係性を事前に解析してSQLiteデータベースに格納したものだ。AIはファイルを直接読む代わりに、このグラフを参照することで「最小限の情報で最大限の文脈を把握する」ことができる。全文検索にはSQLite FTS5を使っており、インスタント検索が可能だ。
19言語対応のシンボル解析
TypeScript・Python・Rust・Java・Go・Cなど19以上の言語に対応している。自動同期機能により、コードを変更するたびにグラフが更新されるため、常に最新の状態が保たれる。
対応ツール一覧と導入2コマンド
CodeGraphは以下のAIコーディングツールに対応している。
- Claude Code
- Cursor
- Codex CLI
- OpenCode
インストール方法
npx @colbymchenry/codegraph
cd your-project && codegraph init -i
インタラクティブインストーラーが立ち上がり、プロジェクトの言語構成を自動検出して最適な設定を行う。グローバルインストールとプロジェクト単位での設定の両方が可能で、チームへの展開も簡単だ。
初回のグラフ生成は規模によるが、中規模プロジェクト（数十ファイル）なら数分で完了する。
月額コスト試算──Claude APIで何円節約できるか
Claude APIをヘビーに使っている開発者の場合、月額コストへの影響は無視できない。
仮に月額15,000円のAPIコストがかかっているとすると、CodeGraphの平均35%削減が適用されると月5,250円の削減になる。年間で63,000円だ。大規模コードベースで59%削減が実現すれば、年間100,000円以上の節約も見込める。
CodeGraph自体は100%オープンソース・無料で使える。外部APIとの通信もなく、すべてローカルで処理される（SQLiteデータベース）ため、コードのプライバシーを気にする場合にも適している。
料金面の不安から高機能なAIコーディングツールを使い控えていたなら、CodeGraphを入れることで安心して使える環境が整う。コードの品質を下げずにコストだけ下げられるツールは少ない。試してみる価値は十分にある。
コメント