Claude Code v2.1.219: Opus 5追加とサブエージェント3階層化を解説

はじめに

2026年7月24日、Claude Code v2.1.219がリリースされました。今回の目玉は2つあります。1つ目は新モデル Claude Opus 5（claude-opus-5）の追加で、Opus選択時のデフォルトモデルになりました。1Mトークンの巨大コンテキストウィンドウに対応し、fast modeの料金は入力$10 / 出力$50 per Mtokです。2つ目はサブエージェントのネスト生成がデフォルトで深さ1から3まで拡大された点です。

これに加えて、MCP接続の診断情報強化、管理者向けのMCP許可リスト解決ロジックの変更（要確認）、claude -p実行時の出力欠落バグ修正など、開発者・運用担当者双方に影響する変更が含まれています。本記事では特に影響度の高い変更を中心に、「何が変わったか」「なぜ重要か」「どう対応すべきか」を整理します。

📌 影響を受ける人

• Claude Code でOpusモデルやfast modeを使っている人
• サブエージェント（Task/Agentツール）を活用した多段オーケストレーションを組んでいる人
• MCPサーバーを組織のmanaged-settingsで許可/拒否リスト管理している人
• claude -p や stream-json でheadless連携している人

変更の全体像

今回のリリースに含まれる変更を、影響領域ごとに整理すると以下のようになります。

大きな流れとしては「モデルのアップグレード」と「エージェントの自律性拡大」が同時に進み、それを支えるMCPの可観測性・堅牢性の改善が入った、というリリースです。

変更内容

影響度の高い変更を中心に、表で整理します。

#	変更	種別	severity	対応要否
1	Claude Opus 5 追加・デフォルト化（1Mコンテキスト、fast mode $10/$50 per Mtok）	新機能	high	✅ 要確認
2	サブエージェントのネスト生成が深さ3まで可能に（デフォルト）	新機能	high	✅ 要確認
3	Opus 4.7 がfast mode対象外に	非推奨化	medium	✅ 要対応
4	managed MCP許可/拒否リストの${VAR}解決元変更	破壊的変更	medium	✅ 要対応
5	MCP接続失敗時にHTTPステータス・エラーテキスト表示	改善	medium	任意
6	headless initイベントにmcp_server_errors追加	新機能	medium	任意
7	claude -pのストリームエラー時の回答欠落を修正	バグ修正	medium	任意
8	sandbox.network.strictAllowlist追加	新機能	medium	任意

モデル比較：Opus 5 / 4.8 / 4.7

モデル	コンテキスト	fast mode対象	備考
Claude Opus 5	1M トークン	✅ ($10 / $50 per Mtok)	新デフォルトOpus
Opus 4.8	従来通り	✅	引き続き利用可能
Opus 4.7	従来通り	❌ 対象外に	fast mode利用者は移行が必要

⚠️ Breaking Change
managed MCPの許可/拒否リストで ${VAR} を使っている場合、これまでは settings ファイルの env から変数が解決されていましたが、今後は起動時の環境変数と**managed-settingsのenv**からのみ解決されるようになりました。settingsファイル側のenvだけに変数を定義していた構成は、展開結果が変わる（＝許可されるはずのホストが拒否される等）可能性があります。

影響と対応

1. Opus利用者はデフォルトモデルの変更を確認
/model でOpusを選択している場合、次回起動時からOpus 5がデフォルトで使われます。CLAUDE.mdやチームの運用ドキュメントでモデル名を明記している場合は更新しましょう。

2. Opus 4.7でfast modeを使っていたチームは移行必須
/fast コマンドはOpus 5とOpus 4.8のみに適用されます。CI/CDやスクリプトでモデルをハードコードしている場合は影響を受けます。

3. サブエージェントのネスト拡大は挙動変化に注意
これまで「サブエージェントはさらにサブエージェントを生成できない」前提で設計していたワークフローがある場合、深さ3までネストが可能になったことで想定外のエージェント階層が生まれる可能性があります。従来の挙動に固定したい場合は環境変数で無効化できます。

4. MCP管理者は許可/拒否リストの動作確認を
managed-settings.json 等で ${VAR} 展開を使っている場合、実際に許可・拒否が想定通り機能するか再検証してください。

コード例

サブエージェントのネスト深さを従来通り(1)に戻す

# デフォルトでは深さ3までネスト生成が可能になったが、
# 従来の挙動（ネスト無効）に固定したい場合は以下を設定
export CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1

sandbox.network.strictAllowlist の設定例

// Before: 許可リスト外へのアクセス時はユーザーに確認プロンプトが出る
{
  "sandbox": {
    "network": {
      "allowlist": ["api.example.com"]
    }
  }
}

// After: 許可リスト外へのアクセスはプロンプトなしで即座に拒否
{
  "sandbox": {
    "network": {
      "allowlist": ["api.example.com"],
      "strictAllowlist": true
    }
  }
}

managed MCP許可リストの${VAR}解決（変更点のイメージ）

// managed-settings.json
{
  "env": {
    "INTERNAL_MCP_HOST": "mcp.internal.corp"
  },
  "permissions": {
    "mcp": {
      "allow": ["${INTERNAL_MCP_HOST}/*"]
    }
  }
}

変更前は各settingsファイルのenvからも${INTERNAL_MCP_HOST}が解決されていましたが、変更後は起動時の環境変数と**managed-settingsのenv**のみが参照されます。一般のsettingsファイルのenvに変数定義を委ねていた場合は、managed-settings.json側かシェルの環境変数に移す必要があります。

headless実行でのMCP設定エラー検知

// stream-jsonのinitイベント例
{
  "type": "system",
  "subtype": "init",
  "mcp_server_errors": [
    { "server": "internal-search", "reason": "invalid config: missing 'command'" }
  ]
}

SDKやCIパイプラインでheadless実行している場合、このフィールドを見ることで「MCPサーバー設定が黙って無視されていた」事態をプログラム的に検知できるようになりました。

まとめ

• Claude Opus 5が新規追加され、Opus選択時のデフォルトになった（1Mコンテキスト、fast mode $10/$50 per Mtok）
• サブエージェントのネスト生成がデフォルトで深さ3まで可能に。従来挙動に戻すにはCLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1
• Opus 4.7はfast mode対象外になったため、利用していたチームはOpus 5/4.8への移行が必要
• managed MCPの許可/拒否リストの${VAR}解決元が変更され、意図しない挙動変化のリスクがあるため要確認
• MCP接続診断の強化やheadlessのmcp_server_errors追加など、運用の可観測性も着実に向上

モデルのアップグレードとエージェントの自律性拡大が同時に進んだリリースです。特にサブエージェントのネスト拡大とMCP許可リストの変更は、既存の運用フローに影響する可能性があるため、アップデート後は一度動作確認を行うことをおすすめします。