AIエージェントのトークン最適化｜コスト削減とコンテキスト管理の5アプローチ2026

Claude CodeやCursor、AIエージェントを本格導入すると、必ず直面する壁がある。トークンコストの増大だ。

大規模コードベースへのクエリ、長いツールチェーン、セッションをまたぐコンテキスト——これらが積み重なると、月間のAPIコストが数万円規模に達する。「AIを使えば使うほど請求額が増える」という逆説的な状況に陥ることも少なくない。

しかし、この問題には体系的な解法がある。2026年現在、OSSエコシステムには5種類の異なるアプローチで問題を解決するツールが揃った。コマンド出力を圧縮するRTK、コードをナレッジグラフ化するGraphify、長期記憶を構造化するMemPalace、フックでコンテキストを継承するOpenWolf、そしてコンテキストDBで効率化するOpenVikingだ。

本記事では、これら5つのアプローチを分類・比較し、プロジェクト規模と用途に合わせた選定指針を示す。

AIエージェントのトークンコスト問題を解剖する

トークンとは何か

LLMはすべてのテキストを「トークン」単位で処理する。英語では1トークン≒4文字、日本語では1文字≒1〜2トークン。APIの料金は入力トークン数（プロンプト＋コンテキスト）と出力トークン数の合計で決まる。

Claude Sonnet 4.6の場合、入力$3/Mトークン、出力$15/Mトークン（公式料金。変更される可能性あり）。一見安く見えるが、AIエージェントがコードを読み込んでツールを呼び出すと、1回のタスクで数万〜数十万トークンを消費することも珍しくない。

なぜトークン消費が増えるのか

AIエージェントのトークン消費が多い理由は3つある。

1. コマンド出力の冗長性 git statusやls -laの出力には、LLMが本当に必要とする情報以外のものが大量に含まれる。パーミッション情報、タイムスタンプ、無関係なファイルパス——これらをそのままLLMに渡すとトークンが増える。

2. コードベース全体の読み込み 「このバグを直して」と指示すると、AIエージェントは関連ファイルを次々と読み込む。10万行のコードベースでは、数十万トークンの読み込みが当たり前になる。

3. セッション間のコンテキスト再構築 会話セッションが終了するたびに、次のセッションでは最初からコンテキストを再構築する。「このリポジトリは○○をする」「前回試みた修正」——これらを毎回説明するコストが積み重なる。

この3つの問題に対して、5つのOSSツールがそれぞれ異なる切り口でアプローチする。

5つの最適化アプローチ：どこで削るか

トークン最適化には「どのフェーズで」「どのデータを」削るかによって、アプローチが根本的に異なる。

アプローチ1: コマンド出力を圧縮する——RTK

RTKとは

RTK（Rust Token Killer）は、Claude CodeのBashツール経由で実行されるコマンドの出力をリアルタイムにフィルタリング・圧縮するCLIプロキシだ。Rust製の単一バイナリで、依存関係ゼロ、オーバーヘッド10ms未満。

Claude Codeのフック機構（PreToolUse）に1行設定するだけで動作し、既存のワークフローを変えることなくコマンド出力を最適化する。

# Homebrewでインストール（macOS/Linux）
brew install rtk

# Claude Code用グローバルフック設定
rtk init -g

# Claude Codeを再起動すれば即座に動作開始
# 削減効果を確認
rtk gain

RTKの仕組み

RTKはgit status、ls、grepなどのコマンド出力を受け取り、LLMが必要とする情報だけを残す。具体的には次の変換を行う。

• 不要な行の除去: パーミッション文字列、タイムスタンプ、区切り線
• 冗長ヘッダーの削除: コマンドの繰り返し説明、使用方法の表示
• 長い出力の要約: 1000行のログを100行に要約
• エラー出力の構造化: スタックトレースから本質的なエラーだけ抽出

# 例: git log の出力をRTKが最適化する前後
# 最適化前（LLMに渡される）
commit a1b2c3d4e5f6 (HEAD -> main, origin/main)
Author: John Doe <[email protected]>
Date:   Wed Apr 23 10:00:00 2026 +0900
    feat: add authentication module

# 最適化後（LLMに渡される）
a1b2c3d HEAD main 2026-04-23 feat: add authentication module

対応コマンドと削減率

RTKは100以上のコマンドカテゴリに対応する。

公式ドキュメントによると、実測で60〜90%の出力圧縮を達成。rtk gainコマンドで自分のプロジェクトでの削減効果をリアルタイムに確認できる。

# 削減効果の確認
rtk gain

# 出力例
Total tokens saved: 2,847,234
Sessions tracked: 89
Average reduction: 73.2%
Most effective: cargo test (91.4%), git log (85.1%)

RTKが効くケース

• CLIツールを多用するプロジェクト: git操作、ビルドコマンド、テスト実行が多い
• ログやテスト出力が長い: 大規模テストスイートやデプロイログの解析
• 複数のAIツールを使う: Claude Code, Cursor, Gemini CLIなど複数ツールで共有できる
• シンプルに始めたい: フック1行で即導入、設定不要

アプローチ2: コードをナレッジグラフにする——Graphify

Graphifyとは

Graphifyは、コードベース全体——ソースコード・ドキュメント・PDF・画像まで——をナレッジグラフに変換するOSSだ。2026年4月の公開からGitHub 10,000+ starsに急成長した。

RTKが「コマンド出力の圧縮」に特化するのに対し、Graphifyは「コードベースへのクエリ効率化」に特化する。ソースファイルを直接読む代わりにグラフ構造から必要なサブグラフだけを参照することで、クエリあたり71.5倍のトークン削減を実現する。

# インストール（Claude Code スキルとして）
claude skills install graphify

# コードベースをグラフ化
/graphify build ./src

# グラフからクエリ
/graphify query "認証モジュールの依存関係を教えて"

3パスパイプライン

Graphifyは3段階のパイプラインでナレッジグラフを構築する。

Pass 1: 構造解析（AST） Tree-sitterを使って20言語のソースコードを構文解析。関数・クラス・モジュール・インポートをノードとしてグラフに追加。

Pass 2: セマンティック解析（LLM） コメント・ドキュメント・自然言語的なコードの意味をLLMで解析し、概念的なエッジを追加。「このクラスは認証を担当する」という関係が付与される。

Pass 3: マルチモーダル解析 PDF・Markdown・画像（ホワイトボード写真含む）をドキュメントノードとしてグラフに追加。ソースコードとドキュメントが統合されたグラフが完成する。

71.5倍削減の数学

なぜ71.5倍なのか。ファイル全体を読む場合と、グラフのサブセットを参照する場合の差だ。

たとえば100個のファイルがある場合:

• ファイル直接参照: 1ファイル平均500行 × 100 = 50,000行 = 約300,000トークン
• Graphifyサブグラフ参照: クエリに関連するノード50個 × 平均84トークン = 約4,200トークン

300,000 ÷ 4,200 ≈ 71.4倍の差になる。

# Python APIでGraphifyを使う例
from graphify import GraphifyClient

client = GraphifyClient(repo_path="./src")

# グラフのクエリ（71.5倍効率）
result = client.query(
    "Find all functions that depend on AuthService",
    max_tokens=1000  # 必要なトークン数を制限
)

# 結果: 関連するサブグラフのみが返る
# ファイル全体を読む必要なし

Graphifyが効くケース

• 大規模コードベース（10万行〜）: ファイル数が多いほど効果大
• 複雑な依存関係: マイクロサービス・モノレポ・多言語プロジェクト
• コードレビューの自動化: 変更が与える影響範囲の把握
• ドキュメントとコードを統合したい: READMEやAPIドキュメントと実装をグラフでつなぐ

アプローチ3: 長期記憶を構造化する——MemPalace

MemPalaceとは

MemPalaceは、AIエージェントの長期記憶を管理するオープンソースのメモリシステムだ。2026年4月の公開からGitHub 35,000+ starsに急成長し、LongMemEvalベンチマークで96.6%（ローカル無料ツール最高）を記録した。

RTK・Graphifyがコードへのアクセス効率化に特化するのに対し、MemPalaceはAIが「何を覚えているか」の効率化に特化する。会話履歴・ユーザーの好み・過去のエラーパターンを構造化して保存し、次のセッションで必要な記憶だけを最小トークンで呼び出す。

5層の「宮殿」アーキテクチャ

MemPalaceの設計は、古典的な記憶術「Method of Loci（場所法）」をAIに適用したものだ。

Wings（翼）
  └── Halls（廊下）
        └── Rooms（部屋）
              └── Closets（収納）
                    └── Tunnels（通路）

• Wings: 大カテゴリ（プロジェクト・ユーザー・セッション等）
• Halls: サブカテゴリ（機能・モジュール・日付等）
• Rooms: 個別の記憶ユニット（コンテキスト単位）
• Closets: 詳細情報（具体的なデータ・コード断片）
• Tunnels: 記憶間のつながり（関連情報へのポインタ）

この5層構造により、MemPalaceは170トークンのウェイクアップコンテキストから全記憶を検索できる。通常のベクトルDB検索と比べ、想起に必要なトークンが大幅に少ない。

170トークンのウェイクアップ

従来のメモリシステムは、記憶を呼び出すために記憶一覧全体をコンテキストに入れるか、複雑なクエリを実行する必要があった。MemPalaceは宮殿構造のインデックスだけを「ウェイクアップコンテキスト」として保持し、必要な記憶が格納された部屋だけに移動する。

# MemPalaceのセットアップ
pip install mempalace

# MCP経由でClaude Codeに統合
mempalace setup --mcp

# 記憶を保存（LLMのツール呼び出しで自動）
mempalace store --wing "project-x" --hall "auth" \
  "AuthServiceはJWT認証を担当。RSA256を使用している"

# 記憶を検索（170トークンのウェイクアップ）
mempalace recall "認証の実装詳細"
# → wing="project-x", hall="auth" の記憶だけを返す

LongMemEvalベンチマークの意味

LongMemEvalは、AIメモリシステムが長い会話履歴から正確に情報を想起できるかを測るベンチマークだ。

MemPalaceのスコアは、ローカル実行の無料ツールとして公開されている中で最高水準だ。

MemPalaceが効くケース

• 長期プロジェクト: 数週間〜数ヶ月にわたるAIとの協業
• 複数ユーザーの設定管理: ユーザーごとの好みや作業スタイルを記憶
• 会話履歴が長いチャットエージェント: カスタマーサポート・コーチングAI
• エラーパターンの学習: 過去に踏んだバグや失敗パターンを記憶して再発防止

アプローチ4: フックでコンテキストを継承する——OpenWolf

OpenWolfとは

OpenWolfは、Claude Codeのフック機構に6本のNode.jsスクリプトを挿入するnpmパッケージだ。ファイルインデックス・学習メモリ・バグログ・トークン台帳を.wolf/ディレクトリで管理し、セッションをまたいだコンテキスト継承を実現する。

公式READMEによると、20プロジェクト・132セッション以上の実測で平均65.8%のトークン削減、大規模プロジェクトでは最大80%削減を報告している。

# グローバルインストール
npm install -g openwolf

# プロジェクト初期化（2コマンドで完了）
openwolf init

# .wolf/ ディレクトリが作成される
# settings.json にフック設定が自動追加される

7つのコンポーネント

OpenWolfは.wolf/ディレクトリに7つのファイルを管理する。

フック動作の仕組み

OpenWolfが挿入する6本のフックは、Claude Codeのライフサイクルの各フェーズで動作する。

セッション開始
  ↓ anatomy.md をコンテキストに注入（ファイル探索不要）
  ↓ cerebrum.md の知見をコンテキストに注入（再学習不要）

ツール呼び出し前（PreToolUse）
  ↓ 重複ファイル読み込みを検知
  ↓ anatomy.mdに記録済みなら読み込みをスキップ

ツール呼び出し後（PostToolUse）
  ↓ 変更されたファイルをanatomyに更新
  ↓ 発見した知見をcerebrum.mdに追記

セッション終了
  ↓ token-ledger.jsonに消費量を記録
  ↓ memory.mdにセッションサマリーを追記

OpenWolfが効くケース

• Claude Codeのヘビーユーザー: 毎日長時間使う開発者
• 大規模プロジェクト: ファイル数が多く、Claudeが同じファイルを繰り返し読む
• チーム開発: .wolf/をGit管理してチームで共有（新メンバーのオンボード短縮）
• 長期メンテナンス: 同じコードベースを数週間以上継続して改修

アプローチ5: AIエージェント向けコンテキストDB——OpenViking

OpenVikingとは

OpenVikingは、ByteDance/Volcengineが開発したAIエージェント向けのオープンソースコンテキストデータベースだ。GitHub 22,800+ starsを獲得し、AIエージェント開発の現場で急速に採用が進んでいる。

他の4ツールがClaude Codeのような既製AIツールの最適化に特化するのに対し、OpenVikingはAIエージェントをゼロから構築する開発者向けのインフラレイヤーだ。ファイルシステムのパラダイムでコンテキストを管理し、L0/L1/L2の3段階ロードで必要な情報だけを効率的に取得する。

ファイルシステムパラダイム

OpenVikingの最大の特徴は、コンテキスト管理を「ファイルシステム」として抽象化する発想だ。

# OpenVikingのコンテキスト操作
from openviking import ContextDB

db = ContextDB("./my-agent-context")

# ファイルシステムのように書き込み
db.write("/project/src/auth.py", content=source_code)
db.write("/project/docs/api.md", content=api_docs)
db.write("/session/current/task.md", content=current_task)

# ディレクトリ再帰検索（ファイルシステムのfind相当）
results = db.find("/project/src/", pattern="*.py", 
                  semantic_query="認証に関連するファイル")

# L0/L1/L2の階層ロード
context = db.load(path="/project/", level="L1")

L0/L1/L2の3段階ロード

OpenVikingは3段階のロード戦略でコンテキストの効率を最大化する。

AIエージェントはまずL0でコンテキスト全体を把握し、次にL1で関連ファイルを絞り込み、最後にL2で必要なファイルだけを読み込む。不要なL2アクセスを省くことでトークン消費を大幅に削減できる。

ディレクトリ再帰検索

OpenVikingのディレクトリ再帰検索は、セマンティック検索とパスフィルタリングを組み合わせた独自の機能だ。

# パスフィルタ + セマンティック検索の組み合わせ
results = db.find(
    path="/project/",        # 検索対象パス
    depth=3,                  # 再帰深さ
    pattern="*.{py,ts}",      # ファイルパターン
    semantic_query="JWTトークン検証の実装",  # 意味検索
    load_level="L1",          # L1で返す
    max_results=10            # 上位10件
)

for file in results:
    print(f"{file.path}: {file.summary}")
    # L2は必要なファイルだけ個別にロード
    if "jwt" in file.summary.lower():
        full = db.load(file.path, level="L2")

OpenVikingが効くケース

• AIエージェントをゼロから開発: コンテキスト管理をライブラリに任せたい
• マルチエージェントシステム: 複数のエージェントが共有するコンテキストストア
• 大規模ドキュメント管理: 数百〜数千ファイルの設計書・仕様書をエージェントに与える
• エンタープライズ導入: アクセス制御・バージョン管理・監査ログが必要

5ツール比較表：機能・効果・導入コスト

ユースケース別選定ガイド

どのツールを選ぶかは、プロジェクトの性質と「何が一番のボトルネックか」によって決まる。

ソロ開発者・個人プロジェクト

推奨: RTK → OpenWolf の順に導入

まずRTKで5分のセットアップ。コマンド出力の圧縮だけで多くのケースで30〜70%の削減が見込める。効果を確認してからOpenWolfを追加し、セッション間のコンテキスト継承も加える。

中規模チーム（5〜20名）

推奨: OpenWolf（Git管理） + Graphify

OpenWolfの.wolf/をリポジトリに含めてチームで共有。全員が同じファイルマップと学習メモリを使えるため、新メンバーのオンボードも速い。コードベースが5万行を超えたらGraphifyを追加してナレッジグラフ化する。

大規模モノレポ（50万行〜）

推奨: Graphify + RTK + MemPalace

Graphifyでコードベースをグラフ化し、RTKでコマンド出力を圧縮、MemPalaceで長期記憶を管理。3ツールの組み合わせで、通常のClaude Code利用と比較して70〜80%のトークン削減が期待できる。

AIエージェント開発者

推奨: OpenViking + MemPalace

エージェントの設計フェーズからOpenVikingをコンテキストDBとして採用し、MemPalaceで長期記憶を管理。L0/L1/L2の段階的ロードとMemPalaceの170トークンウェイクアップを組み合わせることで、エージェントのコンテキスト効率を最大化できる。

実際のコスト試算：削減効果をシミュレーション

具体的な数字で削減効果を確認しよう。以下はClaude Sonnet 4.6（入力$3/Mトークン）を前提とした試算だ。

シナリオ1: ソロ開発者（Claude Code、1日3時間）

RTK単体で月$63（Sonnet）〜$315（Opus）の節約。Opus利用者にとってはROIが特に大きい。

シナリオ2: 5名チーム（Claude Code API経由）

チームで使うと節約額は月$382.5（Sonnet基準）。年間$4,590の削減は、Graphifyの導入時間（チーム全体で10時間）を考えてもペイする。

シナリオ3: 大規模コードベース（50万行モノレポ）

大規模コードベースでAIがコードを読み込む際のトークン消費は特に大きい。Graphifyの効果が最大化するシナリオだ。

モノレポ全体を直接参照する場合:
  500,000行 × 平均6トークン/行 = 3,000,000トークン/クエリ
  × 10クエリ/日 × 20日 = 600M トークン/月
  → $1,800/月（Sonnet）

Graphifyのナレッジグラフ経由:
  1クエリ ÷ 71.5 ≈ 42,000トークン/クエリ
  × 10クエリ/日 × 20日 = 8.4M トークン/月
  → $25.2/月（Sonnet）

削減額: $1,774.8/月（97%削減）

モノレポ規模になると、Graphifyだけで月額コストが2桁変わることもある。

Claude Sonnet vs Opus の選択

Opusを使っているチームほど、トークン最適化ツールへの投資対効果が高い。RTK導入（5分）でOpusの月額コストを70%削減できるなら、ROIは圧倒的だ。

複合活用パターン：最大効果を得る組み合わせ

パターン1: スモールスタート（RTK + OpenWolf）

# Step 1: RTK導入（5分）
brew install rtk
rtk init -g

# Step 2: OpenWolf導入（10分）
npm install -g openwolf
openwolf init

# 合計: 15分の設定で60〜80%削減

最も手軽に始められる組み合わせ。RTKがコマンド出力を圧縮し、OpenWolfがセッション間のコンテキストを継承する。Claude Codeユーザーのデフォルト推奨構成だ。

パターン2: コードベース特化（Graphify + RTK）

# Step 1: Graphifyでコードベースをグラフ化
claude skills install graphify
/graphify build ./src ./docs

# Step 2: RTKで残りのコマンド出力を圧縮
brew install rtk && rtk init -g

# 大規模コードベースで70〜90%の総合削減

10万行を超えるコードベースでの推奨構成。Graphifyがコード参照を効率化し、RTKがそれ以外のコマンド出力を圧縮する。

パターン3: エンタープライズ（OpenViking + MemPalace + Graphify）

AIエージェントをゼロから開発するチーム向けの総合構成。

# エンタープライズ統合の例
from openviking import ContextDB
from mempalace import MemoryPalace
from graphify import GraphifyClient

# コンテキストDB（OpenViking）
ctx_db = ContextDB("./context")
ctx_db.write("/codebase/", source=GraphifyClient("./src"))

# 長期記憶（MemPalace）
memory = MemoryPalace()
memory.store("/project/patterns", 
             "認証はJWT+RSA256。リフレッシュトークンは7日間")

# エージェントがL0でコンテキスト全体を把握
overview = ctx_db.load("/", level="L0")

# 関連ファイルをL1で絞り込み
relevant = ctx_db.find("/codebase/", 
                        semantic_query="認証フロー",
                        level="L1")

# 必要なファイルだけL2でフル読み込み
for f in relevant[:3]:
    detail = ctx_db.load(f.path, level="L2")

この構成により、エージェントが必要とするコンテキストを最小トークンで提供できる。L0/L1でフィルタリングし、L2は本当に必要なファイルだけ。MemPalaceの記憶と組み合わせることで、セッションをまたいだ知識の蓄積も可能になる。

トークン最適化の今後：2026年の展望

コンテキストウィンドウは年々拡大している（Claude 3では100K、現在のモデルでは200K〜1M+）。しかしコンテキストが大きくなるほど、注意機構の品質が下がる問題がある。長いコンテキストでは、LLMが中間の情報を見落とすことが多い（「失われた中間」問題）。

つまりコンテキストウィンドウが広がっても、「必要な情報を最小限に絞って渡す」という原則は変わらない。むしろコンテキストが大きくなるほど、何を入れるかの選択が重要になる。

トークン最適化ツールは、単なるコスト削減ツールではなく「AIが正確に情報を処理するための精度向上ツール」として今後も価値を持ち続ける。

• RTKの方向性: 対応コマンドの拡充、より精密なフィルタリング規則
• Graphifyの方向性: リアルタイムグラフ更新、差分のみの再構築
• MemPalaceの方向性: 記憶の自動忘却・重要度スコアリング
• OpenWolfの方向性: より高度な重複検出、チーム共有の強化
• OpenVikingの方向性: 分散コンテキストDB、アクセス制御の強化

まとめ：5ツールの役割を整理する

AIエージェントのトークン最適化は、「一つのツールで解決する」問題ではない。コマンド出力・コードベース・長期記憶・セッション継承・エージェントコンテキストという5つの課題に対して、それぞれ専門のツールが存在する。

手軽に始めたいならRTK + OpenWolfの組み合わせが5分〜15分で導入でき、コマンド出力とセッション継承の両方をカバーする。大規模コードベースを扱うならGraphifyの追加が不可欠だ。長期プロジェクトや会話履歴の管理が必要ならMemPalace、エージェントをゼロから開発するならOpenVikingが基盤になる。

コスト削減だけでなく、「AIが正確に情報を処理するための精度向上」という観点からも、これらのツールへの投資は開発効率の改善につながる。まずRTKを導入して削減効果を計測し、ボトルネックを特定してから次のツールを選ぶ——このアプローチが最も効果的だ。

参照ソース

• RTK（Rust Token Killer）公式リポジトリ
• Graphify公式リポジトリ
• MemPalace公式リポジトリ
• OpenWolf公式リポジトリ
• OpenViking（volcengine/openviking）公式リポジトリ
• Anthropic API料金（公式）
• Claude Code フック公式ドキュメント