要点
- Claude Code は、裏で動いているエージェントの状況を短いラベルで画面に出すために、約30秒ごとにそのエージェントの会話を丸ごとモデルへ送り直している。
- 送り先は、もともとそのエージェントを動かしているモデルで、外の第三者にデータが渡る話ではない。ただ、使う量（利用枠や料金）は増える。
- 利用者の計測では全体の16〜26%を占めた例がある。Anthropic は平均で約2%だと説明した。この機能だけを切る公式の設定はまだない。
何が起きたか
Claude Code（Anthropic のプログラミング用 AI ツール）は、作業を「サブエージェント」に分けて、裏で並べて走らせることがある。サブエージェントは、本体の会話とは別に動く小さな AI の作業役だ。画面のエージェントの一覧には、それぞれが今何をしているかが「3〜5語」の短い英語のラベルで出る。
このラベルを作る処理（内部の名前は agent_summary）は、動いているサブエージェントごとに約30秒に1回、そのエージェントの会話の記録を丸ごとモデルに送り、要約を返させている。Anthropic の説明では、返ってきた要約は、利用者と Claude Code 自身が、会話の記録を読まずに各エージェントの状況を追うために使われる。この仕組みは、Flamerix AI が GitHub に公開した解析で広く知られた。2026年10月29日ごろに Hacker News で大きく話題になった。
数字は計る人によって大きく違う。
- Flamerix AI は、自社の1週間分の記録で、費用の見積もりの16.4%、リクエストの19.7%がこの処理だったと報告した。
- GitHub の issue #86879 は2026年8月15日に立てられた。起票した人は、サブエージェントを多く使う4時間の作業で、リクエストの22.7%、重みづけしたトークンの18.0%を占めたと書いている。ほかの利用者からは26%という報告もある。
- 日本の Claude Code 研究所は、2026年10月30日に v2.1.312 で実際に計った。サブエージェント1つを約3分動かすと、要約は6回送られ、会話全体の費用の見積もりの約16%を占めた。
Anthropic で Claude Code を担当する Edwin Arbus 氏は、Hacker News でこう答えた。要約が送られるのは、作業中の裏のエージェントだけで、待機中のエージェントには送らない。テレメトリ（利用状況の送信）を許した利用者の直近1週間では、定価で見た費用の約2%、リクエストの4%弱。ターミナルだけに絞ると約6%だという。そのうえで「ステータス行にしては多い」と認めた。キャッシュ（前に送った内容の使い回し）が効かずに一番高くつく場合は、v2.1.311 以降で直したとしている。会話を丸ごとではなく短いメモを小さいモデルに送る、ずっと安いやり方も作っているという。
16%と2%の差について、Claude Code 研究所は使い方の違いから出ていると見ている。サブエージェントを多く、長く、大きな資料を持たせて走らせる人ほど、割合は大きくなる。
日本の利用者への影響
Claude Code は日本の開発者にも広く使われている。日本に固有の影響があるかは分かっていない。仕組みは世界で同じなので、サブエージェントを裏で多く走らせる人は、日本でも同じように利用枠を使っていることになる。Claude Code 研究所の計測では、日本語で頼んでもラベルは英語で返ってきた。
送られるのは、ふだんからそのモデルに送っている会話の記録だ。気にするべきなのは、Pro や Max といった定額プランの利用上限に早く届くこと。API で使っている人なら、請求額が増えることだ。
今すぐやること
- Claude Code を最新に更新する。Anthropic は、v2.1.311 で一番高くつく場合を直したと説明している。
- 自分の使用量を確かめる。チームで使っているなら、OpenTelemetry（利用状況を自分たちの監視の仕組みへ送る機能）で、この処理の分を分けて数えられる。この処理はローカルの会話の記録には残らない、と複数の利用者が報告している。
- 大きな資料を読ませるサブエージェントには、安いモデル（Haiku など）を割り当てる。要約は、そのエージェントと同じモデルで送られるからだ。Claude Code 研究所はこれを勧めている。
- 長く続く一括作業は、対話ではなく非対話の実行（
-p）に回すことを考える。研究所の計測では、この形では要約は送られなかった。 - 出回っている非公式の止め方は、慎重に考える。Claude Code 研究所は、更新すると知らないうちに効かなくなるおそれや、利用規約との関係を理由に、導入を勧めていない。
背景
AI のコーディングツールは、利用者が気づかないところでもモデルを呼んでいる。Anthropic の公式の説明でも、会話の振り返り（session recap）、手が空いたときの会話の圧縮（idle compaction）、次の入力の候補表示は、裏でトークンを使うと書かれている。いずれも、切り方が用意されている。
今回の要約は、この公式の説明に載っていなかった。専用の切り方もない。issue #86879 では、要約を切る設定を求める声が8月から続いている。10月末の時点で Anthropic の返事はなく、issue は開いたままだ。Arbus 氏の返答も、設定を足すかどうかには触れていない。
技術者向けの詳細
- 対象: 対話モード（ターミナル、VS Code）で裏で動くサブエージェント。デスクトップアプリは CLI と unix ソケットでやりとりするので対話モードに当たらず、普通の裏のエージェントには要約が付かない（フォークには付く）との解析がある。第三者の解析では、2026年8月13日の v2.1.232 から既定でオンとされる（Anthropic は確かめていない）。
- 間隔: 約30秒。v2.1.300 から、サーバー側の設定で30〜240秒の間で変わるとの解析がある。会話が変わっていなければ送信は省かれる。
- 要約は
skipTranscriptで送られ、セッションの.jsonlに残らない（issue #86879、#104358 の報告）。会話の記録から使用量を数えるツールには出ない。 - 回数を確かめる:
claude --debug-file <path>で起動し、ログのForking for summaryの行を数える（Claude Code 研究所）。transcript unchangedの行は、送信が省かれた回だ。 - 費用を確かめる: OpenTelemetry の
claude_code.api_requestイベントをquery_source = agent_summaryで絞る。テレメトリの送り先は、自分たちで管理する受け口にする。 - 減らす・止める（効くかどうかは版と環境で違うと報告されている）:
CLAUDE_CODE_FORK_SUBAGENT=0: 研究所の macOS・v2.1.312 では0回になった。v2.1.312 で効かなかったという報告もある。settings.jsonのenvが環境変数を上書きする場合がある、との指摘も出ている。CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1: 0回になる。代わりに、裏での実行と Ctrl+B が使えなくなる。CLAUDE_CODE_DISABLE_AGENT_VIEW=1: 要約は止まらない。CLAUDE_CODE_AGENT_PROGRESS_SUMMARIES: オンにする方向にしか働かず、0もオン扱いになるとの解析がある。idleCompactionは別の機能だ。
- 非公式の止め方: Flamerix AI の Bun の preload スクリプトがある（
BUN_OPTIONSで読み込む）。更新で目印の文字列が変わると、黙って効かなくなる。使うなら、更新のたびに確かめ直す必要がある。 - 公式の費用の説明: Manage costs effectively。
/usageの内訳は、この端末のローカルの記録から計算される。
