Claude Codeトークン監査により、デフォルトツール読み込みから生じる隠れたコストが明らかになりました

トークン浪費調査で重大なオーバーヘッドを発見

ある開発者が、Anthropicのレート制限変更後にトークン消費が急速に増加することに気づき、926のClaude Codeセッションを監査しました。調査の結果、すべてのClaude Codeセッションはユーザー入力前に約45,000トークンの基本ペイロードから始まることが明らかになりました。これには、システムプロンプト、ツール定義、エージェントの説明、メモリファイル、スキルの説明、MCPスキーマが含まれます。

標準の200kコンテキストウィンドウでは、この45kの開始ロードは、会話が始まる前に利用可能なコンテキストの20%以上を消費していることを意味します。Claude Codeはステートレスループとして動作するため、このコンテキスト全体がすべてのターンで再構築され再送信されるため、開始オーバーヘッドは繰り返し発生するコストとなります。

デフォルトのツールロードが大量のトークンを消費

監査により、開始コンテキストの20,000トークンがシステムツールのスキーマ定義によるものであることが判明しました。デフォルトでは、Claude Codeはセッション開始時に、使用されるかどうかに関わらず、利用可能なすべてのツールの完全なJSONスキーマをコンテキストにロードします。

開発者は、enable_tool_searchという遅延ツールロードを有効にする設定を発見しました。有効にすると、この設定は最初に6つの主要ツールのみをロードし、残りは必要に応じて遅延ロードするため、すべてのツールスキーマを事前にダンプすることを防ぎます。

設定変更で即座に節約を実現

遅延ツールロードを有効にするには、settings.jsonに以下を追加します：

{
  "env": {
    "ENABLE_TOOL_SEARCH": "true"
  }
}

この単一の設定変更により、開始コンテキストが45,000から20,000トークンに削減され、システムツールのオーバーヘッドが20,000から6,000トークンに減少しました。これにより、すべてのセッションのすべてのターンで14,000トークンを節約できます。

デフォルト設定のコストへの影響

開発者は、この設定が使用状況に与える影響を計算しました。セッションの平均ターン数が22回の場合、ターンあたり14,000の余分なトークンは、セッションごとに308,000の不要なトークンに相当します。858セッション全体では、合計2億6,400万トークンに達しました。

キャッシュ読み取り価格（$0.50/MTok）では、これは$132の不要なコストを表しています。しかし、ターンの半分以上が期限切れのキャッシュにヒットしていたため（これにより$5/MTokの完全入力価格が発生）、実際のコストはこの単一のデフォルト設定により$132から$1,300の間と推定されました。

追加の最適化戦略

開発者は、開始コンテキストを4,000〜5,000トークン削減する他の最適化も実施しました：

• CLAUDEマークダウンおよびメモリファイルのトリミングと再構築
• スキル説明の統合
• 未使用のMCPサーバーの無効化
• メモリフックからのスキーマ注入の厳格化

Claude Codeは会話を~/.claude/projects/の下のJSONLファイルとしてローカルに保存しますが、セッションごとの詳細な内訳、プロジェクトごとのコスト、または費用カテゴリを取得する組み込みの方法はありません。組み込みの/insightsコマンドは、浪費を診断するには不十分であることが判明しました。