Claude Code の agent_summary は本当に token の15〜20%を消費するのか？主張、検証済みの範囲、自分の数字の測り方

10月28日、Flamerix AI は GitHub の gist で、Claude Code が背景エージェントの3〜5語の状態ラベルを作るために token の約15〜20%を使っていると主張し、この話は急速に広まった。ここでは、裏付けのあること、特定の条件でしか成り立たないこと、証拠のないことを分け、自分の数字を測る方法を示す。

agent_summary とは

gist の説明では、agent_summary はタイマーで動く付随的なリクエストで、動作中の背景エージェントごとにその会話記録をそのエージェント自身のモデルに送り、最新の動作を3〜5語で説明させる。結果はエージェントのパネルの状態表示にだけ使われ、主な会話には入らない。gist によれば、バージョン 2.1.232（2026年8月）から既定で有効だ。8月15日にはすでに、ユーザーが GitHub の issue #86879 で、agent_summary のスピナーを無効にするサポートされた方法を求めている。

各自が測った数字

Flamerix は自分の環境で1週間、推定コストの16.4%、リクエスト数の19.7%を測り、自作の hook を入れると0%になったという。issue では、4時間、27のサブエージェント、1,496リクエストのセッションで、生の token の22.2%、Opus の定価で重み付けすると18.0%、リクエスト数の22.7%だった。ほかの投稿者はサブエージェントを多用するセッションで重み付けして15〜22%と報告し、gist は18〜26%の4件の測定を挙げている。反対に、Hacker News のあるテスターは自分のセッションでは多くても約8%だと述べた。これらはすべてユーザー自身の測定で、Anthropic のデータはない。

成り立つことと成り立たないこと

複数の方面から裏付けられているのは、背景エージェントがこの種の定期的な要約リクエストを実際に出していることだ。部分的に裏付けられているのは、多数のサブエージェントを使う重い利用ではオーバーヘッドが大きいことだ。成り立たないのは、15〜20%を全員の token の割合とみなすことで、主エージェントが1つだけの通常のセッションではずっと低いはずだ。Anthropic の反応は見つからず、公式のオフスイッチが追加されるかを確認した人もいない。

止め方と、そのまま真似しない理由

公式の設定や環境変数は見つかっていない。gist が示すのは非公式の方法で、BUN_OPTIONS=--preload でスクリプトを読み込み、タイマーを包んでソースの特徴に一致したときに要約のタイマーを抑える。Linux でバージョン 2.1.257〜2.1.312 でしか試されておらず、更新でコードが変わると静かに効かなくなり、あなたの権限で動く。ある投稿者は、環境変数が 2.1.241 では効いたが 2.1.245 では効かなかったと述べ、別の投稿者は 2.1.300 に挙動不明の未公開の名前があると述べたが、どちらも確認されていない。disableAgentView 設定でこれらのリクエストが止まるかを尋ねた人がいたが、測定結果を報告した人はいない。

自分の数字を測る

OpenTelemetry のイベントをエクスポートし、claude_code.api_request を query_source でグループ化して、agent_summary と主な会話の token とリクエスト数を比べる。どんなパーセンテージを信じるよりも確実だ。

あなたのお金にとって何を意味するか

まず自分が影響を受けるタイプのユーザーかを判断する。オーバーヘッドが目立ちそうなのは、多数の背景サブエージェントを日常的に動かすチームで、単一セッションの個人利用ならほとんど気にしなくてよい。上の方法で1週間測り、許容できない割合なら、非公式スクリプトのリスクをとるか、同時に動かす背景エージェントの数を減らすかを決める。Anthropic が公式のスイッチを出すまでは、Linux でしか試されていない preload スクリプトを本番環境に入れてはいけない。