入れ子サブエージェントは結局、有効なのですか無効なのですか？

2026年7月24日のv2.1.219以降、デフォルトで深さ3まで有効です。7月21日のv2.1.217でいったんデフォルト無効になりましたが、3日後に方針が変わりました。無効に戻したい場合は環境変数CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTHに1を設定してください。

アップデート後にサブエージェントが起動しなくなりました。原因は何ですか？

v2.1.217またはv2.1.218を使っている可能性があります。v2.1.217で入れ子サブエージェントがデフォルト無効になったため、多段構成のワークフローが動かなくなります。v2.1.219以降に更新すれば深さ3のデフォルト有効に戻ります。あわせて同時実行数のデフォルト上限20件に達していないかも確認してください。

Claude CodeでClaude Opus 5を使うには何か設定が必要ですか？

v2.1.219以降に更新すれば、Opusを選んだ時点でClaude Opus 5が使われます。従来のOpus 4.8を使い続けたい場合は/modelで明示的に選択してください。なおOpus 4.7はファストモードの対象から外れ、/fastはOpus 5とOpus 4.8に適用されます。

Claude Opus 5のファストモードは使ったほうが得ですか？

用途によります。Anthropicの公表値では基本料金の2倍で約2.5倍の速度とされており、人が画面の前で待っている対話的な作業ほど有利になりやすい計算です。一方、夜間バッチや非同期の自動処理では速さが価値を生みにくいため、通常モードが選択肢になります。実際の損得はワークロードによって変わります。

Claude Code v2.1.220にアップデートする前に確認すべきことは何ですか？

サブエージェントを多段で組んでいる場合は、想定する深さと同時実行数が新しいデフォルト値の範囲に収まるかを確認してください。またv2.1.218にはエージェント定義ファイルのフックに関するセキュリティ修正が含まれるため、外部から取得したエージェント定義を使っている場合は早めの更新をおすすめします。

Dev Tools 2026年7月26日 30分で読める

Claude Code Opus 5標準化＆サブエージェント深さ3復活｜2026年7月第4週

#Claude Code #Anthropic #Claude Opus 5 #サブエージェント #セキュリティ #アップデート #AI開発ツール #AI

7月21日、Claude Codeはサブエージェントの入れ子起動をデフォルトで止めた。7月24日、同じ機能が深さ3まで許可された状態で戻ってきた。中2日である。

サブエージェントとは、Claude Codeが本体の会話とは別に立ち上げる作業用の分身のことだ。その分身がさらに分身を呼ぶのが「入れ子（ネスト）」で、深さ3は孫の代まで許すという意味になる。この深さを何段まで許すかが、今週いちばん揺れた設定だった。

揺り戻しの手前には、6月に起きた実害がある。GitHubに上がった報告では、git cloneとfindで済むはずのタスクがサブエージェントの再帰によって30分で120万トークンを超えて消え、別の事例では5分足らずで400万トークンが溶けて5時間分のセッション枠を使い切っている。深さは50階層に達し、表示ラベルが途中で切れた。CLAUDE_CODE_FORK_SUBAGENT=0を設定しても止まらなかったという（出典: GitHub Gist yurukusa、2026年6月27日）。

v2.1.217からv2.1.220までの1週間は、この「エージェントをどこまで自由に走らせるか」という問いへの回答が二転した週だった。そこにClaude Opus 5のCLI標準化が重なる。先週のまとめから続く流れとして、順に整理する。

この記事はこんな人におすすめ

Claude Codeを日常的に使っていて、今週の変更点を短時間で把握したい方
サブエージェントを多段・並列で組んで自動化している方
チームでClaude Codeの導入・検証を進めていて、更新方針を決める必要がある方
Opus 5のファストモードを使うべきか判断したい方

結論（忙しい人向け）

入れ子サブエージェントはv2.1.217でデフォルト無効化、v2.1.219で深さ3のデフォルト有効に戻った。止めたい場合はCLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1
同時実行は20件が上限に。予算上限（--max-budget-usd）でバックグラウンドのエージェントも止まるようになった
Opus 5がデフォルトのOpusに。ファストモードは100万トークンあたり入力10ドル・出力50ドル（税別）
/code-reviewがバックグラウンド実行になり、レビューが会話のコンテキストを食わなくなった
セキュリティ修正あり。エージェント定義ファイルのフックが未信頼フォルダから実行される問題が塞がれた

今週のバージョン別サマリー

バージョン	日付	主な変更	影響度
v2.1.217	7月21日	入れ子デフォルト無効化・同時実行20件上限・予算上限でバックグラウンド停止	大
v2.1.218	7月22日	`/code-review`の背景実行・`/deep-research`の手動化・エージェント定義フックのセキュリティ修正	大
v2.1.219	7月24日	Opus 5がデフォルトOpusに・入れ子は深さ3に・`sandbox.network.strictAllowlist`	大
v2.1.220	7月25日	バグ修正と安定性の改善のみ	小

サブエージェント制御の3日間：無効化から深さ3へ

7月21日のv2.1.217で入った変更は3点だ。サブエージェントの同時実行数にデフォルト20件のキャップが入り、入れ子起動がデフォルトで無効になり、--max-budget-usdの予算上限が実行中のバックグラウンドエージェントも止めるようになった（出典: Claude Code公式チェンジログ）。

リリース翌日にQiitaで解説を書いた@picnic氏は、これを「実務上インパクトの大きい変更」と評した上で、厄介な現れ方を指摘している。「何もしていないのに突然エージェントが起動しなくなる」。使う側が設定を変えていなくても、更新したことでワークフローの前提が変わるためだ。同氏はネスト構成の有無と同時実行数を事前に確認し、プロジェクトのCLAUDE.mdに明記してチーム内の事故を防ぐことを勧めている（出典: Qiita @picnic、2026年7月22日）。

そして7月24日のv2.1.219。「サブエージェントは深さ3まで入れ子を起動できる（従来は1）。無効にするにはCLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1」という一行が入った（出典: Claude Code公式チェンジログ）。ここでいう「従来は1」とは、3日前のv2.1.217で無効化された状態のことだ。6月の解禁時点では上限5だったので、5から1、そして3への往復になる。

なぜ全面禁止ではなく深さ3だったのか

6月10日に入れ子サブエージェントが解禁されたとき、上限は5階層だった。今回のデフォルトはその半分強にあたる3。この数字は、機能そのものへの需要と暴走時の被害額の間で引かれた線に見える。

入れ子の主目的は並列化ではなく、雑多なツール呼び出しを深い階層に閉じ込めて親の会話を軽く保つことにある。ノイズの隔離だ。トークン消費はシングルスレッドのセッション比でおよそ7倍に膨らみ、階層を足すごとに線形ではなく幾何級数的に増える。同ブログは「2ステップの調査に3階層のツリーは要らない」とも書いている（出典: claudefa.st、2026年7月26日アクセス）。実務では2〜3階層に収めるのが現実的、という相場観はコミュニティでも繰り返し語られてきた。

なお同ブログが独自に集計したところでは、機能登場時のコミュニティの反応は肯定が約64%、否定が約35%と割れていたという（母数と集計方法は同ブログの記載による）。

つまりデフォルト値の3は、実務で推奨されてきた運用の上限をそのまま既定値にした、という読み方ができる。禁止でも野放しでもない位置だ。6月2日のサブエージェント暴走障害から数えて2度目の調整で、ようやく落ち着き先が見えてきた印象を持っている。

ヘッドレス運用への影響

v2.1.219には、ストリームJSON出力（--output-format stream-jsonで得られる機械可読なログ）への入れ子サブエージェント転送も入った。--forward-subagent-textを指定していれば、深さ2以上で起動したサブエージェントの出力も、それを起動したAgentツールのtool_use idに紐づいて流れてくる（出典: Claude Code公式チェンジログ）。多段のエージェント構成をCIのログに残したい場合、これまでは深い階層の作業が見えなかった。監査ログを取る前提で自動化を組んでいるなら、この1行の価値は小さくない。

Claude Opus 5がCLIのデフォルトOpusに：ファストモードの損得

v2.1.219のもう一つの目玉が、claude-opus-5の追加だ。デフォルトのOpusモデルがOpus 5になり、コンテキストは100万トークン、ファストモードは100万トークンあたり入力10ドル・出力50ドル（税別）で提供される。あわせてOpus 4.7はファストモードの対象から外れ、/fastはOpus 5とOpus 4.8に適用される（出典: Claude Code公式チェンジログ）。

通常モードの料金は100万トークンあたり入力5ドル・出力25ドル（税別）で、Opus 4.8から据え置きだ。ファストモードは基本料金の2倍で「デフォルトの約2.5倍の速度」とされている（出典: Anthropic公式発表、2026年7月24日）。モデル自体の詳細はOpus 5の完全ガイドに、ファストモードの仕組みはOpus 4.7時代の解説記事にまとめてある。

ここで計算が合う人と合わない人が分かれる。2倍払って2.5倍速くなるなら、時間あたりの単価はむしろ下がる。人が画面の前でスピナーを見ている対話的な作業やライブのエージェント運用では、エンジニアの時間単価がトークン代を上回るケースが多いので割に合う。逆に夜間バッチや非同期の処理では、速く終わっても誰も待っていないため、追加のコストは何も買っていないことになる（出典: claudefa.st、2026年7月26日アクセス）。

「OK」と返すだけで36,000トークン

コストの話でもう一つ。クラスメソッドの石川氏は、v2.1.219のリリース直後にOpus 5をヘッドレスモード（対話画面を開かず、コマンドから一発で実行する使い方）で実測している。「OK」と4トークン返すだけの単純なプロンプトでも、キャッシュの書き込みと読み込みを含めた使用量は合計およそ36,000トークンに達した。実行時間は1,671〜1,777ミリ秒、コストは約0.018ドルだったという（出典: DevelopersIO 石川氏、2026年7月25日）。同氏の検証環境での測定値であり、CLAUDE.mdの分量やツール構成によって前提のトークン数は大きく変わる点は踏まえておきたい。

それでも桁感の目安にはなる。単純な往復1回で約0.018ドル。仮に1日200回のやり取りを重ねれば概算で3.6ドル前後、ファストモードならその倍という規模になる。自分の使用頻度に掛け算しておくと、月額の見当がつく。

同氏の結論はこうだ。Opus 5を常用する前に、自分のワークロードのコストプロファイルをヘッドレスモードで測っておいたほうが予算の見積もりを立てやすい。さらに踏み込んで、「モデルの追加以上に、周辺の設定やデフォルト値の変更のほうが実務へのインパクトは大きいかもしれない」とも書いている。具体名として挙がっているのが、サンドボックスのallowlist設定と、サブエージェントの入れ子デフォルトが1から3に変わったことだ。

見出しはモデル名が持っていくが、請求書に効くのはデフォルト値のほうだ、という指摘だと受け取っている。

Anthropicの発表側の事例も一つ挙げておく。ある取引会社のエンジニアは、従来のモデルでは詳細な計画を与えても完遂できなかったマーケットデータフィードの実装を、Opus 5との1セッションで終えたという。検証用のライブフィードがなかったため、Opus 5は自前のテストハーネスを組んで自分の出力を確かめたと記録されている（出典: Anthropic公式発表、2026年7月24日）。ベンダー発の成功事例なので割り引いて読む必要はあるが、長時間の自律作業で自己検証の挙動が強化されたという主張とは整合する。

/code-reviewがバックグラウンドへ、/deep-researchは手動起動のみに

7月22日のv2.1.218は37件の変更を含む。実務で効くのは次の2つだ（出典: Claude Code公式チェンジログ）。

/code-reviewがバックグラウンドのサブエージェントとして走るようになった。レビューは自分のコンテキストウィンドウを持つため、会話がレビュー結果で埋まらない。前出の石川氏は、レビューと実装を並行して回す人にとって影響の大きい変更だと評価している。大きなレビューが会話のコンテキストを圧迫しなくなるためだ（出典: DevelopersIO 石川氏、2026年7月23日）。

/deep-researchは手動で呼んだときだけ起動するようになった。Claudeが自分の判断で走らせることはなくなる。同氏はこれを「トークン消費を制御したい人には歓迎すべき変更」と位置づけている。重いリサーチが予期せず立ち上がらなくなる、という理由だ（出典: DevelopersIO 石川氏、2026年7月23日）。

Auto Modeまわりも変わった。危険なrm、バックグラウンド実行の&、疑わしいWindowsパスのチェックが権限ダイアログを開かなくなり、Auto Modeの分類器（コマンドの危険度を判定する仕組み）が判定を引き受ける。Auto Modeと併用したプランモードでも、静的解析で読み取り専用と証明できないBashコマンドについて確認を求めなくなった。石川氏は「投げっぱなしで走らせる使い方をしている人には影響が大きい」と表現している（出典: DevelopersIO 石川氏、2026年7月23日）。作業の中断が減るのは確かだが、Auto Modeの権限設計を理解しないまま使うと、判断を分類器に丸投げすることになる点は意識しておきたい。

サンドボックスとフックの信頼境界

セキュリティ関連の変更が2つある（出典: Claude Code公式チェンジログ）。

v2.1.219でsandbox.network.strictAllowlistが追加された。サンドボックス（コマンドの実行範囲を隔離する仕組み）で走るコマンドについて、allowlist（通信を許可するホストの一覧）に載っていない宛先への接続を、確認なしで拒否する設定だ。従来は都度プロンプトが出ていたところを、拒否で固定できる。承認疲れを突いて意図しない外部通信が通ってしまうリスクを、設定で潰せるようになった。

もう一つがv2.1.218の修正だ。エージェント定義ファイル（サブエージェントの役割やフックを記述するMarkdownファイル。冒頭のメタデータ部分をフロントマターと呼ぶ）に書かれたフックが、未信頼のフォルダから実行されてしまう問題が塞がれた。今後はエージェントファイルが置かれたフォルダ自体がワークスペースの信頼を得ていることが実行の条件になる。外部から取得したリポジトリを開いた際に、同梱されたエージェント定義のフックが走るという経路が閉じた形だ。GitHubで拾ったエージェント定義やプラグインを気軽に試す運用をしている人ほど、この修正の意味は大きい。

サンドボックスの話は、先週のセキュリティ修正から地続きだ。エージェントに与える自由度が上がるほど、境界の定義が効いてくる。機能追加より地味だが、ここが崩れると他が全部無意味になる。

地味に効く修正：左矢印キーでの会話消失とWindowsのパス化け

今週の修正で、環境を問わず全員に関係するものを2つ。

まず、左矢印キーを押しただけで会話が取り消し不能に破棄される問題が修正された。編集直後の押下は確認を求めるようになり、エージェント画面でEscを押すとバックグラウンドに送った会話へ戻れる（出典: Claude Code公式チェンジログ）。地味だが、一度やられると精神的な被害が大きい種類の事故だ。

もう一つはWindows環境の不具合だ。\uで始まるセグメントを含むパス（C:\Users\unicornのような）が、ツール入力の中でCJK文字に化けてしまい、対象のファイルにアクセスできなくなっていた（出典: Claude Code公式チェンジログ）。バックスラッシュ+uがUnicodeエスケープとして解釈された結果だと見られる。ユーザー名の綴り次第で発症するため、原因にたどり着きにくい類のバグだ。非ASCII文字を含むパスまわりの修正は直近のバージョンでも続いており（v2.1.216ではBashコマンドの非ASCII文字解析が修正されている）、日本語環境で使う場合はこの領域の更新を追っておく価値がある。

その他の変更点

今週入ったもののうち、運用に関係しそうなものを列挙する。該当する機能を使っていなければ読み飛ばして構わない（出典: Claude Code公式チェンジログ）。

DirectoryAddedフック: /add-dirやSDKのregister_repo_rootでセッション途中に作業ディレクトリが追加されたときに発火する
動的ワークフローのサイズ既定値: 動的ワークフロー（Claudeが実行時にサブエージェントの構成を自分で決める仕組み）のデフォルトが「15エージェント未満を目安」の中サイズになった。/configの Dynamic workflow size から変更でき、設定ファイルにworkflowSizeGuidelineを書いた場合は/config側の行が隠れる。数百のエージェントを束ねる運用をしている場合は明示的な設定が要る
MCPエラーの可視化: claude mcp listと/mcpで接続失敗時のHTTPステータスとエラー本文が表示される。設定値の前後に不可視の空白がある場合の警告も追加
ヘッドレスのmcp_server_errors: 設定検証で読み飛ばされた--mcp-configエントリがstream-jsonの初期化イベントに載る
claude -pの出力欠落を修正: ストリーム途中のAPIエラーでターンが落ちたとき、生成済みの回答が消える問題
/modelの表示修正: 統合されたOpusの行が「Opus (1M context)」と正しく表示されるようになった
メモリリーク修正（v2.1.217）: 切り詰められたMCPツール出力が、セッション終了まで元の全文をメモリに保持し続けていた
バックグラウンドセッションの隔離修正（v2.1.217）: シンボリックリンクされた作業ディレクトリを正規化しておらず、セッションがワークスペース外へ出られる可能性があった
v2.1.220（7月25日）: バグ修正と安定性の改善のみ

電脳狐影の判断：深さ3のまま使う。ただし予算上限は先に入れる

自分ならどうするか。結論は「更新は即、入れ子は深さ3のデフォルトのまま使う。ただし--max-budget-usdを先に設定する」だ。

まず更新については、見送る理由が見つからない。エージェント定義フックの信頼境界の修正だけで十分だし、Windowsパスの不具合も放置する理由がない。ただし多段のエージェント構成を組んでいる場合は、後述のチェックを済ませてからにしたい。

入れ子を無効に戻すかどうかは少し考えた。3日で方針が変わったこと自体、この領域の最適解がまだ固まっていないことの表れに見えるからだ。それでもデフォルトのまま使うと決めたのは、暴走の実害が出た6月時点と今とでは安全弁の数が違うからだ。同時実行20件のキャップ、セッションあたりの起動回数上限、そして予算上限によるバックグラウンドエージェントの停止。深さだけを1に絞るより、上限を多層で効かせるほうが設計として素直だと考えている。

ただし、これは--max-budget-usdを設定していることが前提だ。前掲のGistの事例で怖いのは、金額の大きさより「CLAUDE_CODE_FORK_SUBAGENT=0を設定したはずなのに効いていなかった」という点にある。PMとしての理解では、この手のシステムで信用できるのは「深さの宣言」より「金額でのハードストップ」のほうだ。宣言は解釈の余地があるが、金額は解釈しようがない。深さを制限したから安心、という考え方は捨てたほうがいい。

設定自体は数行で済む。

# セッション単位で予算の上限を切る
claude --max-budget-usd 5

# 入れ子を止める・同時実行数を変える場合（~/.zshrc などに書けば永続化）
export CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1
export CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS=20

Opus 5のファストモードは、当面は対話的な作業に限って使う。夜間に回す記事生成や定期処理では通常モードのままにする。時間あたり単価の話は理屈としては納得しているが、自分の手元のワークロードで実測したわけではない。石川氏が書いていたとおり、まずヘッドレスで自分のコストプロファイルを測るのが先だ。ここは正直に、まだ判断材料が足りていない。

アップデート前に確認すること

現在のバージョンはclaude --versionで確認できる
7月21日〜23日に更新して「エージェントが突然起動しなくなった」まま放置している場合、v2.1.219以降への再更新だけで解消する可能性が高い
同時実行は20件が上限。大規模なマルチエージェント運用はCLAUDE_CODE_MAX_CONCURRENT_SUBAGENTSで事前に引き上げる
動的ワークフローのデフォルトが「15エージェント未満」の目安に変わった。大規模構成は/configまたはworkflowSizeGuidelineで明示する
Opusのデフォルトモデルが変わった。Opus 4.8に固定したい場合は/modelで明示的に選ぶ
チームで使っている場合は、想定するネスト深さと同時実行数をプロジェクトのCLAUDE.mdに明記しておく。更新タイミングのズレによる「自分の環境だけ動かない」を防げる
外部から取得したエージェント定義やプラグインを使っている場合、v2.1.218のセキュリティ修正を適用するまではフックの実行経路に注意する

まずはclaude updateで最新版にした上で、--max-budget-usdを一度設定してみてほしい。上のコマンドをコピーするだけなら5分程度で終わるはずだ。サブエージェントを多段で組んでいる人は、下記の解説を読んでから深さの設定を決めると判断しやすい。

入れ子サブエージェントの解説を読む

本記事の情報は2026年7月26日時点のものです。料金はすべて米ドル建ての税別表記で、為替や改定により変動する可能性があります。Claude Codeの機能・仕様は毎週のように更新されるため、最新情報はClaude Code公式チェンジログを参照してください。英語圏の発言の引用は筆者による日本語訳です。本記事はAnthropicとの提携関係に基づくものではなく、独立した編集判断によって執筆しています。