Claude Codeのサブエージェントが使用上限をより少なく消費するように

Claude Code のサブエージェントが、使用量上限の消費を抑えられるようになりました。Anthropic は、バックグラウンドサブエージェントのステータスライン更新方式を、会話全体の再読み込みから、短いメモをもとに動作する Haiku 5.5 へと変更しました。1回の更新にかかるコストは約99%削減され、バックグラウンドサブエージェントを含むセッションでは上限の消費が約5%減りました。この変更を利用するには、v2.1.316 以降へアップデートしてください。

以上が、4文にまとめたこのニュースの全体像です。この記事の残りの部分では、この変更の対象となるユーザー、2つのパーセンテージの意味、依然として不明な点、そしてサブエージェントの消費をさらに削減できる設定について解説します。

Claude Code サブエージェントの変更点

バックグラウンドサブエージェントとは、メインセッションの作業を続けながら並行して動作するヘルパーです。ターミナルには短いステータスラインが表示され、何をしているのかを確認でき、この行は30秒ごとに更新されます。

Anthropic は2026年11月5日に、この変更を X で発表しました:

変更前: 30秒ごとの更新のたびに、サブエージェントの会話全体を再読み込みしていました。
変更後: Haiku 5.5 が短いメモをもとに更新を書き出します。
変更なし: サブエージェントは引き続き独自のモデルを使用します。Opus 5.5 や Sonnet 5.5 で動作している場合は、それもそのままです。ステータスラインだけが Haiku 5.5 に移行しました。

設定を変更する必要も、作業そのものの品質を犠牲にする必要もありません。サブエージェントの出力は、以前と同じモデルから生成されます。

サブエージェントのステータスラインが高コストだった理由

ステータスラインが高コストだったのは、わずか1行の要約のために、長い会話全体を読み込む対価を払っていたからです。出力はごく小さいものでしたが、入力は違いました。しかもこの処理は、サブエージェントが動作している間ずっと、30秒ごとに繰り返されていました。

2つのフローを比較した図。変更前は、30秒ごとのステータス更新のたびにサブエージェントの会話全体が入力されていた。変更後は、短いメモが Haiku 5.5 に渡され、そこから更新が書き出され、1回あたりのコストは約99%削減される

この計算から、コストがどれだけ速く膨らむかがわかります。30秒に1回の更新ペースでは、1時間動作したサブエージェントで120回の更新が発生します。3つを1時間動かせば360回です。

会話の長さも影響します。Claude Code のコストに関するドキュメントによると、トークンコストはコンテキストサイズに比例して増加し、サブエージェントの会話はファイルを読んだりツールを実行したりするほど大きくなります。つまり、旧設計では、長時間動作するサブエージェントが最大のコンテキストを抱えているときに、最も多くコストがかかっていたと考えられます。Anthropic がコスト曲線を公表していないため、これはドキュメントに基づく当社の解釈です。

これは、/statusline で設定するカスタムステータスラインとは混同しないでください。ステータスラインのドキュメントによると、こちらはローカルで動作し、API トークンを消費しません。今回の変更の対象は、Claude Code が動作中の各サブエージェントに対して生成するステータスラインです。

数字の読み方:更新ごとに99%、セッションごとに約5%

この2つの数字は異なるものを測っており、使用量上限に言及しているのは片方だけです。

数字	測定対象	該当しないもの
約99%削減	ステータス更新1回のコスト	請求額や使用量上限の節約
約5%削減	バックグラウンドサブエージェントを含むセッションが消費する上限	サブエージェントなしのセッションでの節約
約6%増	Anthropic によると、同じ上限から得られるプロンプト数	上限そのものの引き上げ

棒グラフによる比較。ステータス更新1回のコストは約99%減少する一方、バックグラウンドサブエージェントを含むセッション全体の消費は約5%減少する(According to Anthropic)

1つだけ数字を覚えるなら、5%にしてください。セッションのごく一部を占めるものを99%削減しても、セッション全体で得られる節約は小さなものです。サブエージェントは実際の作業を引き続き独自のモデルで行っており、使用量の大半はその作業に使われます。

Anthropic は、ステータス更新が以前どれだけの上限を消費していたかについては明らかにしていません。2つの数字を合わせると、これらのセッションの約20分の1程度と推測できますが、これは丸められた数字からの推論であり、公表された数値ではありません。

実際の節約幅はケースごとに異なります。約5%というのは、バックグラウンドサブエージェントを含むセッション全体に対して Anthropic が報告した値です。幅については公表されておらず、短時間のサブエージェントを1つだけ使うセッションは、長時間のものを複数使うセッションほどの節約にはなりません。

サブエージェント消費の削減対象になるのは誰か

Anthropic によると、この変更はほとんどの個人プランとすべての組織プランで有効になっており、対象は CLI のみです。

Claude Code の利用環境	状況
Pro、Max、Ultra	ほとんどのユーザーに有効(全員ではない)
Team、Enterprise	全ユーザーに有効
CLI	対応済み(v2.1.316 以降)
デスクトップアプリ	変更の必要なし:このステータスラインは書き出さない
API キー、Bedrock、Vertex、Foundry	言及なし

デスクトップアプリに関する情報は、同じスレッドでの返信によるもので、Anthropic の Lydia Hallie が、デスクトップアプリはこのサブエージェントのステータスラインを書き出さないため、変更すべき箇所がなかったと説明しています。

知っておくべき2つの不明点があります:

「ほとんど」を確認する公開された手段はない。 スレッドやドキュメントには、自分の Pro、Max、Ultra アカウントで有効になっているかを示すフラグやインジケーターは記載されていません。正しいバージョンを使っていることは必要条件ですが、それだけでは変更が自分に適用されている証明になりません。
従量課金ユーザーにはまだ答えがない。 Anthropic はこの変更をプランの使用量上限を中心に説明しており、API キーやクラウドプロバイダー環境には触れていません。ただし、2.1.318 のチェンジログでは、Bedrock、Vertex、Foundry 利用時やテレメトリ無効時にサブエージェントの進捗サマリーが変更されています:プロンプトキャッシュがコールドな状態では、サブエージェントの保留中の応答を最大5分待つことがあります。これは、こうした環境に独自の扱いが用意されていることを示すものであり、この節約が適用されることを示すものではありません。

また、確認した限り 2.1.316 のチェンジログにもステータスラインへの言及はないため、この数字とバージョンに関する情報源はスレッドのみです。

Claude Code のアップデート方法とバージョンの確認方法

必要なのは3つのコマンドだけです:

claude --version   # needs to show 2.1.316 or later
claude update      # installs a newer version if one exists
claude --version   # confirm

claude update はパッケージマネージャー経由のインストールでも機能し、その場合はそのパッケージマネージャーを通じてアップデートされます。11月5日時点でチェンジログに記載されていた最新バージョンは 2.1.318 でした。

サブエージェントの消費量を確認するには、セッション内で /usage を実行します。Pro、Max、Ultra、Team、Enterprise プランでは、最近の使用量がスキル、サブエージェント、プラグイン、MCP サーバーごとのパーセンテージで内訳表示されます。d または w キーで24時間表示と7日間表示を切り替えられます。数値は概算であり、そのマシンのローカル履歴に基づくものなので、変更前後の比較は大まかな目安として扱ってください。上限をこまめに追跡している方は、当社の Claude Pro/Max 上限ガイドで仕組みの詳細を解説しています。

サブエージェントの消費をさらに抑えるその他の方法

ステータスラインの修正は自動的に適用されますが、削減効果は約5%です。残りの部分についてはドキュメントにはっきり記載されています:各サブエージェントは独自のリクエストを送信し、それらはメイン会話と同じ上限にカウントされます。より効果が見込めるのは、以下の設定です。

小さいモデルを選ぶ。 サブエージェントは、特に指定がなければセッションのモデルを引き継ぐため、Opus への切り替えはそのサブエージェントにも適用されます。単純な作業用のサブエージェント定義には model: haiku を設定しましょう。この設定方法については、当社の Claude Code における Claude Haiku 5.5 ガイドで解説しています。

すべてのサブエージェントにデフォルトを設定するには:

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

最初の変数だけでは、あくまでデフォルト値にすぎません。サブエージェント定義や Claude が渡すモデルが依然として優先され、組み込みの Explore と Plan サブエージェントには適用されません。2つ目の変数は、すべてのサブエージェントに1つのモデルを強制します。

effort レベルを下げる。 バージョン 2.1.316 では CLAUDE_CODE_SUBAGENT_EFFORT が追加されました。これは、他で指定がない場合にサブエージェントの effort レベルを設定するもので、セッションの値を引き継ぐ代わりになります。チェンジログには記載されていますが、11月5日時点では環境変数リファレンスには載っていないため、実際に使用する前に受け入れ可能な値を確認してください。個別のサブエージェントには、定義内の公式ドキュメント記載の effort フィールドを設定します(low、medium、high、xhigh、max、モデルにより異なります)。

同時実行数を減らす。 デフォルトの上限は、セッションあたり動作中のサブエージェント20個です。厳密な上限を設けたい場合は、CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS をより小さい整数に設定してください。/tasks を実行すると、何が動作しているか、各サブエージェントがどのモデルと effort を使用しているかを確認できます。

指示の範囲を狭く保つ。 コストに関するドキュメントには、曖昧なリクエストは広範なスキャンを引き起こすと記載されています。1つのエンドポイントを確認するよう指示されたサブエージェントは、API 全体をレビューするよう指示されたサブエージェントよりも読み込む量が少なくなります。定義フォーマット全体については、当社のカスタム Claude Code サブエージェント作成ガイドで解説しています。

Apidog CLI でバックグラウンドサブエージェントによる API テストを実行する

API テストの実行は、バックグラウンドサブエージェントに向いています:時間がかかり、出力が冗長で、必要なのは失敗の結果だけだからです。Apidog CLI を使えば、メインセッションがコーディングを続ける間に、サブエージェントが保存済みのテストシナリオを実行でき、生の出力はメインのコンテキストに入らずに済みます。

一度だけセットアップします:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick Claude Code when prompted

次に、.claude/agents/api-tester.md に小さなサブエージェントを追加します:

---
name: api-tester
description: Runs Apidog test scenarios and reports only the failures.
tools: Bash, Read
model: haiku
background: true
---
Run the Apidog test scenario you are given. Report which steps failed
and why. Don't paste the full output.

あとは Claude Code に次の1つのプロンプトを渡すだけです:

Use the api-tester subagent to run Apidog test scenario <scenarioId> in
project <projectId> against environment <environmentId>. Keep working on
the checkout refactor. When it finishes, tell me only what failed.

サブエージェントは、次のようなコマンドを実行します:

apidog test-scenario list --project <projectId>
apidog test-scenario run <scenarioId> --project <projectId> -e <environmentId> -r cli,json --out-dir apidog-reports

バックグラウンドサブエージェントからの権限確認プロンプトはメインセッションに表示され、どのサブエージェントが要求しているかが示されます。長時間の実行では、2.1.318 によりシェルコマンドが3分後にバックグラウンドへ移行されるため、実行中にプロンプトキャッシュが失効することはありません。

同じ run コマンドは、-r junit を付ければ CI でも動作します。詳細は Apidog CLI CI/CD ガイドをご覧ください。一般的なセットアップについては、Claude Code における Apidog CLI を参照してください。Apidog の Free プランは最大4ユーザーまで利用できます。

FAQ

Claude Code のサブエージェントは99%安くなったのか? いいえ。99%はステータス更新1回ごとに適用される数字です。Anthropic によると、バックグラウンドサブエージェントを含むセッションの上限消費は約5%減少しています。

サブエージェントは Haiku 5.5 で動作するようになったのか? いいえ。サブエージェントは引き続き独自のモデルを使用します。Haiku 5.5 に移行したのはステータスラインだけです。

必要なバージョンは? v2.1.316 以降です。claude --version で確認し、claude update でアップグレードしてください。

Claude デスクトップアプリにも適用されるのか? いいえ。変更すべき箇所がなかったためです。Anthropic の Lydia Hallie によると、デスクトップアプリはこのサブエージェントのステータスラインを書き出さないとのことです。

自分の Pro プランで有効になっているのか? おそらく有効ですが、確実ではありません。Anthropic によると、Pro、Max、Ultra ユーザーのほとんどに適用されており、Team と Enterprise では全ユーザーに適用されています。ただし、スレッドやドキュメントには、自分のアカウントを確認する方法は記載されていません。

API キーや Bedrock を使っている場合にも効果があるのか? Anthropic は言及していません。この発表は使用量上限についてのものであり、API キー、Bedrock、Vertex の使用には触れていません。