Claude Media
Claude Code v2.1.328 — Bedrock等のOpus 4.6もauto modeが既定に

Claude Code v2.1.328 — Bedrock等のOpus 4.6もauto modeが既定に

Bedrock等のOpus・Sonnet 4.6がauto mode対応、mcp_toolフックにonFailureのblockを追加。Code Modeはスクリプトの出力にUserPromptSubmitフックを走らせません。

このリリースで何ができるようになるか

Claude Code v2.1.328は、サードパーティ基盤でのauto modeの対象を広げ、フックの失敗時にblockを選べる範囲を広げるリリースです。項目数は144件で、そのうちCode Modeに触れるものが22件、自己ホストRunnerに触れるものが26件を占めます。

数字

v2.1.328のchangelog内訳

  • 項目の合計

    144

    VS Code向け3件を含む

  • Added

    14

    自己ホストRunner向け6件を含む

  • Code Mode関連

    22

    大半が修正と改善

  • 自己ホストRunner関連

    26

    追加・修正・変更

項目の本文で数えた件数(重複あり)

読者に直接効く点は次の4つです。

  • Amazon Bedrock・Google CloudのAgent Platform・Microsoft Foundry・Claudeアプリのゲートウェイで、Opus 4.6とSonnet 4.6にもauto modeが使える
  • mcp_tool フックに "onFailure": "block" が加わり、呼び出しが失敗したらアクションを止められる
  • zshで echo ==== のような = で始まる語が「not found」で止まる不具合が直った
  • 自動コンパクションが、/compact と同じ手順でシステムプロンプトを組み直すようになった

前のリリースの流れはv2.1.327の解説にあります。

あなたの開発フローはどう変わるか

Bedrockなど経由でOpus 4.6・Sonnet 4.6を使うとき

対象の基盤は、Bedrock・Agent Platform・Foundry・Claudeアプリのゲートウェイの4つです。ここでOpus 4.6かSonnet 4.6を使い、権限モードを指定していない対話セッションは、auto modeで始まります。

プランモードとBashの確認プロンプトも変わりました。この2つは、新しいモデルと同じようにauto modeを使い、auto modeへの切り替えを提案します。止めたい組織は disableAutoMode を設定します。changelogの記述では、これで両方が切れます。auto modeを組織で消す手順はdisableAutoModeの解説にあります。

注意したいのは、権限モードの解説ページの対応モデル表との差です。表はこれらの基盤について、Sonnet 5以降・Opus 4.7以降・Haiku 5.5・Fable系だけを挙げ、4.6は載っていません。今回のchangelogは4.6を対象に加えているので、表より新しい情報はchangelog側にあります。

claude -p やAgent SDKの実行は、権限モードを指定しなければManualで始まる扱いです。無人のジョブでは、--permission-mode auto を明示するかどうかで挙動が分かれます。

同じ基盤向けの修正もあります。CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS を設定し、betaを拒否するゲートウェイの裏で動かしていると、Claude Desktop以外ではauto modeが毎ターン失敗していました。この不具合が直っています。

フックで「失敗したら止める」を使うとき

mcp_tool フックでも、呼び出しが失敗したときにアクションを止められます。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "mcp_tool",
            "server": "my_server",
            "tool": "security_scan",
            "input": { "command": "${tool_input.command}" },
            "onFailure": "block"
          }
        ]
      }
    ]
  }
}

上の設定は、フックの解説ページにある mcp_tool の例からサーバー名 my_server とツール名 security_scan を借り、PreToolUseのBash検査として組み直して onFailure を足した例です。

onFailure を指定しない場合、フックの失敗や時間切れではアクションが先へ進むのが基本です。検査用のフックが壊れたときに全部が通ってしまう、という穴をふさぐための項目です。

同じ流れで、管理設定の PostToolUse フックの扱いも変わりました。実行前に拒否された呼び出しでは、もう発火しません。ログ・書き換え・ブロック・停止はそこで起きなくなります。PostToolBatch は拒否された呼び出しの大半を受け取りますが、拒否済みの印は付きません。

/goal にも修正があります。同じ文言のStopフックが複数あると、スキルのStopフックを消したり、別のフックの結果で早く終わったりしていました。

Code Modeを試しているとき

Code Modeは、Claudeが複数のツール呼び出しをJavaScriptにまとめて実行する実験機能で、CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 で有効にします。導入はv2.1.323の解説にあります。

今回は、動作の食い違いを直す項目が大半です。

種類主な内容
スクリプトの実行主な内容{ ブロックで始まる有効なスクリプトも、トップレベルの await と return を併用したスクリプトも、拒否されなくなった
途中経過の欠落主な内容失敗した前のスクリプトが設定しなかったトップレベルの変数を、黙って undefined として使わなくなった
権限モードとの組み合わせ主な内容auto・bypassモードで、前のスクリプトの実行中に接続したMCPサーバーを呼べるようになった
再開主な内容claude --resume の選択画面から再開したセッションでも、auto・bypassモードならスクリプトがバックグラウンドで動く。再開時や確認を求めるモードでスクリプトが打ち切られたことも、Claudeに伝わる
速度主な内容auto・bypassモードで、多くのスクリプトの後にあった0.75秒の待ちがなくなった

加えて、スクリプトが実行しているコマンドとその出力が、実行中に表示されるようになりました。変化がないままの編集は、スクリプトを止めなくなりました。

仕様の変更が1件あります。Code Modeは、スクリプトの出力に対して UserPromptSubmit フックを走らせなくなりました。管理設定のフックも同じです。出力を伏せたい場合は、updatedToolOutput を使う PostToolUse フックが代わりになります。出力の検査を UserPromptSubmit に頼っていた環境は、置き換えが要ります。

自己ホストRunnerを運用しているとき

追加の6件は、運用の観測と制御に関するものです。

  • --repository-folder: --capacity 1 のとき、セッションがリポジトリに使うフォルダーを指定する。ベースフォルダー配下のパスではシンボリックリンクにできない
  • --hook-label(claude self-hosted-runner orchestrator): 選んだセッションラベルを spawn-runner フックへ渡す
  • --metadata key=value(claude --environment): セッションに spawn-runner フック用のラベルを付ける
  • orchestratorの /metrics に、再開したセッションの待ちと新規セッションの待ちを区別する指標が加わった
  • 同じく、Anthropic側がRunnerの起動を諦めた回数を原因別に数える指標が加わった
  • ホストの settings.json が既定の権限モードを設定していて、セッションが無視するときの起動時警告が加わった

挙動が変わる点は、組み込みの gh api です。設定がClaudeのGitHubツールを名前で制限している場合、既定でオフになりました。使うには --use-anthropic-gh true を付けます。

--capacity 1 の自己ホストRunnerは、プッシュ先リポジトリのパスがシンボリックリンクのとき、セッションをより早く断ります。構成の全体像は自己ホスト環境のフラグとメトリクスの一覧が扱っています。

主な変更点

追加

  • CLAUDE_CODE_DISABLE_DEFERRED_TOOL_RESUME: フックが保留したツール呼び出しを、claude -p --resume と --continue が実行しないようにする。ホスト側の制御用で、値の指定形式はchangelogに載っていません
  • /status と claude doctor に、OpenTelemetryのエクスポーターにエンドポイントがなく、データが失われそうなときの通知が加わった
  • 権限の確認を省くセッションからのメッセージが、クラウドセッションで保留・破棄されそうなときの警告が加わった
  • Claude Codeを組み込むアプリが、ポリシープラグインの allowManagedModsOnly を有効にできる。管理者の管理設定が優先される
  • Claudeアプリのゲートウェイは、maxEffortLevel が有効な努力レベルでないとき、起動時に警告する
  • [VSCode]他のセッションからのメッセージが保留されたとき、許可できる設定ファイルへのリンク付きで通知する

変更

  • /code-review は、ほとんどのモデルでバグとCLAUDE.mdの違反だけを報告する。再利用・単純化・効率の整理は /simplify で行う
  • /code-review は、ほとんどのモデルで各指摘をImportant・Pre-existing・Nitに分け、要約の末尾に修正案を付ける。問題がなければ「Code review found no issues.」と出る
  • /bug は送信前にYes・Noを尋ねる。Enterの連打で報告が送られたり、GitHubが開いたりしなくなった
  • /list-agents の一覧は、本人にだけ表示される
  • deniedMcpServers の claude.ai <名前> 形式のエントリが、クラウドと自己ホストRunnerのセッションでも、そのコネクターに効く
  • PermissionRequestフックがsandbox除外のコマンドへ書き換えたシェルコマンドは、sandboxの外で動く
  • sandboxを起動できないとき(sandbox.failIfUnavailable 未設定)は、次のsandbox対象のBashコマンドを拒否し、セッション中sandboxが無効だと伝える
  • CLAUDE_CODE_FORK_SUBAGENT=0 のとき、claude -p ・Agent SDK・デスクトップ・VS Codeのサブエージェントは、自分のサブエージェントを既定で待つ。claude -p では待ち時間が10分にまとめて数えられ、長い連鎖には CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS を上げる

/code-review の変更は、組み込みのレビューを前提にしている手順に響きます。指摘の分類を自作のスキルで再現している場合は、/code-reviewを自作スキルに置き換える手順の線引きが参考になります。

修正

  • zshのBashコマンドが、echo ==== や [ a == b ] のような = で始まる語で「not found」になった。=cmd はコマンドのパスへ展開されなくなった
  • 自動コンパクションが、以前のシステムプロンプトを使い回さず、/compact と同じ手順で作り直す
  • スケジュールタスクの保存で、ファイルが読めないときに他のタスクが消える問題(サードパーティプロバイダーなどで発生)と、タイプミスのあるタスクが次の保存で消える問題が直った
  • スピナーとサブエージェントのトークン数は、再試行された応答を二重に数えず、考えている間も止まらない
  • 利用クレジットが応答の途中で尽きたときに、レート制限と誤表示しなくなった
  • CLAUDE_STREAM_IDLE_TIMEOUT_MS が、ゲートウェイ・独自のベースURL・クラウドプロバイダーで、5分の接続上限を延ばさない問題が直った
  • 入力スキーマが anyOf ・oneOf ・allOf で始まるMCPツールが、サードパーティプロバイダーなどでも消えずに残る。無効な入力スキーマのツールは外され、理由がClaudeに伝わる
  • Esc・Cmd・Alt・Ctrl+クリック・Shift+Enterの入力まわりの不具合が、複数のターミナルで直った
  • /plugin の更新・削除の途中で戻ったときに、別のプラグインを対象にする問題が複数直った

CLAUDE_STREAM_IDLE_TIMEOUT_MS の件は、ゲートウェイ越しの長い応答で、タイムアウトを延ばしたはずなのに切れていた環境に効きます。

改善

  • claude -p とSDKセッションで、独自のgitリポジトリを持つ管理設定のプラグインを、後続のセッション向けにバックグラウンドで取得する
  • gitマーケットプレイスの管理設定プラグインが、新しいマシンで早く読み込まれる。短い実行は、最大30秒遅れて終わることがある
  • 大きなセッションの再開が速くなり、画像の多いセッションの再開でメモリー使用量が減った
  • Code Modeのツール説明が短くなり、トークン使用量が減った
  • 複数のin-processチームメイトを同時に起動したときの、「Lock file is already being held」の失敗がかなり減った
  • computer useの承認ダイアログに、各アプリのアクセス水準と、より平易な警告が出る

失敗時ブロック(onFailure)の拡大で、フックは「落ちたら通す」から選べる門番になる

フックの解説ページは、フックが失敗したときの原則を次のように書いています。多くのイベントで、失敗や時間切れが起きてもアクションは実行される、という内容です。ポリシーを担うフックのパスを間違えると、すべてが通ってしまいます。

onFailure: "block" は、その穴をフックごとにふさぐ指定です。今回、対象に mcp_tool が加わりました。フックの解説ページの onFailure の説明は、まだ command と http のフックだけを対象に書いています。onFailure 自体はv2.1.295以降のフックで使えますが、mcp_tool への対応は、changelogが先に書いている状態です。実際に使う前に、手元のバージョンで失敗時の挙動を一度試しておくと安全です。

サーバー名かツール名をわざと間違えた設定でBashコマンドを1つ実行させれば、ブロックされるかどうかで試せそうです。ただ、名前の誤りが呼び出しの失敗として扱われるかは、フックのページに書かれていません。MCPサーバーを止めた状態でも同じ操作を試し、結果を見比べる方法もあります。

どのフックにも付けるべき設定ではありません。ブロックを選ぶと、MCPサーバーの一時的な不調がそのまま作業の停止になります。セキュリティ検査のように、失敗時に通すより止めたいフックだけが対象です。フック全般の書き方はhooksガイドにまとめています。

まとめ

サードパーティ基盤でOpus 4.6かSonnet 4.6を使い、権限モードを決めていない環境は、更新後にauto modeで始まります。止めたい場合は disableAutoMode が先です。

mcp_tool フックで検査を組んでいるチームは、onFailure を付けるかどうかの判断材料がそろいました。Code Modeを試している人は、UserPromptSubmit フックの扱いが変わった点だけ確認しておくと足ります。自己ホストRunnerの運用者には、追加の6件と gh api の既定オフが関係します。それ以外の読者にとっては、主に表示と入力まわりの修正リリースです。スラッシュコマンドの一覧はスラッシュコマンドの解説にあります。

関連ガイド

このバージョン単体の位置づけや前後の版とのつながりは、Claude Codeの基礎ガイドでまとめて確認できます。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. code.claude.com/docs/en/changelog
  2. github.com/anthropics/claude-code/releases/tag/v2.1.328
  3. code.claude.com/docs/en/hooks
  4. code.claude.com/docs/en/permission-modes
  5. code.claude.com/docs/en/code-mode
この記事を共有:XはてブLinkedIn