40,000トークンを消費する5単語のラベル
Claude Codeは30秒ごとにアクティブなbackground agentsをポーリングし、エージェントパネル用に作業内容を数単語で要約するよう言語モデルに要求します。ユーザーの可視性を高めるために設計されたこの一見無害な機能が、ユーザーのトークン許容量の大部分を密かに消費している可能性があります。
Claude CodeのトレースデータをエクスポートしたBetter StackのOpenTelemetryテストにより、この消費の実態が明らかになりました。要約リクエストは約30秒ごとに発生し、そのたびにエージェントの会話履歴全体が送信されていました。このコンテキストの肥大化により、リクエストは「7回目の20秒スリープを実行中」といったわずか130トークンの出力を生成するために、約40,000入力トークンを消費することが多々ありました。
これらのquery_source = "agent_summary"とタグ付けされた要約は、複数のsleep 20タスクを実行するように設計された合成セッションにおいて、総コストの12%を占めていました。より現実的なシナリオである3つのバックグラウンドエージェントを使用したTanStackサイトの構築においても、要約のオーバーヘッドはセッションの総トークン使用量の約8%を消費しました。これは、システムがこれらの要約にClaude Claude Haikuのような安価な代替モデルではなく、プライマリのエージェントモデル（多くの場合Claude Claude Opus）を使用するようにデフォルト設定されているために発生します。
小さなステータス更新がなぜ高コスト化し続けるのか
Claude Codeは、アクティブなバックグラウンドエージェントごとに、直近の変更だけでなく会話履歴全体を繰り返しモデルに送信します。これにより、ポーリングサイクルごとにコンテキストと入力トークン量が増大し、あるテストでは18メッセージから42メッセージへと増加しました。各要約呼び出しは、「7回目の20秒スリープを実行中」といったわずか130トークンの出力を生成するために、約40,000入力トークンを消費しました。
重大な懸念はモデルの選択です。動画のテストでは、これらの要約呼び出しが、より小型で経済的なモデル（Claude Claude Haikuなど）ではなく、高価なClaude Claude Opusを含むエージェントに割り当てられたモデルで実行されていることが判明しました。これが日常的なUI更新のコストを増幅させています。
このトークン消費に関するコミュニティの測定値は、エージェントの数やアクティビティによって異なり、ばらつきがあります。Better Stackのテストでは、agent_summaryが合成スリープセッションの12%、現実的なTanStackビルドの8%を占めることが判明しました。他のコミュニティのベンチマークでは、負荷の高いマルチエージェントワークフローにおいて8%から26%の範囲でした。
Anthropicはより低い平均値を挙げており、あるエンジニアはグローバルテレメトリ全体でAPIコストの2%、ターミナルでは6%であると指摘しています。プロンプトキャッシングによりAPI価格が約10分の1に削減される可能性がありますが、Anthropicはサブスクリプションの使用量は実際のコスト削減に関する完全な透明性がないままクォータから消費されると述べています。
通常のログには表示されない使用量
隠れたagent_summaryのコストを観測するには、標準的なログ記録を超えて調査する必要があります。cc-usageのようなツールでコスト分析によく使用されるClaude Codeのローカルの.jsonlトランスクリプトには、これらの要約リクエストは記録されません。その結果、トランスクリプトに基づいた使用量の計算では、実際のトークン消費量を大幅に過小評価する可能性があります。
agent_summaryのアクティビティを確認するには、Claude Code内でOpenTelemetryエクスポートを有効にしてください。これらのトレースをBetter Stackなどのオブザーバビリティプラットフォームにエクスポートします。そこで、リクエストをquery_source = agent_summaryでフィルタリングおよびグループ化することで、その頻度とトークン量を明らかにできます。この手法により、この特定のオーバーヘッドに関する粒度の高い測定可能な証拠が得られます。
Better Stackのテストによると、agent_summaryは合成スリープテストで全セッション消費量の12%、現実的なTanStackビルドでは8%を占めることが明らかになりました。Flamerix AIによるコミュニティの調査では、高頻度のマルチエージェント実行において、これらの要約が全消費量の最大16.4%、APIリクエストの19.7%を占めることが報告されています。Claude Codeのより広範な有用性については、Claude Code: Best practices for agentic coding - Anthropicを参照してください。
Anthropicのテレメトリによると、APIリスト価格ベースで世界平均2%、ターミナル内では6%という数値が示されています。これらの数値は特定のワークフローにおいて有意なオーバーヘッドがあることを示していますが、正確な割合はエージェントのアクティビティ、タスクの期間、同時実行プロセスによって大きく異なります。個々の使用パターンがトークン消費量に大きく影響するため、これらの測定された影響と一般的な主張を区別することが重要です。
この記事が気に入ったら、毎朝同じようなものをメールで受け取れます。
1日1通 · 2クリックで解除 · サードパーティのトラッキングなし
ワークフローを中断せずに消費を削減する
Claude Codeのトークン消費を抑えるために、エージェント主導のワークフローを犠牲にする必要はありません。効果的な回避策の一つは、fork_subagentsオプションを0に設定することです。これにより、完全な会話履歴を継承するサブエージェントが無効化され、要約呼び出しが停止されます。その一方で、通常のバックグラウンドエージェントはより少ないコンテキスト継承で動作し続けることができます。テストにより、これでagent_summaryのコストが排除されることが確認されています。
もう一つの解決策は、より高度ですが、Bun preload scriptを使用してsetTimeoutをフックし、要約タイマーをブロックする方法です。このアプローチはClaude Codeのプロセスを修正するため、コードを十分に精査してください。出所不明なcurlインストールを無防備に実行することは避け、セキュリティリスクを軽減するために、レビュー済みのローカルコピーを固定して使用してください。
将来的な消費を最小限に抑えるには、エージェントを多用するセッションを積極的に監視してください。不必要なサブエージェントの乱立を避け、リアルタイムのステータスラベルの利便性と、それらが累積する使用コストを慎重に比較検討してください。Anthropicの報告によると、プロンプトキャッシングの改善や、より安価な要約オプションの開発が進められていますが、根本的な解決策が保証されているわけではありません。
よくある質問
Claude Codeのエージェント要約とは何ですか？
バックグラウンドエージェントが何をしているかを示す短い説明文で、エージェントパネルに表示され、モデルによって定期的に生成されます。
エージェント要約はどれくらいの使用量を消費しますか？
報告される割合はワークロードによって異なります。Better Stackは合成テストで12%、マルチエージェントビルドで約8%と測定しましたが、Anthropicはテレメトリ全体でより低い平均値を挙げています。
Claude Codeのエージェント要約をオフにできますか？
ソースで説明されているような直接的な専用トグルはありません。fork subagentsをゼロに設定することでこれらの要約を停止できますが、フォークされたエージェントがコンテキストを継承する方法が変わります。
なぜ使用量ツールでこれらの呼び出しが見逃されることがあるのですか？
エージェント要約のリクエストは、Claude Codeの標準的なJSONLトランスクリプトには表示されない場合があります。OpenTelemetryデータを使用すると、agent_summaryクエリソースの下でそれらを確認できる可能性があります。
要約呼び出しは常にフル価格のトークンで請求されますか？
必ずしもそうではありません。プロンプトキャッシングによってAPIコストを削減できる可能性がありますが、サブスクリプションの使用量計算は不透明な部分があるため、正確な影響はプランとワークロードに依存します。