0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code v2.1.326 破壊的変更まとめ:サンドボックス・権限・auto mode

0
Posted at

はじめに

Claude Code v2.1.326 がリリースされました。エージェントチームと Code Mode の併用や OTEL のホスト属性といった新機能もあります。ただ、今回の本題は サンドボックス・権限チェック・auto mode・フック・プラグインの挙動を厳しくする破壊的変更が多い ことです。

「昨日まで動いていた自動化が、今日から確認待ちや拒否で止まる」可能性があります。特に CI や無人実行、bypass permissions モードで Claude Code を使っている人は要注意です。

この記事では、重要度(severity)が critical / high の変更を中心に、次の点を整理します。

  • 何が変わったか
  • 誰が影響を受けるか
  • 何をすべきか

📌 影響を受ける人

  • CI / バッチ / SDK ホストなど 無人実行 で Claude Code を使っている人
  • bypass permissions モードや auto mode を常用している人
  • 組織の管理者(managed settings、プラグイン配布、HIPAA 構成の担当者)
  • Windows で PowerShell ツールを使っている人
  • フック(特に "decision": "block")を書いている人
  • opusplan を使っている人(コスト面)

変更の全体像

今回のリリースで、安全側に倒れた領域を図にまとめます。

変更の性質は、おおまかに次のように分けられます。

区分 内容 影響の出方
安全性の強化 サンドボックス、権限チェック、PowerShell 確認ダイアログ増加、無人実行での拒否
既定値の変更 auto mode の起動条件、autoMode.environment セッションの起動モードや判定が変わる
ルールの解釈変更 ワイルドカード allow、フックの decision 今まで通っていた設定が効かなくなる/効きすぎる
コスト plan mode のコンパクション opusplan で費用増の可能性
読み込みの変更 不正な plugin.json でも読み込み 意図せずフックや MCP サーバーが有効化される

変更内容

1. Bash サンドボックスの書き込み・状態保持の変更(critical)

macOS・Linux・WSL のサンドボックス内コマンドの挙動が大きく変わりました。

  • 機密性の高い一部のホームフォルダには、デフォルトで書き込めない。一部は user / managed settings の sandbox.filesystem.allowWrite で許可できる
  • セッションの mods フォルダでの編集は確認が増え、サンドボックス内コマンドが書き込めるフォルダも減った
  • コマンド実行後、リポジトリの .git フォルダにある 想定外のエントリを退避 する
  • Linux / WSL では、存在しない --add-dir フォルダの一部を各コマンド前に作成する。そのフォルダを作るコマンドが失敗・スキップされたり、フォルダの内側に作成されたりする可能性がある
  • /sandbox か /cd を実行するまで、セッション中サンドボックスの状態を保持する場合がある(Bash が確認を求めることがある)
  • auto-allow がオフのとき、環境変数を設定する一部の行の前に確認を求める(無人実行では拒否される場合あり)
  • 権限フックや SDK ホストが承認時に書き換えたコマンドは、元がサンドボックス扱いならサンドボックス内のまま。承認側は dangerouslyDisableSandbox: true を付与できる
  • claude mcp serve は sandbox.excludedCommands を 無視 する
  • サンドボックス有効時、/rewind は一部のファイルに触れず、スキップとして報告する

⚠️ Breaking Change
ホームフォルダ配下のキャッシュや設定ディレクトリへ書き込む処理(ツールのキャッシュ、dotfiles の生成など)が、サンドボックス内で失敗する可能性があります。必要なパスだけ sandbox.filesystem.allowWrite で許可してください。ただし許可できるのは一部のフォルダに限られます。

2. 権限チェックの強化(critical)

「以前は実行できたコマンドが、確認または拒否される」変更です。

  • Bash の権限チェックを強化。一部のコマンドは事前に確認し、誰も応答できない場面では拒否
  • macOS で以前は実行できた一部の Bash コマンドが、確認または拒否に変更
  • auto mode で、以前は実行できた一部のシェルコマンドを停止
  • Claude のファイルツールは、.credentials.json などのサインインファイルへの書き込みを拒否。Bash でもサインインファイルに触れるコマンドの確認を拡大
  • 一部のファイルツールは、デバイスファイルやプロセスファイルの一部を拒否
  • 一部の cp / mv コマンドは事前に確認
  • bypass permissions モードでも、一部のツール呼び出しは承認を求めるか、誰も応答できない場面では拒否
  • 値が長すぎてチェックを終えられないコマンドは確認を求める(deny ルールが該当しうる、または誰も応答できない場合は拒否)
  • worktree で隔離されたサブエージェントは、チェックアウトと共有するブランチを書き換えうる git コマンドを拒否(通常のセッションは影響なし)
  • ExitWorktree は、バックグラウンドのサブエージェントやシェルコマンドが動作中の可能性があると、discard_changes がない限り worktree の削除を拒否

💡 Tips
「bypass モードなら何でも通る」という前提は崩れました。CLAUDE.md の運用ルールにも「bypass でも確認・拒否が起こりうる」「無人実行で拒否されるケースがある」と明記しておくと、チームの混乱を防げます。

3. auto mode のワイルドカード allow と autoMode.environment(high)

  • プログラム名を含まない、または $HOME で始まるワイルドカードのシェル allow ルールは 無視 され、安全チェックが判定する
  • プログラムが Windows のバックスラッシュパスであるワイルドカード allow ルールも判定対象になり、ブロックされうる。完全一致のルールは許可のまま。.\ で始まるルールは今後復元予定
  • "$defaults" を含まない managed の autoMode.environment リストは、Claude Desktop と Agent SDK アプリでも 組み込みエントリをすべて置き換える。"$defaults" を追加するか、機密ターゲット系のエントリをコピーすること
  • 古い保存値が原因で、使用量にカウントされるローカル分類器に auto mode が留まり続ける問題を修正

4. 既定の起動モードの変更(high)

  • Claude Code + Cowork の HIPAA 構成の組織では、ターミナルと VS Code のセッションが既定で auto mode で起動する(disableAutoMode で無効化可能)
  • HIPAA 構成の組織でも、Anthropic API に直接接続している場合は、他の組織と同様にサーバー側の分類器が操作をチェックする

5. フックの挙動変更(high)

  • "decision": "block" が効く場面が増えた。常にこれを出力するフックは、呼び出しをブロックし始める可能性がある
  • managed settings のフックに対する allowedHttpHookUrls と httpHookAllowedEnvVars の適用方法を変更
  • HTTP フックは headers 設定の Content-Length と Transfer-Encoding を無視(長さはボディから決定)

改善点もあります。

  • 複数のフックが応答した場合も PreToolUse の updatedInput が保持される
  • PreToolUse フックが終了コード 127 で終了した場合、チェックが実行されなかった可能性を示すエラーを表示
  • transcript 上で、フックの失敗は赤、Claude を止めたフックは黄で表示し、理由も記載

6. PowerShell ツールの拡大(high)

  • 確認を求めるコマンドを追加。無人実行では、allow ルール、auto mode、bypass permissions mode のいずれかで許可されていなければ拒否
  • bypass permissions モードでも確認を求めるコマンドが増え、一部は拒否
  • 不正な形式の PowerShell コマンドの一部を拒否
  • 組み込みコマンドと同名の関数を定義するコマンドの一部を拒否(Claude が名前を変更できるように)

7. プラグインの読み込み変更(high)

  • 表示用フィールド(author、homepage など)が不正で拒否されていた有効なプラグインが、フックや MCP サーバーとともに読み込まれる ようになった
  • 不正なフィールド自体は無視され、/plugin と claude plugin list に注記される
  • アンインストール時、MCP バンドル(.mcpb、.dxt)から展開したファイルも削除される(他のプラグインが同じバンドルを使う場合を除く)
  • /plugin のアンインストール、削除、切り替えの質問は、矢印キーと Enter で選ぶ形式に変更(y / n / u は不可)

⚠️ Breaking Change
これまで「plugin.json の表示用フィールドが不正だったために、たまたま読み込まれていなかったプラグイン」が、フックや MCP サーバーごと有効になります。管理者は配布中のプラグインを確認してください。

8. コスト:plan mode の自動コンパクション(high)

plan mode での自動コンパクションは、その時点で 応答しているモデル を使うようになりました。opusplan では Opus で要約されるため、コストが増える可能性があります。

項目 変更点
plan mode の自動コンパクション 応答中のモデルで実行(opusplan なら Opus)
Cowork のクラウドセッション OTel エクスポートを最初のターンまで保留。メッセージのないセッションは何も送信しないため、claude_code.session.count が減ることがある
自動セッション recap 使用量クレジットで課金された返信の後に送られる問題を修正(/recap は引き続き利用可)

9. Code Mode の $ シェルヘルパー(high)

Code Mode のスクリプトで $ ヘルパーに特定の値を渡すと、コマンドは実行されずエラー になります。どの値が対象かは入力データからは分かりません。$ に任意の値を渡している既存スクリプトは、動作確認が必要です。

10. 信頼・認証・MCP 管理(medium)

  • ローカルのターミナルセッションで --add-dir / /add-dir に未信頼のフォルダを指定すると、信頼確認を表示(claude --bg は拒否)
  • --trust-workspace false の self-hosted runner は、無視するリポジトリ設定を拡大。該当値は user / managed settings で設定する
  • Remote Control と self-hosted runner で、権限回答の「always allow」の保存方法を変更
  • セッション中に追加された managed-mcp.json は次回チェック時に適用されうる。完全に適用するには開いているセッションを再起動する
  • API キー、認証トークン、プロファイル、workload identity を、保存済みの claude.ai ログインと併用しているセッションでは、別マシンのセッションへのメッセージを拒否
  • 未承認の API キーでの --bare セッションにも変更があります(入力データが途中で切れており、詳細は不明です。公式リリースノートで確認してください)

11. 新機能(medium)

機能 内容
Code Mode × エージェントチーム チーム有効のままでも Code Mode をオンにできる。すでにオンなら、チーム有効のセッションは Code Mode で起動
OTEL_RESOURCE_INCLUDE_HOST OTel のリソース属性に host.name と host.id を含める(デフォルトはオフ)
診断性の向上 --allowedTools などに不完全なルールがあると起動時に警告。/status に機能が無効な理由を表示。/help <command> を追加
mod の表示プロパティ Box に overflowX="scroll"、Text に maxLines と wrap="clip" を追加
パフォーマンス /update-config のコンテキスト使用量が約93,000から約13,000トークンに削減

12. 注目すべき不具合修正

  • MCP: 同じミリ秒に長い結果が2つ届くと、並列の MCP ツール呼び出しが別の呼び出しの結果を読んでいた(#105138)
  • 権限: /permissions やツールプロンプトで追加したルール、/add-dir のフォルダが、設定ファイルに書き込めなくても保存済みに見えていた(警告とファイル名を表示するように)
  • 安全性: 支出上限メニューを開いた直後の Backspace と Enter で、確認なしに月額上限が削除されていた
  • 安全性: stdout をリダイレクトすると claude purge の確認が見えず、Enter 1回でデータを削除しうる状態だった
  • プロセス管理: バックグラウンドサービスが、PID の再利用により他ユーザーのプロセス(SSH ログインなど)を終了させていた
  • コンパクション: Bedrock、Vertex、Foundry、およびテレメトリ無効時に、コンパクションが要約せずメッセージに返信していた
  • Vertex AI: 画像の多いセッションが 30MB 超過の 400 エラーで止まっていた(コンパクトして再試行するように)

影響と対応

アップデート前後で確認すべき順序を、フローチャートにまとめます。

対応チェックリスト

優先度 対象 アクション
最優先 無人実行・CI bypass モードでも拒否・確認が出る前提で、allow ルールを明示。拒否ログで止まる箇所を洗い出す
最優先 サンドボックス利用者 ホーム配下への書き込みが必要なら sandbox.filesystem.allowWrite で許可(許可できるのは一部のフォルダのみ)
高 auto mode 利用者 ワイルドカード allow ルールにプログラム名を含める。$HOME 始まりのワイルドカードは使わない
高 管理者 managed の autoMode.environment に "$defaults" を追加する。HIPAA 構成の既定モード変更を周知
高 フック作者 常に "decision": "block" を出力していないか確認。HTTP フックの headers から Content-Length / Transfer-Encoding を外す
高 プラグイン管理者 配布中のプラグインの plugin.json を確認。これまで拒否されていたプラグインが有効化されていないか点検
高 Code Mode 利用者 $ ヘルパーに渡している値を確認
中 opusplan 利用者 plan mode のコンパクションが Opus になるためコストを監視
中 claude mcp serve 利用者 sandbox.excludedCommands が無視される点を確認
中 OTel 利用者 claude_code.session.count の減少は Cowork の仕様変更によるもの。ダッシュボードのアラートを見直す

コード例

以下は、変更内容に基づく設定イメージです。キーの正確な配置は、お使いの環境の公式ドキュメントで確認してください。

サンドボックスの書き込み許可

{
  "sandbox": {
    "filesystem": {
      "allowWrite": ["~/.cache/my-tool"]
    }
  }
}

💡 Tips
許可するのは必要最小限のパスだけにします。機密性の高い一部のホームフォルダは、許可できない場合があります。

managed の autoMode.environment

Before(組み込みエントリがすべて置き換わる):

{
  "autoMode": {
    "environment": ["自社固有の環境エントリ"]
  }
}

After("$defaults" を加えて組み込みエントリを維持):

{
  "autoMode": {
    "environment": ["$defaults", "自社固有の環境エントリ"]
  }
}

ワイルドカード allow ルールの見直し

Before(プログラム名を含まないワイルドカードは無視される):

{
  "permissions": {
    "allow": ["Bash(*)"]
  }
}

After(プログラム名を明示):

{
  "permissions": {
    "allow": ["Bash(npm run test:*)", "Bash(git status)"]
  }
}

常に block を返すフックの確認

次のようなフックは、判定条件がないと全呼び出しをブロックし始める可能性があります。

#!/bin/bash
# Before: 条件なしで常に block
echo '{"decision": "block", "reason": "ログ用フックのつもりだった"}'
#!/bin/bash
# After: 本当にブロックしたい条件のときだけ block を返す
input=$(cat)
if echo "$input" | grep -q "rm -rf"; then
  echo '{"decision": "block", "reason": "危険なコマンド"}'
fi
exit 0

OTel にホスト情報を含める(任意)

export OTEL_RESOURCE_INCLUDE_HOST=1

デフォルトはオフです。有効にすると host.name と host.id が送信されます。ホスト名が外部に出るため、収集先のポリシーを確認したうえで有効化してください。

まとめ

  • v2.1.326 は、サンドボックス・権限チェック・auto mode・フック・PowerShell・プラグイン を一斉に厳しくするリリースです。
  • bypass permissions モードでも確認・拒否が起こる ため、無人実行や CI は最優先で見直してください。
  • サンドボックスは機密ホームフォルダへの書き込みが既定で不可になりました。必要なパスは sandbox.filesystem.allowWrite で許可します。
  • managed の autoMode.environment は "$defaults" を含めないと組み込みエントリが全置換されます。
  • 常に "decision": "block" を出すフックは、ブロックを始める可能性があります。
  • 不正な plugin.json で拒否されていたプラグインが、フックや MCP サーバーごと読み込まれます。管理者は配布物を確認してください。
  • opusplan では plan mode のコンパクションが Opus で行われ、コストが増える可能性があります。
  • 一方で、診断表示の充実、MCP の並列呼び出し結果の取り違え修正、/update-config のトークン削減(約93,000→約13,000)といった改善も入っています。

安全側への変更が中心なので、更新前に権限設定とフックを棚卸ししておくと、更新後の混乱を減らせます。なお --bare セッションの変更など、一部は入力データが途中で切れていて詳細を確認できていません。最終的には 公式リリースノート を参照してください。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?