はじめに
2026年10月17日時点の最新リリース Claude Code v2.1.302 には、CI や自動化スクリプトに影響しうる変更が含まれています。
- サードパーティプロバイダで
claude -p/ Agent SDK の既定権限モードが default に変わる場合がある - fork サブエージェントが
claude -p・Agent SDK・デスクトップ・VS Code でも既定で有効になる - 単体版 Claude Design（claude.ai/design）が2026年12月14日までに終了するという告知
特に1つ目は、暗黙の auto モードを前提にした非対話実行が、権限確認で止まる可能性があります。この記事では影響の大きい変更を中心に、誰が何をすべきかを整理します。
📌 影響を受ける人
- Bedrock / Vertex / LLM ゲートウェイなど、サードパーティプロバイダで
claude -pや Agent SDK を CI・バッチで動かしている人/design-syncを使うデザイン連携ワークフローを持つ人claude -p/ Agent SDK でサブエージェントを使っている人- Hooks に prompt / agent フックを大量に登録している人
変更の全体像
| 重要度 | 変更 | 要対応 |
|---|---|---|
| high |
claude -p / Agent SDK の既定権限モードが条件次第で default に |
必要 |
| high | fork サブエージェントが全環境で既定有効 | 確認推奨 |
| high | 単体版 Claude Design が2026-12-14に終了 | 必要 |
| medium | サブエージェントの実行形態の統一 | 確認推奨 |
| medium | prompt/agent フックの同時実行上限12件 | 該当者のみ |
変更内容
1. 既定権限モードが default になる（high）
⚠️ Breaking Change
権限モードを指定していないclaude -pと Agent SDK のセッションが、条件を満たすと default モードで始まります。
対象は次の環境です。
- サードパーティプロバイダ上で利用している
- かつ、テレメトリがオフの環境、または新規インストールの環境
従来 auto モードで動いていたスクリプトが、ツール実行のたびに権限確認で止まるおそれがあります。非対話実行では確認に答える人がいないため、ジョブが進まなくなります。
対処は --permission-mode auto を明示することです。
2. fork サブエージェントが全環境で既定有効（high）
ターミナルでは以前から既定で有効だった subagent_type: "fork" が、次の環境でも既定で有効になりました。
claude -p- Agent SDK
- デスクトップアプリ
- VS Code
無効にするには環境変数 CLAUDE_CODE_FORK_SUBAGENT=0 を設定します。なお claude mcp serve では fork は提供されません。
3. 単体版 Claude Design の終了（high）
単体版 Claude Design（claude.ai/design）は 2026年12月14日までに提供終了します。/design-sync と /design-login を実行すると、終了の通知が表示されます。
関連して、クラウドセッションで /design consent や /design revoke が失敗した際に、そこでは使えない /design-login を案内していた問題も修正されました。現在は claude.ai/design/settings が案内されます。
4. サブエージェントの実行形態（medium）
- デスクトップ・VS Code でも、メイン会話のサブエージェントは常にバックグラウンドで実行（ターミナルと同じ）
-
claude -p、Agent SDK、デスクトップ、VS Code では、サブエージェント自身が呼ぶ Agent は既定でフォアグラウンド実行
| 呼び出し元 | 実行形態 |
|---|---|
| メイン会話 → サブエージェント | 常にバックグラウンド |
| サブエージェント → Agent（ネスト） | 既定でフォアグラウンド |
5. フック同時実行数の制限（medium）
同一イベントの prompt フック・agent フックは同時に最大12件までです。13件目以降は前のフックの完了を待ちます。大量フックを並列前提で構成している場合、処理時間が延びることがあります。
6. 新機能
| 機能 | 内容 |
|---|---|
CLAUDE_CODE_AUTO_MODE_MODEL |
クライアント側 auto モード分類器のモデルを指定（サーバー側 auto モードには影響しない） |
| Idle compaction 設定 |
/config でアイドル時コンパクションのオン/オフを切替。実行後の通知に無効化方法も表示 |
| サーバー側 auto モードの改善 | 会話が長すぎても、チェック対象のツール呼び出しを全拒否せず、会話をコンパクションして継続 |
7. 主な修正・改善
-
MCP: プロトコル 2026-07-28 で
resultType・ttlMs・cacheScopeを省略するサーバーでツールが出ない／全呼び出しが失敗する問題を修正 -
Vertex / Bedrock: セッション途中の切り替えで
diagnostics: Extra inputs are not permittedが出る問題を修正。接頭辞付き Opus 4/4.1（例:anthropic/claude-opus-4-1）で/autocompactと/effortの設定が別モデルに保存される問題も修正 - Read ツール: 128MB を超える画像ソースは読み込みを拒否
- プロンプトキャッシュ: ToolSearch での再ロード時やコンパクション後のキャッシュミスを修正
- 課金: クレジット払い専用モデルでプロンプト候補生成がクレジットを消費していた問題を修正
- Windows: PowerShell ツールの不具合2件と、exFAT/FAT32 ドライブ上で全ファイル書き込みが拒否される問題を修正
- プラグイン: 多数有効時の起動を高速化（特に Windows）。git の reftable 環境での不具合も修正
- クラウドセッション／ルーティン: スケジュール実行が途中失敗後に1時間以上経ってから最初からやり直され、作業が重複する問題を修正。実行が始まらなかった理由を示すバナーを追加
- Claude Tag（Slack）: 表示、画像添付（HEIC/SVG/TIFF/BMP）、DM、権限、リンク整形など9件を修正。管理設定は4タブ（Bundles / Connectors / Skills and plugins / Channels）に再編
-
OpenTelemetry:
tool_decisionイベントのclassifier_category欠落と、属性数上限が低い環境での主要属性の脱落を修正 -
その他: worktree 分離が git 2.56 以降で失敗する問題、VS Code 拡張の表示・MCP サインイン・
@browserバナーの不具合なども修正
影響と対応
優先順位は次のとおりです。
- 非対話実行の権限モードを明示する（最優先）。CI のジョブが止まる前に対応してください。
-
Claude Design 依存の洗い出し。
/design-syncを使うワークフローがあれば、終了日（2026-12-14）までに移行計画を立てます。 -
fork の挙動確認。
claude -pや Agent SDK でサブエージェントを使っているなら、fork が選ばれても問題ないか確認します。不要ならCLAUDE_CODE_FORK_SUBAGENT=0で無効化できます。 - フック構成の確認。同一イベントに13件以上の prompt/agent フックがあるなら、待ち時間の増加を見積もります。
💡 Tips
各変更には CLAUDE.md への追記が提案されています。次のように書いておくと、チームや後任が迷いません。
## 非対話実行 / 権限モード
- サードパーティプロバイダで claude -p または Agent SDK を使う場合、
auto が必要なら --permission-mode auto を明示する
## サブエージェント運用
- fork サブエージェントは全環境で既定有効。無効化は CLAUDE_CODE_FORK_SUBAGENT=0
- claude mcp serve では fork は提供されない
- メイン会話のサブエージェントは全環境でバックグラウンド実行、
ネストした Agent 呼び出しは既定でフォアグラウンド実行
## Hooks
- prompt/agent フックの同時実行は同一イベントあたり最大12件
## 環境変数
- CLAUDE_CODE_AUTO_MODE_MODEL: クライアント側 auto 分類器のモデル指定
（サーバー側 auto モードには適用されない）
## デザイン連携
- 単体版 Claude Design は 2026-12-14 に終了。/design-sync を使う
ワークフローは移行計画が必要
コード例
権限モードの明示
Before（権限モード未指定。条件次第で default 開始になり、権限確認で止まるおそれ）
claude -p "テストを実行して失敗を修正して"
After（auto を明示）
claude -p --permission-mode auto "テストを実行して失敗を修正して"
fork サブエージェントの無効化
# fork を使わせたくない場合
export CLAUDE_CODE_FORK_SUBAGENT=0
claude -p "リポジトリ全体を調査してレポートを作成して"
auto モード分類器のモデル指定
# クライアント側 auto 分類器が使うモデルを指定（モデル名は環境に合わせて置き換え）
export CLAUDE_CODE_AUTO_MODE_MODEL="<model-name>"
claude -p --permission-mode auto "依存関係を更新して"
CLAUDE_CODE_AUTO_MODE_MODELはクライアント側の分類器にのみ適用され、サーバー側 auto モードのモデルは変わりません。
まとめ
-
最重要: サードパーティプロバイダで
claude -p/ Agent SDK を使い、権限モードを指定していないなら--permission-mode autoを明示する。テレメトリがオフ、または新規インストールの環境が対象です。 -
fork サブエージェントが
claude -p・Agent SDK・デスクトップ・VS Code でも既定有効に。止めたい場合はCLAUDE_CODE_FORK_SUBAGENT=0。 -
単体版 Claude Design は2026年12月14日までに終了。
/design-sync利用者は移行計画が必要です。 - prompt/agent フックは同一イベントあたり同時12件まで。
-
CLAUDE_CODE_AUTO_MODE_MODELと Idle compaction 設定が追加され、MCP・Windows・クラウドセッション・Slack 連携などの多数の不具合も修正されました。
アップデート前後で、自動化スクリプトの権限モード指定と CLAUDE.md の記述を見直しておくと安心です。