1
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?

11/7 の公式ドキュメント更新:サンドボックスの範囲と auto モードの分類器モデル

1
Posted at

2026-11-07 に更新された 5 ページは、いずれも「どこまでが対象で、どこからが対象外か」を書き足す内容でした。サンドボックスが覆わない範囲、auto モードの分類器に指定したモデルが使われない条件、フックの defer が働く条件、廃止された環境変数、ツール利用で加算されるトークン数が追記されています。

サンドボックスの外にあるもの

Bash sandbox のページには、サンドボックスを有効にしても制限が及ばない対象が追記されました。ツールごとの扱いの違いは、次の一文に集約されています。

A denyRead entry doesn't stop the Read tool, and allowedDomains doesn't limit WebFetch

(出典 [5])

(訳:denyRead の項目は Read ツールを止めず、allowedDomains は WebFetch を制限しません。)

この追加文は途中から始まっており、前後の文脈までは確認できません。ただ、sandbox の denyRead や allowedDomains を設定していても、Read ツールや WebFetch の制限は別に確認する必要があると読めます。

同じ箇所には、Claude Code が起動する他のプロセスも列挙されています。command hooks、ローカルの MCP サーバー、plugin monitors、LSP サーバー、status line コマンドや apiKeyHelper といった補助コマンドは、フルアクセスで動くと記載されています。mod についても、Claude Code 内部で自身のコードを実行するため、ファイルアクセス、ネットワークリクエスト、$.process で起動したプログラムはサンドボックスの対象外です。

さらに、設定によってはシェルコマンドもサンドボックス外で動きます。例として「自分で入力するコマンド」が挙がっていますが、追加文は途中で終わっていて詳細は不明です。

auto モードの分類器が使うモデルを debug ログで確認する

permission modes のページには、auto モードの分類器が実際にどのモデルを使ったかを確かめる手順が追加されました。環境変数 CLAUDE_CODE_AUTO_MODE_MODEL で指定したモデルが反映されているかを調べるものです。

手順は次のとおりです。

  • --debug-file を付けて auto モードのセッションを起動します。
  • Claude に curl https://example.com を実行させます。
  • ログで classifier_request_started を検索し、model= の後ろを読みます。

ここで自分の指定したモデルが出ていれば反映されています。別のモデルが出ている場合は、次のように ignoring の行を探します。

A different model after model= : search the log for ignoring CLAUDE_CODE_AUTO_MODE_MODEL

(出典 [3])

(訳:model= の後ろに別のモデルが出ている場合:ログで ignoring CLAUDE_CODE_AUTO_MODE_MODEL を検索します。)

そのような行が無ければ、セッション内で /status の Auto mode server を確認します。Enabled はサーバー側がそのセッションの呼び出しをレビューする設定、Disabled は指定モデルをまだ試していない状態とされています。

指定が使われない条件も表で整理されています。

  • Claude Opus 5、Sonnet 5.5、Opus 5.5、または組織の model policy が除外するモデルを指定した場合は、default classifier model がレビューします。
  • プロバイダーが指定モデルを提供できない場合は、分類チェックが失敗します。その結果、Claude Code は確認対象の各アクションを拒否します。

設定例は、~/.claude/settings.json の env に CLAUDE_CODE_AUTO_MODE_MODEL として claude-sonnet-4-6 を書く形です。

確認用の curl については、権限モードが auto であり、curl に一致する permission rule が無いことを確かめ、サンドボックスをオフにして再実行するよう書かれています。理由は追加文に記載がありません。サンドボックスの設定が検証結果に影響し得ると読めますが、詳細は不明です。

フックの defer は非対話モードの単一ツール呼び出しに限られる

hooks reference には、PreToolUse フックで返せる "defer" の適用条件が追記されました。

only in non-interactive mode with the -p flag, and only when Claude makes a single tool call in the turn

(出典 [4])

(訳:-p フック付きの非対話モードで、かつ Claude がそのターンで単一のツール呼び出しをする場合に限ります。)

条件を外れた場合の挙動も書かれています。対話セッションでは警告をログに出し、フックの結果を無視します。1 ターンに複数のツール呼び出しがある場合も警告付きで無視され、通常の権限フローに進みます。典型例は AskUserQuestion で、ユーザーに尋ねたくても回答できる端末が無い場面です。

結果の JSON では stop_reason が tool_deferred になり、deferred_tool_use フィールドにツールの id、name、input が入ります。続けて "There is no timeout or retry limit." と書かれています。追加文だけでは、何に対して制限が無いのかまでは判別できません。

ツール利用のシステムプロンプト分のトークンと、必須パラメータ不足時の挙動

tool use overview には、ツール利用時に加算されるシステムプロンプトのトークン数の表が更新されています。2026-11-07 時点の記載は次のとおりです。

  • Claude Opus 5.5、Sonnet 5.5、Haiku 5.5 は、tool choice が auto または none のとき 286 tokens です。
  • any または tool のときは 406 tokens と読めますが、表記上は Haiku 5.5 の行に続く形でのみ現れます。Opus 5 には、286 tokens と 406 tokens の両方が明記されています。
  • 旧世代では、Claude Opus 4.7 が 675 tokens(any/tool は 804 tokens)、Opus 4.8 が 290 tokens(同 410 tokens)です。

これらは通常の入力・出力トークンに加算されて料金計算に使われる、とされています。Opus 4.7 から Opus 5.5 への移行で、auto/none の値は 389 tokens 小さくなっています。

もう 1 点、必須パラメータが不足しているときの挙動が追記されました。

Claude Opus is much more likely to recognize that a parameter is missing and ask for it

(出典 [1])

(訳:Claude Opus は、パラメータが不足していることを認識して、それを尋ねる可能性がはるかに高くなります。)

「はるかに高い」の程度を示す数値は、追加文には含まれていません。

環境変数:mTLS 用の追加、ロック待機、廃止

env-vars のページでは、mTLS 認証用の変数が並んでいます。クライアント証明書のパスが CLAUDE_CODE_CLIENT_CERT、秘密鍵のパスが CLAUDE_CODE_CLIENT_KEY、暗号化された鍵のパスフレーズが CLAUDE_CODE_CLIENT_KEY_PASSPHRASE(任意)です。「v2.1.172 以降」「v2.1.318 以降」という要件も追加文に含まれています。ただし区切りから、どの変数の要件なのかは特定できません。

CLAUDE_CODE_CONFIG_LOCK_WAIT_MS は、claude mcp add のように user または local スコープの MCP サーバーを追加・削除するコマンドが、~/.claude.json のロック取得を待つ時間です。未設定なら約 10〜20 秒待ち、それより短い値を設定しても何も変わらないと書かれています。待ち時間を延ばす用途に限られる設定です。

廃止された変数もあります。

CLAUDE_CODE_CONNECT_TIMEOUT_MS Removed in v2.1.186 and now a no-op.

(出典 [2])

(訳:CLAUDE_CODE_CONNECT_TIMEOUT_MS は v2.1.186 で削除され、現在は何もしません。)

設定ファイルや起動スクリプトに残っていても、v2.1.186 以降は効果がありません。

その他の更新

  • 同じ env-vars のページに、legacy でサーバーを従来のハンドシェイクに固定し、auto で対応するサーバー種別を探る、という設定値の説明が追加されています。変数名は追加文からは特定できません。
  • hooks reference の追加文には目次テキストが含まれ、PreModelSwitch や PostModelSwitch などのイベント名が載っています。新規かどうかは追加文からは判別できません。

まとめ

この日の更新で運用が変わるのは、次の人たちです。

  • サンドボックスで権限を絞っている管理者は、Read ツール、WebFetch、フック、MCP サーバー、mod が別の扱いになる点を設計に織り込む必要があります。
  • auto モードで分類器のモデルを固定している利用者は、指定が反映されているかを debug ログで確認できます。
  • 非対話モードでフックから defer を使う場合は、-p かつ単一ツール呼び出しの条件を満たす必要があります。
  • API でツール利用を組み込む開発者は、モデルごとのシステムプロンプト分のトークンを見積もりに入れる必要があります。
  • 環境変数を管理している人は、CLAUDE_CODE_CONNECT_TIMEOUT_MS の設定が v2.1.186 以降は無効になっている点に注意が必要です。

出典

本稿の引用はすべて一次資料と逐語照合(verify_article 通過)のうえ掲載しています(2026-11-08 検証)。

[1] https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview
[2] https://code.claude.com/docs/en/env-vars
[3] https://code.claude.com/docs/en/permission-modes
[4] https://code.claude.com/docs/en/hooks
[5] https://code.claude.com/docs/en/sandboxing

1
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
1
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?