Claude Codeの裏方エージェント、30秒ごとの状況報告でトークン15〜20%を消費
バックグラウンドでコードを動かすエージェントの「ステータス表示」だけのために、なぜトークンが大きく減っていくのでしょうか。Claude Codeを業務で使う管理者にとって、見えないコスト増は放置できない問題です。
この記事の要点
何が起きたか
Claude Codeに搭載されている「エージェントサマリー」機能が、バックグラウンドエージェントのステータスを更新するために約30秒ごとに会話記録トランスクリプト全体をモデルへ再送信していることが明らかになりました。AI用ツールの開発元であるFlamerix AIがOpenTelemetryのエクスポートを分析した結果、この機能がClaude Code全体のトークン支出の約15〜20%を占め、APIリクエストの約5件に1件がこの機能のために送られていると報告しています。
特にOpusモデルを使用した場合は消費の割合が大きくなり、18〜26%に達したといいます。この機能は、約30秒ごとに各バックグラウンドエージェントへ「直近の行動を3〜5語で説明してください」と要求し、得られた回答はパネルのステータス行を更新するためだけに使われ、モデル本体や会話には反映されません。エージェントサマリーは2026年8月のClaude Codeバージョン2.1.232以降デフォルトで有効化されており、設定による無効化はできないとされています。
背景・解説
「バックグラウンドエージェント」とは、ユーザーが別の作業をしている間に裏側でコード編集やタスク実行を進める自動処理の仕組みです。利用者はパネル上の短いステータス表示で進捗を確認できますが、その表示を作るために会話記録全体を毎回モデルへ送り直す必要があるというのが今回の構造です。トランスクリプトには作業履歴や出力結果がすべて含まれるため、やり取りが長くなるほど再送信の負荷は大きくなります。
この問題に対し、Flamerix AIは「no-agent-summary.js」というスクリプトを公開し、特定のタイマー処理だけを検出して止める方法を示しています。Claude Codeの本体を書き換えずに動作し、アップデートで消える仕組みではないとされていますが、今度はアンカーとなる文字列が変更されると機能しなくなるという別の弱点を抱えています。この点について、ITベンチャー・Arrowheadsが運営するClaude Code研究所は、環境変数の仕様上マシン上の他のBun実行環境にも影響が及ぶことなどを理由に、このスクリプトの利用を勧めていません。
仕事や業務への影響
Claude Codeでバックグラウンドエージェントを日常的に使っている会社ほど、見えないコストの見直しが必要です。例えば、エンジニア20人がそれぞれ複数のバックグラウンドエージェントを並行稼働させている情シス部門なら、API利用料のうち15〜20%相当がステータス表示のためだけに費やされている計算になり、月間のAI予算が数十万円単位で膨らむ余地があります。
まず着手すべきは、現状把握です。OpenTelemetryのようなログ基盤を導入し、エージェントサマリーに費やされているリクエスト数とトークン量を自分の環境で確認することが先決になります。数字を見ないまま「なんとなく重い」という印象だけで判断すると、対策の優先順位を誤ります。
対策として紹介されている無効化スクリプトについては、慎重な態度で十分です。Claude Code研究所が非推奨としている以上、セキュリティ担当者の承認なしに現場判断で導入すべきではありません。コスト削減とシステムの安定運用はどちらも大切ですが、順序を間違えると後者を損ないます。当面は「コストが膨らむ構造があることを前提に予算を組む」という現実的な対応が妥当です。
不確かな点・注意
今回の数値はFlamerix AIによる分析に基づくものであり、すべての利用環境で同じ割合になるとは限りません。使用するエージェント数や会話の長さによって消費率は変動すると考えられます。
また、無効化スクリプト「no-agent-summary.js」はClaude Codeのアップデートで内部の文字列が変わると機能しなくなる可能性があり、アップデート後に動作確認が必要になる点も把握しておくべきです。加えて、Opusモデルのリクエストに使用者のメールアドレスがヘッダーに含まれるという別の問題も報告されていますが、詳細な範囲や影響については出典内で明らかにされていません。Anthropic側からの正式な対応方針も、この時点では示されていません。
出典
この記事のつくり方
国内外の情報源(企業の公式発表や、国内外の報道)を巡回して、新しいニュースの候補を集めます。
AIが、選んだ出典だけをもとに記事を書きます。出典に無い数字・日付・発言は作りません。
20を超える決まりの検査と、別のAIによる出典との照らし合わせを通った記事だけを公開します。通らなかった記事は公開しません。
公開した記事には、運営者が目を通しています。誤りに気づいたときは、訂正するか、公開を取り下げます。