Claude Code v2.1.217 の主要アップデート - サブエージェントの上限や挙動の改善を追加
クラウド事業統括本部の石川です。Claude Code の v2.1.217（2026-07-21 公開）がリリースされました。堅実であり、日々の運用効率や操作感を整えてくれるアップデートだと感じます。新機能に関しては、プロンプト入力時の絵文字補完機能を試してみました。
前回のアップデート記事はこちらです。
アップデートサマリー
v2.1.217 では 20 件の変更が入りました。新機能は絵文字ショートコード補完とサブエージェントの同時実行数上限の 2 件で、残りはサブエージェントの実行制御まわりの整備と、Windows・セキュリティ・エンタープライズ設定・アクセシビリティなど広範囲にわたる不具合修正が中心です。
注目のアップデート
サブエージェントの同時実行数に上限を追加（新機能）
同時に実行されるサブエージェント（subagent）の数に上限が追加されました。デフォルトは 20 で、環境変数 CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS で変更できます。これにより、1 つのメッセージが際限なくバックグラウンドエージェントを生成してしまう事態を防ぎます。
サブエージェントを多用する重いタスクを回す方は、既定の同時実行数 20 と CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS での調整を把握しておく価値があると感じます。
サブエージェントがデフォルトで入れ子を生成しなくなった（破壊的変更）
サブエージェントが、デフォルトでは入れ子のサブエージェント（nested subagents）を生成しなくなりました。より深いネストが必要な場合は、環境変数 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH を設定します。デフォルト挙動の変更にあたるため、後述の「破壊的変更」で before/after を対比します。
多段のサブエージェント構成に依存している方は、デフォルトでネストが無効になった点を踏まえ、必要なら CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH の設定を検討するとよいのではないでしょうか。
Windows の自動アップデート失敗による claude.exe 消失を修正（不具合解消）
Windows での自動アップデート失敗により claude.exe が消失し、起動不能になる可能性があった問題が修正されました。アップデートに失敗した場合は、保存しておいた実行ファイルを自動的に復元します。
Windows で自動更新を使っている方にとって、更新失敗で claude.exe が消えて起動不能になるリスクが下がる修正で、地味ながら効いてくる変更だと感じます。
バックグラウンドセッションのワークスペース脱出を修正（セキュリティ）
バックグラウンドセッションの分離処理が、シンボリックリンクされた作業ディレクトリを正規化（canonicalize）していなかった問題が修正されました。この不具合により、セッションがワークスペースフォルダの外に出てしまう可能性がありました。
シンボリックリンクを含む作業ディレクトリでバックグラウンドセッションを回す方は、意図せぬ範囲外アクセスの穴が塞がれた点を確認しておくとよいと感じます。
アップデート内容
新機能
- プロンプト入力に絵文字ショートコードの補完が追加されました。
:heart:で ❤️ が挿入され、:heaのように途中まで打つと候補が表示されます。emojiCompletionEnabled設定で無効化できます。後述の「新機能「絵文字ショートコード補完」を試してみた」をご覧ください。 - 同時に実行されるサブエージェント数に上限が追加されました（デフォルト 20、環境変数
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTSで変更可能）。1 つのメッセージが際限なくバックグラウンドエージェントを生成することを防ぎます。
改善
- トランスクリプト（会話ログ）の書き込みが失敗している場合（ディスク満杯など）や、継承された環境変数によりセッション保存が無効になっている場合に警告が表示されるようになりました。従来は無言でトランスクリプトが失われていました。
- フッターの PR バッジのリンクが、端末のサポート状況を検出できない場合（ssh／tmux 越しなど）でもクリック可能なハイパーリンクになりました。
FORCE_HYPERLINK=0でオプトアウトできます。 - ログイン期限切れの警告が、期限の 5 日前ではなく 3 日前に表示されるよう変更されました。
- frontend-design プラグインの提案チップ（tip）の表示回数が、無制限の繰り返しから生涯 3 回までに制限されました。
セキュリティ
- バックグラウンドセッションの分離処理がシンボリックリンクされた作業ディレクトリを正規化していなかった問題を修正しました。セッションがワークスペースフォルダの外に出てしまう可能性がありました。
修正
- Windows の自動アップデート失敗による claude.exe 消失を修正: アップデートに失敗した場合は、保存しておいた実行ファイルを自動的に復元します。
- 切り詰められた MCP ツール出力のメモリリークを修正: 切り詰め前の完全な結果がセッション終了までメモリに残り続ける問題を修正しました。
- Bedrock 上の Opus 4.8 で自動コンパクトが発動しない問題を修正: あわせて、上限を超えた後に
/compactが失敗する問題も修正しました。 - Claude Desktop で企業向け接続設定が無視される問題を修正: mTLS・TLS 検証・OAuth スコープ・プロキシ設定が無視されていた問題を修正しました。
- 不正な添付エントリで --resume/--continue が失敗する問題を修正: トランスクリプトに不正な添付ファイルエントリが含まれる場合に、
--resume／--continueおよび/resumeが TypeError で失敗する問題を修正しました。 - バックグラウンドシェルが停止できなくなる問題を修正: セッションをバックグラウンドに送った後や、高負荷なマシンでセッションが終了した際に、バックグラウンドシェルが停止できなくなることがある問題を修正しました（特に Windows で顕著）。
- CLAUDE.md/SKILL.md のブレース展開による起動時 OOM を修正:
pathsフロントマターに多数のブレース展開グループが含まれる場合の OOM・停止を修正しました。ブレース展開に予算上限が設けられました。 - --max-budget-usd がバックグラウンドのサブエージェントを停止しない問題を修正: 上限に達すると、新規の生成が拒否され、実行中のバックグラウンドエージェントも停止されるようになりました。
- 地味に嬉しい修正: 思考中のステータス行が数秒ごとに再描画される問題も直り、長い処理を待つときの画面のちらつきが少し減ったように感じます。
- このほか、管理設定のテレメトリ制御・Remote Control のビューアー表示・トランスクリプトプレビューのレイアウトなど、多数の細かな不具合が修正されています。
破壊的変更・非推奨
サブエージェントは、デフォルトの挙動が変わり、入れ子のサブエージェント（nested subagents）を生成しなくなりました。より深いネストが必要な場合は、環境変数 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH を設定します。以下は挙動を示すための設定例です（設定値はネストの深さを表す一例）。
変更後（v2.1.217〜）
# デフォルトでは入れ子のサブエージェントを生成しない
# 深いネストが必要な場合のみ、環境変数で許可する（以下は設定例）
export CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=2
新機能「絵文字ショートコード補完」を試してみた
今回の新機能のうち、すぐ試せる絵文字ショートコード補完を確認してみます。プロンプト入力欄で :heart: と入力すると ❤️ が挿入され、:hea のように途中まで打つと候補が表示されます。emojiCompletionEnabled 設定で無効化できます。
claude で対話セッションを起動して、:he のように途中まで入力すると、絵文字の候補（サジェスト）が表示されます。
最後に
v2.1.217 は新機能としては絵文字補完が目を引く一方、実態はサブエージェントのファンアウト制御と各種不具合修正が主役の堅実な版だと感じます。特にサブエージェントを多段・並列で使う運用をしている方は、同時実行数の上限とネストのデフォルト変更を把握しておくと安心ではないでしょうか。
サブエージェントを多用している方や Windows・エンタープライズ環境で運用している方は、アップデートして試してみてはいかがでしょうか。
参考文献
