親エージェントが複数の subagent を並列に走らせる構成では、コストと遅延の支配項が「1 回の応答の長さ」ではなく「呼び出し回数 × 各呼び出しの出力長」に移る。本稿は、公式リリースノートで確認できる範囲に限定して、出力トークン予算を宣言的に上限づけるためのパラメータとベータヘッダーを整理する。検証日は 2026-07-12(JST)。
1 呼び出しあたりの出力上限: advisor の tools[].max_tokens
advisor ツールには、アドバイザーモデルの 1 回あたりの出力を上限づけるパラメータが追加された(2026-06-02)。
The advisor tool now supports a max_tokens parameter to cap the advisor model's output per call
設定箇所はツール定義側である。
Set tools[].max_tokens on the advisor tool definition
リリースノートは、この上限が「遅延と出力トークンコストの削減」に効く対象として、フルレングスのアドバイザー応答を必要としないワークロードを挙げている。並列 fan-out の各枝が短い判定だけを返せばよい場合が、これに該当する。
ループ全体の予算: task budgets(ベータ)
個々の呼び出しではなく、エージェンティックループ全体に対して予算を与える機能がベータ提供されている(2026-04-16)。
Give Claude an advisory token budget for a full agentic loop (thinking, tool calls, tool results, and output)
予算の対象は thinking・tool calls・tool results・output の全体であり、モデルは残量のカウントダウンを参照して作業の優先順位を決め、予算消費に合わせて作業を終える。利用にはベータヘッダーが必要である。
Include the task-budgets-2026-03-13 beta header in your requests.
対応モデルは拡張されており、Claude Opus 4.8 でも利用できる(2026-05-28)。
Task budgets now support Claude Opus 4.8.
thinking の深さ: effort
thinking の深さを制御するパラメータは effort に一本化され、GA 済みでベータヘッダーを要さない(2026-02-05)。
The effort parameter is now generally available (no beta header required)
Effort replaces budget_tokens for controlling thinking depth on new models.
新モデルでは budget_tokens の代替として effort を使う。出力上限(max_tokens)と thinking の深さ(effort)は別軸であり、両方を明示しない限り予算は締まらない。
単一呼び出しの上限を引き上げる: Message Batches API の 300k
上限は下げるだけでなく上げる方向にも動かせる。Message Batches API では、Claude Opus 4.6 と Sonnet 4.6 について max_tokens の上限が 300,000 トークンへ引き上げられた(2026-03-30)。
We've raised the max_tokens cap to 300k on the Message Batches API for Claude Opus 4.6 and Sonnet 4.6
Include the output-300k-2026-03-24 beta header to generate longer single-turn outputs
長文コンテンツ・構造化データ・大規模なコード生成といった単一ターンの長い出力が対象として挙げられている。
セッション単位の構成差し替え: agent_with_overrides
Claude Managed Agents では、セッション作成時に構成を上書きできる(2026-06-30)。
to replace the model, system prompt, tools, MCP servers, or skills for a single session
エージェント本体は変更されないため、同一エージェント定義のまま、セッションごとにモデルやツール構成を差し替えられる。
ツール出力の暴発: 100K spill
入力側の予算も自動で保護される。agent_toolset および MCP ツールの出力が 100,000 トークンを超えると、サンドボックス内のファイルへ自動的に退避される(2026-05-19)。
large outputs from agent_toolset and MCP tools exceeding 100K tokens are now automatically spilled to a file in the sandbox
The model receives a truncated preview with the file path
モデルはトランケートされたプレビューとファイルパスを受け取り、必要ならそこから全文を読む。
対応モデル
advisor ツールは Claude Opus 4.8 をサポートする(2026-05-28)。
The advisor tool now supports Claude Opus 4.8.
References
[1] https://platform.claude.com/docs/en/release-notes/overview