Claude Media
Claude Code v2.1.326 — サンドボックスの書き込み先が減り、確認が増える

Claude Code v2.1.326 — サンドボックスの書き込み先が減り、確認が増える

Claude Code v2.1.326はCode Modeをagent teamsと併用でき、サンドボックスの書き込み先を絞ります。許可フラグの不備を起動時に警告し、権限とログインまわりの修正が続きます。

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

Claude Code v2.1.326の新機能は、ターミナル向けが10件、VS Code拡張向けが1件です。大半は修正と挙動の変更で、前のv2.1.325に続いて権限とサンドボックスを締める方向が目立ちます。

数字

v2.1.326のchangelog内訳

  • 項目の合計

    367

    VS Code向け17件を含む

  • Fixed

    217

    修正が6割弱

  • Improved

    57

  • Changed

    57

    権限・サンドボックスが中心

項目の先頭語で数えた件数

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

  • Code Modeを、agent teamsを有効にしたまま使えるようになった
  • --allowedTools・--disallowedTools・--tools に完全なルールに見えない値があると、起動時に警告が出る
  • /status に、プロバイダーや DISABLE_TELEMETRY で機能が止まっていることを示す行が加わった
  • サンドボックス内のコマンドが書き込める先が、既定で減った

自動実行やCIで回している環境では、4つ目が先に効きます。サンドボックスの選び方を手元に置いて読むと、影響範囲を追いやすくなります。

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

許可フラグをCLIやCIで渡しているとき

--allowedTools、--disallowedTools、--tools に渡した値の中に、完全なルールに見えない項目があると、起動時に警告が出ます。タイプミスで効いていないルールに気づけるようになります。

ルールの書き方は、公式のCLIリファレンスでは次の形です。

claude -p "直近のコミットを要約して" \
  --allowedTools "Bash(git log *)" "Read"

もう1つ、複数の値を受け取るオプションの後ろに書いたプロンプトが、メッセージなしで捨てられていた不具合が直りました。--add-dir と --allowedTools が対象として挙がっています。CIのログに「プロンプトが空だった」跡があった場合は、この件を疑えます。

サンドボックスを有効にしているとき

サンドボックス内のコマンドは、macOS・Linux・WSLで、機微なホームフォルダーの一部に書き込めなくなりました。そのうち一部は、ユーザー設定かmanaged settingsの sandbox.filesystem.allowWrite で許可できます。許可先として挙がっているのはユーザー設定とmanaged settingsで、プロジェクトの設定ファイルは含まれていません。

公式のサンドボックスの解説にある書き方は次のとおりです。パスは例です。

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "allowWrite": ["~/.kube", "/tmp/build"]
    }
  }
}

LinuxとWSL2では、まだ存在しないパスを指定しても効かないため、先にパスを作っておきます。

ほかにも、サンドボックスまわりで挙動が変わった項目があります。

  • Linux・WSLでは、存在しない --add-dir のフォルダーの一部を、サンドボックス内のコマンドの前に作成する。そのフォルダーを作るコマンドは、失敗するか、何もしないか、すでにあるフォルダーの中に作る形になる
  • コマンドの後に、リポジトリの .git フォルダーにある想定外の項目を脇へ退避する
  • 環境変数を設定する行の一部は、自動許可がオフのとき確認が入る。人がいない実行では拒否される場合がある
  • /rewind は、サンドボックスがオンのとき一部のファイルを触らず、スキップとして報告する

空のファイルが残る問題も直りました。サンドボックス内のコマンドの実行中にClaude Codeを止めると、Linuxで .git/config.lock を含む空のファイルがプロジェクトに残ることがありました。

追加ディレクトリを渡しているとき

ローカルのターミナルでは、--add-dir と /add-dir が、まだ信頼していないフォルダーに信頼の確認を出します。claude --bg はそのようなフォルダーを拒否します。無人のジョブで追加ディレクトリを渡している場合は、先にそのフォルダーを信頼済みにしておく必要があります。

Code Modeとagent teamsを試しているとき

Code Modeは、v2.1.323で入った実験的なオプトインです。Claudeが書いたJavaScriptでツールを呼びます。詳細はv2.1.323の解説にあります。

今回、agent teamsを有効にしたままCode Modeを入れられるようになりました。すでにCode Modeをオンにしていた場合は、チームを使うセッションもCode Modeで始まります。agent teamsは複数のセッションが協調するため、トークン消費が増えやすい機能です。両方を重ねる前に、使う範囲を絞るほうが無難です。

Code Mode絡みの修正も3件あります。

  • autoモードでインライン ! コマンドが承認待ちになるとき、スキルやスラッシュコマンドの読み込みが失敗していた。Claudeに実行を頼む形になった
  • Code Modeで起動したバックグラウンドのサブエージェントが、インライン ! コマンドを含むスキルを事前に読み込むと失敗していた
  • modが $.tool.call と $.tool.check でBashやReadを使えなかった

プラグインを配布・管理しているとき

plugin.json の author や homepage のような表示用の欄が壊れていると、これまではそのプラグインが有効化を拒否されていました。v2.1.326では、欄を無視して読み込みます。hooksとMCPサーバーも動きます。無視された欄は、/plugin と claude plugin list に注記として出ます。

管理者にとっては、これまで止まっていたプラグインが動き出す変更です。配布しているプラグインに壊れた欄がないか、先に確認しておけます。

プラグインのアンインストールは、プラグインのMCPバンドル(.mcpb、.dxt)から展開したファイルも消します。同じバンドルを別のプラグインが使っていれば残ります。

主な変更点

権限とサンドボックス(Changed)

項目内容
auto mode内容対象を絞らないワイルドカードの許可ルール(プログラム名のないもの、$HOME で始まるもの)を無視し、安全確認が判定する
auto mode内容Windowsのバックスラッシュのパスで始まるワイルドカード許可を判定し、拒否される場合がある。.\ で始まるルールの復活は予定と書かれている
bypass permissions内容一部のツール呼び出しが、確認待ちか、聞けない環境では拒否になる
ファイルツール内容.credentials.json など、サインイン用ファイルへの書き込みを拒否する
フック内容"decision": "block" が効く場面が増える。毎回この出力を返すフックは、これまで通っていた呼び出しを止めることがある
HTTPフック内容headers の Content-Length と Transfer-Encoding を無視し、長さは本体から決める
claude mcp serve内容sandbox.excludedCommands を無視する
worktree内容隔離したサブエージェントは、共有ブランチを書き換えるおそれのある一部のgitコマンドを拒否する。ExitWorktree は、バックグラウンドの処理が残っていると削除を拒否する

ExitWorktree は、Claudeが discard_changes を渡したときだけ削除できます。

MCP

  • managed-mcp.json を管理者がセッション中に足すと、MCPサーバーの読み込みが止まる理由が表示される。反映は次の確認の時点になることがあり、開いているセッションは再起動して全体に適用する。併用するChromeの設定はmanaged-mcp.jsonとの併用の解説にある
  • headersHelper が失敗した場合、または信頼していないフォルダーで実行されなかった場合に、保存済みのOAuthリフレッシュトークンを持たない多くのサーバーが、別のセッションでも外れた状態で始まる不具合を修正した。設定方法はheadersHelperの導入手順にある
  • 並列のMCPツール呼び出しで、長い結果が同じミリ秒に2つ届くと、別の呼び出しの保存結果を読む不具合を修正した
  • ツール検索が、正確な名前を頼んでも別のMCPサーバーのツールを読み込むことがあった。直った後は、そのツールについて再度確認を求められる場合がある
  • claude mcp add-json が「Invalid configuration: : Invalid input」としか返さなかった問題を直し、直す箇所を示すようにした

認証とログイン

  • /login の「Sign in with your Console account」が、ブラウザーでClaudeのプランにサインインしたときでも、サブスクリプションのログインを置き換えなくなった
  • 承認済みの ANTHROPIC_API_KEY が使われ続けているとき、/login は「Login successful」で終わらず、リクエストが引き続きキーを使うと伝える。「Not logged in」と /status も、使われていないキーに触れる
  • 貼り付けたサインインコードが claude auth login で見えず、誤りに気づけなかった問題を修正。/login と claude setup-token は、コードの送信後に「Finishing sign-in…」を出す
  • Consoleプロファイルの認証情報だけがフォルダーのタイムスタンプを拒否するドライブ上にあるとき、claude auth logout が認証情報を残し、トークンの更新も失敗する不具合を修正

費用とコンテキストに関わる変更

  • plan modeの自動圧縮は、いま答えているモデルで動く。opusplan ならOpusなので、費用が増える場合がある
  • 返信が使用量クレジットで課金された後に、自動のセッション要約を送らなくなった。/recap は使える
  • 古いClaude Codeが残した値のせいで、autoモードがローカルの分類器にとどまる不具合を修正。この分類器は使用量に数えられる
  • max_tokens がモデルの上限を超えたとき、Anthropic APIが示す上限で再試行する
  • Vertex AIで画像の多いセッションが、リクエストサイズ30 MBの400エラーで固まる問題を修正。圧縮してから再試行する
  • /update-config の使うコンテキストは、約93,000トークンから約13,000トークンになった

可観測性と管理

OTEL_RESOURCE_INCLUDE_HOST が加わり、OpenTelemetryのリソース属性に host.name と host.id を含められます。既定はオフです。

ホスト名だけなら、公式のモニタリング解説にある既存の方法があります。OTEL_RESOURCE_ATTRIBUTES に値を直接書きます。Claude Codeは値を展開しないため、$(hostname) と書くとその文字列のまま届きます。

export OTEL_RESOURCE_ATTRIBUTES="host.name=build-7"

管理設定のPreToolUseフックが直接のツール呼び出しを拒否したときに、OpenTelemetryの tool_decision イベントと permission_denials の項目が残らない問題も直りました。拒否の集計を取っている場合は、その数が増えます。拒否と承認待ちの見方はsafety_eventの解説にあります。

Cowork cloudのセッションは、組織のOpenTelemetry出力を最初のターンまで保留します。メッセージのないセッションは何も送らないため、claude_code.session.count が減ることがあります。

Remote Controlと復元まわり

  • 返信の途中でサーバーが一時的に使えなくなると、セッションが切れていた不具合が直りました
  • /remote-control のQRコードが、80×24のような短いウィンドウで欠ける問題を修正
  • スマホやWebのStopが、バックグラウンドのサブエージェントもターンと一緒に止めるようになった。以前は、ターミナルのセッションがスマホ上で待機中に見えていても、サブエージェントは動き続けていた
  • 前のターンが空の返信で終わった後にクラッシュすると、再開したセッションが直近のターンを失う不具合を修正
  • メモリー不足のときに、再開したセッションが以前の会話履歴を失っていた不具合が直りました
  • /rewind が、遅いバックアップのコピーが続いている間に /branch を2回実行すると、ファイルの一部しか戻さない不具合と、シェルコマンドが変えたファイルを戻せないのに「No code changes」と出す不具合を修正。追跡できなかったターンは「Code changes unknown」と出る

画面と入力

ターミナルの表示と入力の修正も多数入りました。たとえばフルスクリーンの転写が空白になる、入力中の下書きが消える、貼り付けた画像が落ちる、プロンプトの折り返し位置でカーソルがずれる、といった問題が挙がっています。日本語の返信では、句読点で始まる・終わる太字が生の ** で見える問題も直りました。

  • /clear --help のような組み込みコマンドが、使い方を表示せずに実行されていた。/help <command> が加わった
  • claude --help | less のようにページャーに渡したとき、矢印キーと q が効かなかった問題を修正
  • 利用できない機能が出す「Unknown command」の代わりに、プロバイダー、サインイン、DISABLE_TELEMETRY などの環境変数が原因であることを示す

VS Code拡張では、claudeCode.promptSuggestions の設定でプロンプトの提案をオフにできるようになりました。フォークした会話の「Rewind code to here」が1ターン余分に戻して、そのターンで作ったファイルを消すことがあった問題も直っています。

利用形態ごとの影響

使い方影響理由
サンドボックス内のBashで外部ツールを回す影響条件次第理由ホームの一部への書き込みが既定で閉じる。allowWrite で戻せるものもある
claude -p やCIに許可フラグを渡す影響条件次第理由不完全なルールが起動時に警告される。直ればそのまま動く
agent teamsとCode Modeを併用する影響明確な恩恵あり理由併用の制限がなくなった
壊れた欄のあるプラグインを配布する影響条件次第理由拒否されていたものが読み込まれる。内容の確認が先に要る
Remote Controlを使う影響明確な恩恵あり理由切断・QRコード・Stopの動きが直った
VS Code拡張が中心影響条件次第理由サインイン・メモリーの一覧・Rewindなどの修正が並ぶ

サンドボックスの権限は3リリースでどこまで締まったか

権限とサンドボックスの変更は、直近の3リリースで同じ向きに進んでいます。

あゆみ

権限まわりの流れ

  1. v2.1.323Code Modeの追加と、確認が抜ける経路の修正

    Code Modeが実験的に入りました。Bashの許可ルールとサンドボックスで、確認が出ないまま通っていた経路が締められました。

  2. v2.1.325サンドボックス内Bashの自動承認が既定でなくなる

    サンドボックス内のBashは、通常の許可フローに従うようになりました。

  3. v2.1.326書き込み先と判定の絞り込み

    サンドボックスが書き込めるホームのフォルダーが減り、autoモードとbypass permissionsの判定にも変更が入りました。

詳しい経緯はv2.1.325の解説にあります。

v2.1.325とv2.1.326では、効く箇所が違います。v2.1.325は「確認を出すか」、v2.1.326は「どこまで書けるか」です。無人運転の設定は、両方を満たしてはじめて以前と同じ動きになります。

まとめ

追加機能が目的なら、Code Modeとagent teamsの併用、/help <command>、OTEL_RESOURCE_INCLUDE_HOST が候補です。ただし、Code Modeは実験的です。OTEL_RESOURCE_INCLUDE_HOST は、実際に届く属性を確かめてから広げる選択肢があります。

運用面では、サンドボックスの書き込み先とautoモードのワイルドカードルールが先に効きます。CIやバックグラウンドのジョブで外部ツールを回している環境は、更新後に最初の数回の実行ログを見ると、止まった箇所が分かります。

Claude Codeの全体像は、下の関連ガイドにまとめています。

関連ガイド

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

参照した一次ソース

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

  1. code.claude.com/docs/en/changelog
  2. github.com/anthropics/claude-code/releases/tag/v2.1.326
  3. code.claude.com/docs/en/sandboxing
  4. code.claude.com/docs/en/monitoring-usage
この記事を共有:XはてブLinkedIn