Claude Codeのサブエージェント、背景で動くと30秒ごとに要約？agent_summaryのトークン使用量を実測

Claude Codeのサブエージェントとは？前面と背景の違い

サブエージェントは、Claude Codeの本体の会話から仕事を切り出し、別の作業用コンテキストで進めさせる仕組みです。大量の資料の読み込みや調べものを任せると、本体の会話には結果だけが戻るので、本体を軽く保てます。2026年10月30日時点の公式ドキュメントでは、何も設定しなければClaudeが起動するサブエージェントは背景（バックグラウンド）で動きます。

前面（フォアグラウンド）のサブエージェントは、終わるまで本体の会話が待ちます。背景のサブエージェントは本体と並行して動き、許可が必要な操作の確認は本体の画面に出ます。どちらになるかは、起動のしかたで次のように変わります（公式ドキュメント「Run subagents in foreground or background」）。

背景のサブエージェントは、入力欄の下のパネルに1体1行で表示されます。行には経過時間とトークン数、そして「いま何をしているか」の短いラベルが出ます。当研究所の実測では、起動直後は依頼の説明（「8回の sleep/echo 反復」）が表示され、約30秒後から「Printing step 2 marker」のような英語のラベルに置き換わりました。このラベルを作っているのが、次に説明する agent_summary です。

なお、サブエージェントに分けても上限の節約にはならず、合計の消費はむしろ増えることを、上限がすぐ減る理由の記事で claude -p を使って実測しています。そちらは非対話の測定なので、この記事で扱う要約の分は含まれていません。

agent_summaryとは？30秒ごとに何が送られているのか

agent_summaryは、動いている背景サブエージェントごとに約30秒に1回、そのエージェントのそれまでの会話全体を同じモデルに送り、「直近の動きを3〜5語で」と頼んでパネルのラベルを作る送信です。答えはラベルに使われるだけで、エージェント本人の文脈にもあなたの会話にも戻りません。OpenTelemetry出力では、query_source が agent_summary の送信として記録されます（当研究所の手元で確認）。

発端はHacker Newsの「ステータス表示が16%」という報告

2026年10月29日、NikZaal氏がFlamerix AIの調査として、Hacker Newsに「Claude Codeは背景エージェントの会話記録を定期的にモデルへ送っている」と投稿しました。同社がOpenTelemetryの記録を送信元別に集計したところ、1週間で agent_summary が推定費用の16.4%（本体の会話は15.7%）、リクエストの19.7%を占め、入力と出力の比は約9,000対1だったという報告です（Hacker Newsの投稿）。同じ問題は8月からGitHubでも報告されていて、27体のサブエージェントを使った4時間のセッションでリクエストの22.7%・加重トークンの18.0%という測定のほか、利用者による18〜26%の測定が集まっています（issue #86879）。

Flamerix AIのバイナリ解析によると、この要約は2026年8月13日のv2.1.232で対話型の背景エージェントに対して既定でオンになり、v2.1.300で間隔がサーバー側で30〜240秒に調整できるようになり、v2.1.310には会話全体の代わりに約2,000トークンのメモを送る安い方式が無効のまま入っています（同社のgist）。これは第三者の解析で、Anthropicが公表した経緯ではありません。

公式ドキュメントには載っていない

公式ドキュメント「Manage costs effectively」の「Background token usage」は、待機中などに使われるトークンとしてセッションの振り返り（session recap）・待機中のcompact・次の入力候補（prompt suggestions）を挙げていますが、agent_summaryは載っていません（2026年10月30日確認）。紛らわしい記述が2つあります。ステータスラインのページの「ローカルで動き、APIトークンを消費しない」は、settings.json で自作するステータスラインの話で、サブエージェントのパネルとは別物です。エージェントビュー（背景セッションの一覧画面）の行要約は「Haiku級のモデルが数分ごとに書き直す」と明記された別の仕組みで、こちらも agent_summary ではありません（Agent view）。

Anthropicの回答：全体では約2%、ターミナルでは約6%

投稿から約1時間20分後、Claude Codeを担当するAnthropicのEdwin Arbus氏が返信しました。対象は「動いている背景エージェントだけで、約30秒ごと。待機中の背景エージェントには送らない」こと、要約は利用者とClaude Code自身が、会話記録を読まずに各エージェントの状況を追うために使っていることを説明しています。テレメトリを送っている利用者全体では、前週の agent_summary はAPIの定価換算で費用の約2%、リクエストの4%弱、ほぼすべてが発生するターミナルに限ると約6%だったとしています。

「とはいえ、ステータスラインにしては多いという点には同意します。最も高くつくケース、つまりプロンプトキャッシュを外す要約の修正をちょうど配信したところで（2.1.311以降）、いまは会話全体の代わりに短いメモを小さいモデルへ送る、ずっと安い方式に取り組んでいます。」

"That said, we agree that's a lot for a status line. We just rolled out a fix for the most expensive case, summaries that miss the prompt cache (2.1.311+), and right now we're working on a much cheaper mode that sends short notes to a smaller model instead of the full transcript."

Edwin Arbus（Anthropic・Claude Code担当）— Hacker Newsのコメント（2026年10月29日）

16%と2%は、どちらかが間違っているというより、測っている使い方が違うと当研究所は見ています。背景エージェントをほとんど使わない人まで含めた平均なら小さくなり、背景エージェントを何体も並べて長時間動かすチームでは大きくなります。どちらに近いかは、次の実測のように自分の環境で確かめられます。

実測：背景のサブエージェント1体で何回・いくら送られる？

当研究所のMac（macOS・Claude Code v2.1.312・Maxプラン）で、Haikuのサブエージェント1体を背景で約3分動かすと、要約は約31秒おきに6回送られ、会話全体の推定費用の16.0%と16.4%（2回測定）、リクエスト29件のうち6件（21%）を占めました。要約1回の費用は、そのサブエージェントが作業を1手進める送信とほぼ同じでした。

測り方

対話型の Claude Code を疑似端末で起動し、公式のOpenTelemetry出力を同じMacの中の受信プログラムに送って、送信（api_request）を送信元（query_source）別に数えました。あわせて --debug-file のログで要約の行を数えています。課題は、general-purposeのサブエージェント1体に「sleep 20 と echo step N を交互に8組」実行させる単純なもので、本体の会話はHaikuです。ユーザー設定とMCPサーバーは読み込まない状態（--setting-sources project,local と --strict-mcp-config）で揃えました。費用はClaude Code自身が記録する定価換算の推定（cost_usd）で、請求額ではありません。ProやMaxでは利用枠の消費として効きます。

測ってわかった5つのこと

なぜ作業量ではなく「時間と文脈の大きさ」で増えるのか

要約の費用は「動いている時間（30秒ごとに1回まで）× 体数 × そのエージェントの文脈の大きさ × モデルの単価」で決まり、仕事の量にはほぼ比例しません。手元の実測では、サブエージェントが1本の長いコマンドを待っている間は会話が変わらないため要約が省かれ、短い手順を刻み続けると毎回送られました。

100秒かかる集計スクリプト1本を実行させた条件では、要約のタイマーは3回動いたものの、実際に送られたのは最初の1回だけで、残り2回はログに「transcript unchanged（会話記録が変わっていない）」と出て省かれました。逆に、確認しては表に追記する、といった短い手順を続けるエージェントは、30秒ごとに必ず会話全体を送り直します。

当研究所の試算では、約14万トークンの文脈を持つHaikuのエージェントが短い手順を1時間刻み続けると、要約だけで約120回・約0.88ドル（1ドル＝157円で約138円）になります。上の実測の要約1回分（0.0073ドル）に、1時間の回数を掛けた上限側の目安です。士業の業務に置き換えると、顧問先の決算資料を何十社分も読み込んだエージェントに「1社ずつ確認して一覧に追記」を長時間続けさせ、それを複数体並べると、体数と時間に比例して要約が積み上がります。数分で終わる調べもの1回なら、要約は数回で済みます。

agent_summaryを止める・減らす設定は？5条件の実測

2026年10月30日時点で、要約だけを止める公式の設定はありません。当研究所のmacOS・v2.1.312では、fork modeを切る設定、背景実行を切る設定、claude -p のいずれでも要約は0回になり、エージェントビューを切る設定では止まりませんでした。どれも要約以外の動きが変わるので、副作用と合わせて選びます。

環境変数は、公式ドキュメントの例と同じく ~/.claude/settings.json の env に書けば、毎回のシェルで設定する必要がありません。

{
  "env": {
    "CLAUDE_CODE_FORK_SUBAGENT": "0"
  }
}

非公式の「止めるスクリプト」は勧めません

Flamerix AIは、Claude Codeの中で要約のタイマーだけを無効にする小さなスクリプト（Bunの preload）を公開しています。仕組みとしては巧みですが、当研究所は導入しておらず、業務の環境には勧めません。作者自身が書いているとおり、更新で内部の文字列が変わると黙って効かなくなること、BUN_OPTIONS という環境変数でマシン上のすべての bun に読み込まれること、利用サービスの規約との関係は利用者が確認する必要があることが理由です。GitHubのスレッドでも、導入手順が毎回最新版をダウンロードする形である点を挙げて「よく見ずに入れないほうがいい」という指摘が出ています。

当研究所が勧める付き合い方

自分の環境で確かめるには？回数と費用の数え方

回数だけなら、--debug-file でログを書き出し「Forking for summary」の行を数えるのが最も手軽です。費用まで見るなら、公式のOpenTelemetry出力を有効にして、api_request イベントを query_source が agent_summary のものに絞って集計します。/usage の内訳や、会話の記録を読む集計ツールでは、この分は確認できません。

方法1：デバッグログで回数を数える

# いつもどおり作業する（ログを書き出しながら起動）
claude --debug-file ~/claude-debug.log

# 作業のあと、別のターミナルで
grep -c "Forking for summary" ~/claude-debug.log      # 実際に送られた要約の回数
grep -c "transcript unchanged" ~/claude-debug.log     # 変化がなく省かれた回数

手元のログには「[AgentSummary] Forking for summary, 21 messages in context」のように、そのとき会話に何件のメッセージがあったかも出ます。件数が増えていくほど、1回の要約で読み直す量も増えています。

方法2：OpenTelemetryで費用を送信元別に集計する

公式ドキュメント「Monitoring」の手順でテレメトリを有効にすると、送信ごとに model・トークン数・推定費用（cost_usd）・query_source が付いた api_request イベントが出ます。本体は repl_main_thread、サブエージェントは agent:builtin:general-purpose のような名前、要約は agent_summary です。社内でDatadogやGrafanaなどの監視基盤に送っているなら、query_source で絞るだけで割合が出ます。

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/json
export OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4318   # 自社・自分の受信先
claude

注意点が2つあります。1つ目に、このイベントには利用者のメールアドレスやアカウントIDが入るので、送り先は自社で管理する受信先に限ってください。当研究所も生のログは公開せず、集計した数字だけを載せています。2つ目に、公式ドキュメントによると、テレメトリの送り先を決める変数はリポジトリの .claude/settings.json では無視されます。シェルか ~/.claude/settings.json、組織なら管理設定に書きます。

/usage や集計ツールで見えない理由

公式ドキュメントによると、/usage の内訳は「このマシンのローカルな履歴から計算した概算」です。手元の測定では要約は会話の記録（.jsonl）に残らなかったので、/usage の内訳にも出ないと当研究所は推測しています（Anthropicの説明ではありません）。会話の記録を読んで費用を集計する外部ツールも同様に、要約の分を数えられません。Claude Codeの料金プランごとの考え方は料金の解説記事にまとめています。

まとめ