■ 結論(2026年11月9日時点)
比べたのは、次の2つです。
・Tembo社のブログ記事「Claude Code Subagents: A 2026 Practical Guide」(2026年5月15日公開と表示)。ここに「サブエージェントは別のサブエージェントを呼べない」と書かれていました。
・2026年11月9日に取得した、Claude Code公式ドキュメントのサブエージェントのページ。
結論として、この2つは合いません。公式は、サブエージェントの定義で 「tools」 に 「Agent」 を入れると、深さの上限の範囲で、そのサブエージェントが自分のサブエージェントを呼べると書いています。
ただし、その記事が間違いだったとは言い切れません。公式の更新記録を読んだ範囲では、記事の公開(5月15日)より後の6月10日に、入れ子を認める変更が入っているからです。
■ 話題を見つけた場所
AI関連の検索で、サブエージェントの解説記事が出てきました。その一つ、ベンダーのブログ記事「Claude Code Subagents: A 2026 Practical Guide」に、制限事項として次の一文がありました。
「No nested subagents. Subagents cannot spawn other subagents.」
記事のURL:https://www.tembo.io/blog/claude-code-subagents
この記事の公開日は2026年5月15日です(ページのデータ上の公開日で確認)。更新日の表示はありません。公式ドキュメントではなく、ベンダーの解説記事です。SNSの投稿は今回特定できていません。
■ 公式ドキュメントで確かめた結果
公式のサブエージェントのページ(2026年11月9日に取得)には、次の趣旨の記述があります。ページのURLは https://code.claude.com/docs/en/sub-agents です。
・サブエージェント定義の 「tools」 に 「Agent」 を入れると、深さの上限が許す間、そのサブエージェントは自分のサブエージェントを呼べる。
・ただし、括弧の中に書く種類の指定リストは無視される。
・深さの上限は、既定ではメインの会話から数えて3層下まで。
・環境変数 「CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH」 に 「1」 を設定すると、入れ子をやめられる。
なお公式は、括弧で種類を絞る書き方(「Agent(種類名)」)は、「claude --agent」 でメインのスレッドとして動かす場合にだけ効く、と別に書いています。解説記事の主張を「通常のサブエージェントではなく、メインのスレッドの話だったのでは」と読めるかを確かめましたが、公式のこの記述からは、そう読む根拠は見つかりませんでした。
■ いつ変わったのか
公式のリリースノート(GitHub)には、入れ子に関する変更が次のように残っています。年はページ上の日付の属性で2026年と確認しました。
・2.1.172 / 2026年6月10日 / サブエージェントが自分のサブエージェントを呼べるようになった(最大5層)。https://github.com/anthropics/claude-code/releases/tag/v2.1.172
・2.1.217 / 2026年7月21日 / 入れ子を既定でやめる。環境変数で許可できる。https://github.com/anthropics/claude-code/releases/tag/v2.1.217
・2.1.219 / 2026年7月24日 / 入れ子を既定で最大3層にする(それまでは1)。環境変数に1を設定すると無効化できる。https://github.com/anthropics/claude-code/releases/tag/v2.1.219
読んだ範囲では、入れ子の解禁は2.1.172が最初です。ただし2.1.118〜171のリリースノートは読んでいないので、「最初」と言い切れるのは読んだ範囲までです。
記事の公開日(5月15日)は、読んだ範囲で最初の解禁(6月10日)より前です。そのため、記事は公開時点では正しかった可能性があります(読んでいない版の間に別の変更があった可能性は残ります)。「古い記事」と呼ぶより、「公開後に仕様が変わったかもしれない」と呼ぶほうが正確です。
仕様は短い間に何度か変わっています。入れ子が「できる」かどうかは、使っているClaude Codeの版で変わりうることになります。
■ 実際に動かしたか
動かしていません。ここまでは公式ページとリリースノートの記述に基づきます。
■ 受講生・読者への使い方
1. 解説記事は、公開日を見てから読む。AI関連の仕様は数か月で変わる。
2. 迷ったら、公式ドキュメントの現行ページと、自分の版(「claude --version」)を見比べる。
3. 「tools」 を省略すると、公式の表では「サブエージェントが使える道具をすべて継承する」と書かれています。省略しても、深さの上限の範囲で入れ子になりうると読めますが、実際には動かして確かめていません。特定のサブエージェントだけ入れ子にさせたくないときは、その 「tools」 の一覧から 「Agent」 を外すか、「disallowedTools」(使わせない道具の欄)に加える、と公式に書かれています(実際に動かして確かめてはいません)。確実に止めたい場合は、環境変数 「CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH」 に 「1」 を設定する方法が公式にあります。なお、「1」 にしても1段の入れ子が残るという未確認の報告もあります(二次情報で、原文は確認できていません)。
用語の補足
・サブエージェント:Claude Codeが別の担当として呼び出す小さな作業役です。
・入れ子:サブエージェントが、さらに別のサブエージェントを呼ぶことです。
・「tools」:その担当が使える道具の一覧を書く欄です。
・メインのスレッド:あなたと直接会話している本体側のことです。
・環境変数:パソコンやコマンドの動き方を、外から設定する値のことです。
・リリースノート:版ごとの変更点を書いた公式の記録です。
■ 出典と確認状況
・Tembo社の記事に「Subagents cannot spawn other subagents」とあり、公開日は2026年5月15日 / 【裏取り】 / https://www.tembo.io/blog/claude-code-subagents を原文で確認(公開日はページの構造化データの datePublished。更新日の表示なし)
・公式は 「tools」 に 「Agent」 を入れると入れ子が可能と記述 / 【裏取り】 / https://code.claude.com/docs/en/sub-agents (2026年11月9日に原文で確認。ページ内に更新日の表示なし)。逐語:「In a subagent definition, listing Agent in tools lets that subagent spawn subagents of its own while the depth limit allows it」
・括弧の種類指定は無視される/「Agent(種類名)」 は 「claude --agent」 のメインスレッドだけ / 【裏取り】 / 同上
・既定の深さは3層、環境変数に1で無効化 / 【裏取り】 / 公式ドキュメントと、リリース2.1.219の記述を原文で確認
・2.1.172で入れ子が解禁(最大5層)、日付は2026年6月10日 / 【裏取り】 / GitHubリリースページを原文で確認(年は日付の属性で確認)
・2.1.217で既定オフ(7月21日)、2.1.219で既定3層(7月24日) / 【裏取り】 / 同上
・2.1.172は読んだ範囲で最初の解禁(2.1.118〜171は未読) / 【推測】 / 確かめ方:2.1.118〜171のリリースノートを読む
・「記事は公開時点では正しかった可能性がある」 / 【推測】 / 公開日と6月10日の前後関係からの判断。記事が当時どうだったか、読んでいない版で別の変更があったかは未検証
・公式の表に「「tools」 を省略すると、サブエージェントが使える道具をすべて継承する」とある / 【裏取り】 / https://code.claude.com/docs/en/sub-agents の frontmatter の表(2026年11月9日に原文で確認)。逐語:「Inherits every tool available to subagents if omitted.」
・入れ子をさせたくないサブエージェントは、「tools」 の一覧から 「Agent」 を外すか 「disallowedTools」 に加える / 【裏取り】 / https://code.claude.com/docs/en/sub-agents (2026年11月9日に原文で確認)。逐語:「To keep one subagent from spawning while nesting is on, such as a reviewer that should stay read-only, omit Agent from its tools list or add it to disallowedTools.」
・「tools」 を省略しても入れ子になりうる / 【推測】 / 上の記述からの読み。確かめ方:「tools」 を省略したサブエージェントで実際に動かす
・環境変数を1にしても1段残る報告 / 【伝聞】 / 検索結果の見出しのみ。原文未開封
・実際に入れ子で動かした結果 / 該当なし / 実測していない
▼ 確認できていないこと
・公式ドキュメントは、入れ子に関する記述の箇所を原文で照合した。全文の通読ではない。
・リリースノートは、2.1.172・217・219を原文で確認した。2.1.118〜171と、2.1.220以降は未読。
・他の解説記事や報告(issue)の原文、X・Reddit・国内サイトの直接検索は未実施。
・公式ページの更新日は不明。