Claude Code v2.1.327を社内の自動化ジョブに展開した翌朝、v2.1.328が出ていた。
前回は「Bedrock上でのサブエージェントのeffort設定が無効になる」というリグレッションが入っていて、展開してから気づいた。今回も同じことが起きないか、変更点を一通り確認した。
リリースノートの量が多い。ここでは企業のgateway利用・自社runner構築・マルチプロバイダー展開に関係する点だけを整理する。
この記事で分かること:Amazon Bedrock・Microsoft Foundry・Google Cloud Gateway向けのauto mode追加、MCPツールフックの制御強化、Self-Hosted Runnerの管理機能拡充、自動コンパクションの修正、zshのzshのBashバグ修正、の5点。リリース日2026-11-19。
1. Amazon Bedrock・Microsoft Foundry・Google Cloud GatewayでAuto modeが使えるようになった
v2.1.328で、Claudeのauto modeが次のプラットフォームに対応した:
- Amazon Bedrock
- Google Cloud's Agent Platform
- Microsoft Foundry
- Claude apps gateway
auto modeとは、推論の重さ(effort level)をClaudeがタスクの複雑さに応じて自動で選ぶモードだ。これまでClaude.comかAnthropicのAPIを直接使うセッションでしか動かなかった。
企業内でBedrockやFoundryをinternal deploymentの基盤に使っている場合、effort設定はフロー側で固定するしかなかった。v2.1.328以降、自動化ジョブのeffort判断をClaude側に委ねる選択肢が加わった。
一方で、既存の設定に影響する可能性がある点が重要だ。
確認ポイント:
--permission-modeを明示していないinteractive sessionは、v2.1.328からauto modeで起動する仕様になった。既存のジョブが意図せずauto modeに切り替わっていないか確認する必要がある。特にgateways経由の常時稼働ジョブは設定の見直しを推奨する。
auto modeのeffort選択は「タスクが重いと判断したとき、より多くのトークンを使う」という動作をとる可能性がある。コスト管理をしている場合は、展開後のトークン消費量を監視することをおすすめする。
2. MCP toolフックに"onFailure": "block"が追加された
コマンドフック・HTTPフックにすでにあった"onFailure": "block"が、MCP toolフックにも追加された。
MCPサーバー側のツール呼び出しが失敗したとき、そのアクション全体をブロックできるようになった。今まではMCPツールの失敗を検知しても後続アクションを止めるには別の仕組みが必要だったため、制御の一貫性が出た。
設定例:
{
"hooks": {
"mcp_tool": [
{
"tool": "dangerous_operation",
"onFailure": "block"
}
]
}
}
企業のAI基盤でMCPサーバーを使っていて、特定のツール呼び出し失敗時の制御を厳しくしたい場合は、設定に追加できる。コマンドフック・HTTPフックとの設定の一貫性も保てる。
MCPツールフックを使っていない場合は影響なし。ただしMCPを本番で使い始めた組織が増えているタイミングで、この追加は実用的だと感じる。
3. Self-Hosted Runnerの管理機能が大幅に強化された
v2.1.328のリリースノートの中でも、Self-Hosted Runner向けの追加が特に多かった。運用規模が大きい組織に関係する変更を整理する。
追加された起動オプション:
-
--repository-folder:--capacity 1のセッションが使うリポジトリのフォルダ名を指定できるようになった。従来はbase folderの下のパスをそのまま使うためシンボリックリンクが使えなかった -
--hook-label:orchestratorの起動時に選択したセッションラベルをspawn-runnerフックへ渡せる。ラベルごとに異なるrunnerを起動する設定に使える -
--metadata key=value:claude --environmentでセッションにメタデータラベルを付与し、spawn-runnerフックで識別できる。セッションの種類や優先度をrunner側で分岐するのに使える
監視用メトリクスの追加:
orchestrator の/metricsエンドポイントに2つが追加された:
-
claude_code_self_hosted_orchestrator_session_queue_wait_by_reason_seconds:再開セッションの待ち時間と新規セッションの待ち時間を分けて測定できる -
claude_code_self_hosted_orchestrator_sessions_given_up_total:Anthropicがrunnerの起動を諦めた回数を原因別にカウント
これにより、「セッションがキューで詰まっている」のか「runnerが起動に失敗している」のかを区別して監視できるようになった。今まではどちらのケースも同じキューの遅延として見えていたので、問題の切り分けに役立つ。
Self-Hosted Runnerを本格運用している組織にとっては実用的な追加だ。自分の環境ではrunnerのgiven_up_totalが通知しきい値に引っかかって初めて気づく、というパターンが何度かあった。
スタートアップ警告の追加:
次の2つのケースでスタートアップ時に警告が出るようになった:
- ホストの
settings.jsonでデフォルトのpermission modeを設定しているが、セッションがそれを無視しているとき - orchestratorの起動時に
policy.maxEffortLevelに有効でない値が設定されているとき
設定ミスをデプロイ直後に検出できるようになった。
4. 自動コンパクションのシステムプロンプト再構築が修正された
自動コンパクションの挙動に関する修正が入った:
修正内容:自動コンパクションが実行されたとき、以前は直前のシステムプロンプトをそのまま使い回していた。v2.1.328から、
/compactコマンドと同じ方法でシステムプロンプトを再構築するよう変更された。
overnight jobや継続実行ジョブのように、コンパクションが何度も走るセッションでは、システムプロンプトが徐々にずれていく現象が出ていた可能性がある。コンパクション後のセッションの動作がおかしいと感じたことがあれば、この修正が関係しているかもしれない。
加えて、コンパクション後にセッションを再開(resume)したとき、コンパクションのサマリーや直近のメッセージが消える問題も修正された。これはrewindの後に/clearした場合のパスでも同様の修正が入っている。
長期稼働のセッションを運用している場合は、v2.1.328以降の動作を確認しておくとよい。
5. zshでのBashコマンドの"="始まりエラーが修正された
地味だが影響範囲が広いバグ修正:
修正内容:Bashコマンドをzshで実行したとき、
=から始まる語(echo ====や[ a == b ]など)で「not found」エラーが出ていた問題を修正。=cmdがコマンドの絶対パスに展開される挙動を無効化した。
zshには=cmdをコマンドの絶対パスに展開する機能がある(例:=python → /usr/bin/python)。Claude Codeが生成するBashスクリプトに==を使った比較や====のような区切り文字が含まれる場合、zsh環境では予期しない展開が起きていた。
macOSのデフォルトシェルが2019年からzshになっているため、Macユーザーを中心に踏んでいた人は一定数いると思う。自分も以前、echo ====が"not found"になって原因を追った記憶がある。理屈ではできるんだけどね、というやつだった。
Linux(bash)環境だけで使っている場合は影響なし。
v2.1.327のリグレッション修正も確認
v2.1.327で入った「BedrockやGoogle Cloud AgentPlatform・FoundryがサブエージェントのProgressサマリーのeffort設定を拒否したとき、セッション全体のeffortが無効になる」というリグレッションは、v2.1.328で修正済みだ。
v2.1.327を展開済みで、Bedrock上のサブエージェントが意図より軽い推論で動いていた場合、v2.1.328への更新で改善される可能性がある。
今回わかったこと
- Bedrock/Foundry/Google Cloud GatewayへのAuto mode対応で、既存のinteractive sessionのpermission mode設定を見直す必要がある
- MCP toolフックへの
onFailure: block追加で、MCPサーバー利用時の制御が他フックと統一できる - Self-Hosted Runnerのメトリクス追加で、キュー詰まりとrunner起動失敗を分けて監視できる
- 自動コンパクションのシステムプロンプト問題とzshの=バグ修正が含まれる
v2.1.328は特にgateways・self-hosted runner向けの変更が多い回だった。Bedrockとともに社内展開しているチームは、自動コンパクションの修正とauto mode対応を優先して確認することを推奨する。
出典:https://github.com/anthropics/claude-code/releases/tag/v2.1.328
関連記事
無人実行が止まる原因の点検を、ココナラで承っています(「Claude Code 点検」で検索)。