Claude Code 2.1.217でSubAgentのネストがデフォルト無効になっていた

Claude Code 2.1.217へのアップデートでSubAgentのネスト機能がデフォルトで無効になった事象について解説しています。仕様変更の背景と、設定方法について説明しており、SubAgentのネスト利用に影響がある内容です。

• Claude Code 2.1.217へのアップデートにより、SubAgent内からさらにSubAgentを呼び出すネスト機能がデフォルトで無効化された。
• SubAgentのネスト機能は、バージョン2.1.172で5段までの制限付きで解禁されていたが、2.1.217でデフォルト無効（オプトイン制）に変更された。
• デフォルト状態では、SubAgent内からAgentツール経由でSubAgentを呼び出すとエラーが発生するが、`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`環境変数を設定することで再度有効化できる。
• 環境変数の値は、ネストできるSubAgentの段数を示し、デフォルトは1（ネスト不可）である。2以上でネストが可能になる。
• AnthropicはSubAgentのネストやスポーン上限（2.1.212）など、機能に対する制限を加えるアップデートを続けており、挙動を制御しきれていない可能性が示唆されている。