
Claude Code v2.1.328 の主要アップデート - mcp_tool フックの onFailure 追加と /code-review の報告範囲変更
クラウド事業統括本部の石川です。Claude Code の v2.1.328 が 2026 年 11 月 18 日に公開されました。今回の変更には、/code-review の報告範囲の変更や、mcp_tool フックへの onFailure の追加など、普段の使い方やフックの設定に関わるものが含まれています。
前回のアップデート記事はこちらです。
アップデートサマリー
v2.1.328 では 144 件の変更が入りました。本記事の分類では修正 91 件、改善 24 件、新機能 12 件、パフォーマンス 7 件、セキュリティ 6 件、破壊的変更・既定動作の変更 4 件です。
領域別に見ると、Code Mode に関する変更が 22 件、self-hosted runner に関する変更が 26 件、Bedrock などのサードパーティプロバイダーに関する変更が 13 件あります。
注目のアップデート
mcp_tool フックの onFailure
mcp_tool フックで "onFailure": "block" を指定できるようになりました。command フック・HTTP フックと同様に、フックの呼び出しが失敗すると、フックを起動したアクションをブロックします。onFailure を指定しない場合の動作は変わらず、フックの呼び出しが失敗してもアクションは実行されます。
MCP サーバーでポリシーチェックを実装している組織は、フックの呼び出しが失敗したときの扱いを明示的に決められるようになったと感じます。
/code-review の報告範囲
ほとんどのモデルで、/code-review がバグと CLAUDE.md 違反だけを報告するようになりました。再利用・簡素化・効率化のクリーンアップには /simplify を実行します。あわせて、各指摘に Important / Pre-existing / Nit のいずれかが付き、各サマリーの最後に修正案が示されるようになりました。公式ドキュメントでは、/simplify はクリーンアップの観点だけでレビューし、修正を適用するコマンドと説明されています。
これまで /code-review で再利用・簡素化・効率化の指摘も受け取っていた方は、修正まで適用される点に注意しつつ /simplify をあわせて実行する手順に変えるとよいと感じます。
zsh で = で始まる単語を含むコマンドが止まる問題を修正
zsh で、echo ==== や [ a == b ] のように = で始まる単語があると、Bash コマンドが "not found" エラーで止まる問題が修正されました。修正に伴い、=cmd はコマンドのパスに展開されなくなります。
zsh 環境では、区切り線の出力や [ a == b ] の比較を含むコマンドを書き換えずに実行できるようになるため、目立たないながらも助かる修正だと感じます。
スケジュール済みタスクが消える問題を修正
サードパーティプロバイダー利用時、またはテレメトリやフィーチャーフラグを無効にしている場合に、スケジュール済みタスクのファイルを読み込めないときにタスクを保存すると、プロジェクトのほかの保存済みタスクが消える問題が修正されました。また、ファイルに記述ミスのあるタスクが、次にファイルを保存したときに削除される問題も修正されています。
サードパーティプロバイダーやテレメトリを無効にした環境でスケジュール済みタスクを使っている方は、タスクの消失を避けるために早めにアップデートしておくのがよいと感じます。
deniedMcpServers の claude.ai コネクター指定の適用範囲
claude.ai <name> 形式の deniedMcpServers エントリが、クラウドセッションと self-hosted runner セッションのコネクターにも適用されるようになりました。
deniedMcpServers で claude.ai のコネクターを禁止している管理者は、クラウドセッションや self-hosted runner でも同じ設定が適用されるようになるため、適用範囲を改めて確認しておくとよいと感じます。
Bedrock などの Opus 4.6 / Sonnet 4.6 の auto mode 対応
Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude apps gateway で、Claude Opus 4.6 と Sonnet 4.6 が auto mode に対応しました。権限モードを指定していない対話セッションは auto mode で開始します。
あわせて、サードパーティプロバイダー上の Opus 4.6 / Sonnet 4.6 では、新しいモデルと同様に、plan モードと Bash の権限確認プロンプトが auto mode を使用・提示するようになりました。disableAutoMode で両方をオフにできます。また、ベータを拒否するゲートウェイを経由する環境で CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS を設定していると、Claude Desktop 以外で auto mode が毎ターン失敗する問題も修正されています。
なお、執筆時点(2026 年 11 月 19 日)の公式ドキュメント「Choose a permission mode」では、Bedrock などで auto mode を使えるモデルは Sonnet 5 以降と Opus 4.7 以降などと記載されており、Opus 4.6 / Sonnet 4.6 は含まれていません。
Bedrock 経由で Opus 4.6 / Sonnet 4.6 を指定して使っている組織では、アップデート後に対話セッションの開始モードが変わるため、権限モードの運用ルールと合っているかを確認しておくとよいと感じます。
auto mode の開始モード、Code Mode の UserPromptSubmit フック、managed の PostToolUse フックの変更は、既存の設定や運用に影響します。後述の「破壊的変更・既定動作の変更」で変更前後を比較します。
アップデート内容
新機能
CLAUDE_CODE_DISABLE_DEFERRED_TOOL_RESUMEを追加しました。フックが保留(defer)したツール呼び出しを、claude -p --resume/--continueで実行させないようにホスト側で制御できます- OpenTelemetry のエクスポーターにエンドポイントがなく、データが失われる可能性が高い場合に、
/statusとclaude doctorで通知を表示するようになりました - 権限確認をスキップするセッションから送ったメッセージが、クラウドセッション側で保留・破棄される可能性がある場合に警告を表示するようになりました
- Claude Code を組み込むアプリから、ポリシープラグインの
allowManagedModsOnlyオプションを有効にできるようになりました。管理者の managed settings が引き続き優先されます - Claude apps gateway で、ポリシーの
maxEffortLevelが有効な effort レベルでない場合に起動時の警告を表示するようになりました - [VSCode] ほかのセッションからのメッセージが保留されたときに、許可を設定できる設定ファイルへのリンク付きで通知を表示するようになりました
- Self-hosted runner の追加
--capacity 1のとき、リポジトリに使うフォルダを--repository-folderで指定できるようになりました(ベースフォルダ配下のパスの代わり。シンボリックリンクは指定不可)- ホストの settings.json に、セッションが無視するデフォルト権限モードが設定されている場合に起動時の警告を表示するようになりました
claude self-hosted-runner orchestratorに--hook-labelを追加し、指定したセッションラベルをspawn-runnerフックに渡せるようになりましたclaude --environmentに--metadata key=valueを追加し、spawn-runnerフック向けにセッションへラベルを付けられるようになりました- オーケストレーターの
/metricsにclaude_code_self_hosted_orchestrator_session_queue_wait_by_reason_secondsを追加し、再開したセッションと新規セッションの待ち時間を区別できるようになりました - Anthropic がセッション用のランナー起動を断念した回数を原因別に数えるメトリクス
claude_code_self_hosted_orchestrator_sessions_given_up_totalを追加しました
セキュリティ
mcp_toolフックで"onFailure": "block"を指定できるようになりました。フックの呼び出しが失敗するとアクションをブロックしますclaude.ai <name>形式のdeniedMcpServersエントリが、クラウドセッションと self-hosted runner セッションのコネクターにも適用されるようになりました- PermissionRequest フックがシェルコマンドをサンドボックス除外対象のコマンドに書き換えた場合、そのコマンドはサンドボックスの外で実行されるようになりました
sandbox.failIfUnavailableを設定していない場合に、起動できないサンドボックスの報告方法を変更しました。次にサンドボックス内で実行する Bash コマンドが拒否され、このセッションではサンドボックスがオフであることが示されます- Self-hosted runner: ラッパースクリプトが、セッション本体の
claudeの起動前または終了後に実行するclaudeでは、Anthropic 管理の git を使えなくなりました - Self-hosted runner: 設定で Claude の GitHub ツールを名前で制限している環境では、組み込みの
gh apiがデフォルトでオフになりました。--use-anthropic-gh trueで有効にできます
改善・パフォーマンス
- Code Mode(公式ドキュメントでは実験的機能と位置付けられています)
- auto / bypass-permissions モードで、ほとんどのスクリプトの後に入っていた 0.75 秒の待機をなくしました
- スクリプトが実行中のコマンドとその出力を、実行中に表示するようになりました
- MCP サーバーを使う新しいセッションのプロンプトキャッシュを改善しました。サーバーが接続中のときと、サーバーの一覧が変わったときに Claude に伝えるようになりました
- ツールの説明を短くし、トークン使用量を減らしました
- 何も変更しない編集でスクリプトが止まらなくなり、失敗した編集については一致した箇所または最も近い箇所が Claude に伝わるようになりました
- スクリプトが失敗したときに、まだ実行中だったツール呼び出しが Claude に伝わるようになりました
- auto / bypass モードで、開発サーバーを
/tasksに表示されるバックグラウンドタスクとして起動するよう Claude に指示するようになりました - Windows: スクリプトのシェルコマンドは Git Bash で実行されることと、PowerShell では同名の関数ではなくエイリアスが実行されることを Claude に伝えるようになりました
- ほとんどのモデルで、
/code-reviewが各指摘に Important / Pre-existing / Nit のいずれかを付け、各サマリーの最後に修正案を示すようになりました。問題がなかったレビューでは "Code review found no issues." と表示されます - サブエージェント
CLAUDE_CODE_FORK_SUBAGENT=0を設定している場合、claude -p、Agent SDK、デスクトップ、VS Code のサブエージェントが、自身のサブエージェントの完了をデフォルトで待つようになりましたCLAUDE_CODE_FORK_SUBAGENT=0を設定したclaude -pで、バックグラウンドのサブエージェントとそれが待つサブエージェントを、1 つの 10 分の待機時間で数えるようになりました。長い連鎖ではCLAUDE_CODE_PRINT_BG_WAIT_CEILING_MSを引き上げます- Anthropic API を使うターミナルセッションで、サブエージェントの進捗要約をデフォルトの小型・高速モデルが短いメモから作成するようになりました(テレメトリが無効でも同様)。使用トークンが大幅に減ります
- managed-settings のプラグイン
claude -pと SDK のセッションで、独自の git リポジトリを持つ managed-settings のプラグインを、次のセッション用にバックグラウンドで取得するようになりました- 新しいマシンの
claude -p・SDK・Claude Desktop のセッションで、git マーケットプレイスの managed-settings プラグインが読み込まれるまでの時間を短縮しました。短い実行は最大 30 秒遅れて終了することがあります
- セッションの再開とメモリ
- 大きなセッションを再開するまでの時間を短縮しました
- 画像を多く含むセッションを再開するときのメモリ使用量を改善しました
- 時間のかかるコマンドやツールを実行する長時間の SDK・デスクトップセッションで、メモリ使用量と応答時間を改善しました
- インプロセスのチームメイトを複数同時に起動したときに、"Lock file is already being held" で失敗するケースが大幅に減りました
- computer use の承認ダイアログで、アプリごとのアクセスレベルと、より分かりやすい警告を表示するようになりました
- セッション間メッセージ
- クラウドセッションや別のコンピューターが一覧にない場合に、Remote Control がオフになっていることを Claude が説明するようになりました
- ほかのセッションからのメッセージが保留または破棄されたときに、
claude -pのテキスト出力がそのことと許可する方法を stderr に出すようになりました
/bugが送信前に Yes / No を確認するようになり、Enter を繰り返し押しても、レポートが送信されたり GitHub が開いたりしなくなりました/list-agentsの一覧がユーザーにだけ表示されるようになりました。必要なときは Claude 自身がセッションを一覧します- Claude in Chrome のウェルカム画面と
/chromeで、権限モードや/permissionsのルールで回答が決まる場合を除き、Claude がサイト上で操作する前に Claude Code が確認する旨を表示するようになりました - サードパーティプロバイダー利用時、またはテレメトリやフィーチャーフラグを無効にしている場合
- Claude Desktop と Agent SDK のセッションで、質問が開いたまま閉じられたときに、回答なしで続行せずターンを終了するようになりました
- 貼り付けたテキストが貼り付けであることを Claude に示すようになりました
- Claude が公開したアーティファクトを誰が開けるかを答えるときに、前回の公開時の回答を繰り返さず、アーティファクトを確認し直すよう Claude に指示するようになりました
- Self-hosted runner
- 再開したセッションで、Claude が以前の作業が残っているかを確認し、欠けているものを伝えるようになりました
CLAUDE_RUNNER_SESSION_UUIDとCLAUDE_CODE_REMOTE_SESSION_UUIDの両方が、セッションと、そのcheckout・post-session・spawn-runnerフックに設定されるようになりました--capacity 1のとき、プッシュ先リポジトリのパスがシンボリックリンクの場合に、より早い段階でセッションを拒否するようになりました
修正
- zsh で
=で始まる単語を含む Bash コマンドが止まる問題を修正:echo ====や[ a == b ]のようなコマンドが "not found" エラーで止まっていました。=cmdはコマンドのパスに展開されなくなります - スケジュール済みタスクの保存でほかのタスクが消える問題を修正: サードパーティプロバイダー利用時、またはテレメトリやフィーチャーフラグを無効にしている場合に、スケジュール済みタスクのファイルを読み込めないと、プロジェクトのほかの保存済みタスクが消えていました
- 記述ミスのあるスケジュール済みタスクが削除される問題を修正: プロジェクトのスケジュール済みタスクのファイルに記述ミスのあるタスクが、次にファイルを保存したときに削除されていました
- 自動コンパクションがシステムプロンプトを使い回す問題を修正: 自動コンパクションがセッションの以前のシステムプロンプトを使い回していました。
/compactと同じようにシステムプロンプトを再構築します - Markdown レンダリングのフリーズを修正: 非常に長い入力や形式が不正な入力で、Markdown のレンダリングがフリーズしていました
- 権限確認プロンプト直後の Esc が失われる問題を修正: 権限確認プロンプトや質問の直後に入力すると、Esc が失われることが多くありました。Alt を「Esc+キー」として送るターミナルでは、そこで割り当てのない Alt / Option キーを押すと拒否として扱われます
- auto mode が毎ターン失敗する問題を修正: Bedrock、Agent Platform、Foundry、Claude apps gateway で、ベータを拒否するゲートウェイを経由する環境で
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASを設定していると、Claude Desktop 以外で発生していました CLAUDE_STREAM_IDLE_TIMEOUT_MSで接続制限を延ばせない問題を修正: ゲートウェイ、カスタムベース URL、クラウドプロバイダーの利用時に、5 分の接続制限を延ばせませんでした- Claude Desktop が "Prompt is too long" で終了する問題を修正: サードパーティプロバイダー上の一部の Claude Desktop セッション(スケジュール済みタスクを除く)が、大きなツール結果の後に終了して続行できなくなっていました。最も大きな結果は除外されるようになります
anyOf・oneOf・allOfで始まる入力スキーマの MCP ツールが見つからない問題を修正: サードパーティプロバイダー利用時、またはテレメトリやフィーチャーフラグを無効にしている場合に発生していました- 不正な入力スキーマの MCP ツールでリクエストが失敗する問題を修正: サードパーティプロバイダー利用時、またはテレメトリやフィーチャーフラグを無効にしている場合に発生していました。該当ツールは除外され、その理由が Claude に伝えられます
- サブエージェントの effort がオフになる問題を修正: Bedrock、Google Cloud の Agent Platform、Foundry がサブエージェントの進捗要約の effort 設定を拒否した場合に、そのサブエージェントのモデルで effort がセッション中ずっとオフになっていました(2.1.327 でのリグレッション)
OTEL_RESOURCE_ATTRIBUTESの不正なエントリでほかのラベルが消える問題を修正: 不正なエントリが 1 つあると、メトリクスのデータポイント、イベント、スパンからほかのラベルまで消えていました。不正なエントリだけが除外されるようになります- このほか、Code Mode、self-hosted runner、Remote Control とクラウドセッション、ターミナルのキー入力と表示、
/pluginなどのスラッシュコマンドなど、多数の細かな不具合が修正されています。
破壊的変更・既定動作の変更
既存の設定や運用に影響する変更です。以下の変更前後の例は CHANGELOG と公式ドキュメントの記載をもとに作成した例です。
Bedrock などの Opus 4.6 / Sonnet 4.6 の開始モード
Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude apps gateway で Opus 4.6 / Sonnet 4.6 が auto mode に対応し、権限モードを指定していない対話セッションは auto mode で開始します。サードパーティプロバイダー上のこれらのモデルでは、plan モードと Bash の権限確認プロンプトも auto mode を使用・提示します。
変更前(〜v2.1.327):
Bedrock / Agent Platform / Foundry / Claude apps gateway × Opus 4.6・Sonnet 4.6
→ auto mode の対象外
変更後(v2.1.328〜):
Bedrock / Agent Platform / Foundry / Claude apps gateway × Opus 4.6・Sonnet 4.6
→ 権限モードを指定していない対話セッションは auto mode で開始
→ plan モードと Bash の権限確認プロンプトで auto mode を使用・提示
auto mode をオフにする場合は disableAutoMode を設定します。以下は settings.json の設定例です。書式は公式ドキュメントの settings リファレンスに基づきます。
{
"disableAutoMode": "disable"
}
Code Mode のスクリプト出力と UserPromptSubmit フック
Code Mode で、スクリプトの出力に対して UserPromptSubmit フック(managed のものを含む)を実行しなくなりました。出力をマスクするには、updatedToolOutput を使う PostToolUse フックを設定します。以下は設定例です。
変更前(〜v2.1.327): UserPromptSubmit フックが Code Mode のスクリプト出力にも実行されていました。
{
"hooks": {
"UserPromptSubmit": [
{ "hooks": [ { "type": "command", "command": "./redact.sh" } ] }
]
}
}
変更後(v2.1.328〜): PostToolUse フックで、マスクした出力を updatedToolOutput として返します。
{
"hooks": {
"PostToolUse": [
{ "hooks": [ { "type": "command", "command": "./redact.sh" } ] }
]
}
}
redact.sh が標準出力に返す JSON の例です。公式ドキュメントの hooks リファレンスでは、updatedToolOutput の値は元のツール出力と同じ形にする必要があると記載されています。
{
"hookSpecificOutput": {
"hookEventName": "PostToolUse",
"updatedToolOutput": { /* 元のツール出力と同じ形で、マスクした値 */ }
}
}
実行前に拒否された呼び出しと managed の PostToolUse フック
managed の PostToolUse フックが、実行前に拒否された呼び出しでは発火しなくなりました。その呼び出しについてのログ記録・書き換え・ブロック・停止は行われません。PostToolBatch にはそうした呼び出しの大半が渡されますが、拒否されたものとしては示されません。
変更前(〜v2.1.327):
ツール呼び出しが実行前に拒否された
→ managed の PostToolUse フックが発火(ログ記録・書き換え・ブロック・停止)
変更後(v2.1.328〜):
ツール呼び出しが実行前に拒否された
→ managed の PostToolUse フックは発火しない
→ PostToolBatch には大半が渡るが、拒否されたものとしては示されない
以下は監査ログを PostToolUse で取っている場合に、PostToolBatch での記録を追加する設定例です。PostToolBatch に渡される拒否された呼び出しは大半に限られ、拒否されたものとしても示されないため、PostToolUse と同じ内容の記録にはなりません。
{
"hooks": {
"PostToolUse": [
{ "hooks": [ { "type": "command", "command": "/opt/audit/log-tool-use.sh" } ] }
],
"PostToolBatch": [
{ "hooks": [ { "type": "command", "command": "/opt/audit/log-tool-batch.sh" } ] }
]
}
}
最後に
mcp_tool フックでも失敗時に操作を止められるようになり、/code-review と /simplify の役割も分かれました。フックでの制御とコードレビューの両方で、目的に合わせて設定や手順を選びやすくなったリリースだと感じます。
フックや /code-review を使っている方は、「破壊的変更・既定動作の変更」の内容を確認したうえで、アップデートして試してみてはいかがでしょうか。
参考文献







