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/4 の公式ドキュメント更新:auto mode での hook 入力書き換えとサブエージェントの挙動

1
Posted at

2026-11-04 に追加された文は、auto mode の判定後に hook が入力を書き換えた場合の扱い、サブエージェントの effort とバックグラウンド実行の条件、IDE 拡張の自動インストール停止の 3 点に集中しています。これに加えて、トレース、サンドボックス、メモリ読み込みの確認手順が小さく補足されました。

auto mode の判定後に hook が入力を変えると、呼び出しが拒否されうる

hooks リファレンス、permission-modes、Agent SDK の hooks の 3 ページで、hook が絡む判定の扱いが追記されました。中心は auto mode と入力の書き換えの関係です。

PreToolUse hook は updatedInput でツール呼び出しの入力を書き換えられます。auto mode では、サーバー側が呼び出しを審査します。hook が審査後に入力を変えると、審査した内容と実行される内容がずれます。hooks リファレンスの追加文は、permissionDecision を返さない場合に auto mode が変更後の呼び出しを拒否しうると述べています。

With no permissionDecision , auto mode can deny the changed call

(出典 [1])

(訳:permissionDecision がない場合、auto mode は変更された呼び出しを拒否することがあります。)

permission-modes ページには、同じ挙動が hook または mod による変更として書かれています。審査後に入力が変わると、Claude Code は判定なしで拒否することがあります。対話端末と VS Code のセッションで、Anthropic API に直接接続している場合は、拒否メッセージに「hook がこの呼び出しの入力を auto mode の審査後に変更した」という趣旨の文が入ります。対処法は error entry に書かれているとのことですが、今回の追加文には中身がありません。

実務上の影響は、入力を書き換える hook を auto mode と併用している人に出ます。書き換えが原因の拒否は、権限ルールの不一致とは別の経路で起きます。メッセージの文言で切り分けられます。hooks リファレンスには "defer" の場合に ignored とする文もありますが、断片のため何が無視されるのかは不明です。

Agent SDK 側では、コールバックが失敗したときの扱いを決める onFailure が追加されています。値は "continue" か "block" で、既定は undefined と読めます。

to block the action when a callback fails

(出典 [6])

(訳:コールバックが失敗したときに、その操作をブロックします。)

SDK のコールバックはコマンド hook の既定に従う、とも書かれています。hook を安全装置として使っている場合、失敗時に通すか止めるかを明示的に選べるようになります。

サブエージェントの effort は、モデルが同じ場合だけ引き継がれる

sub-agents ページでは、effort のフィールドもパラメータもないサブエージェントの扱いが追記されました。メイン会話と同じモデルで動く場合、サブエージェントは /effort や --effort で選んだセッションのレベルで動きます。別のモデルで動く場合、そのレベルは適用されません。

On another model, that level doesn't apply

(出典 [2])

(訳:別のモデルでは、そのレベルは適用されません。)

cli-reference では --effort の説明が更新されています。メイン会話のモデルに対して modelSettings と effortLevel の設定を、そのセッションに限って上書きし、永続化されません。モデルを切り替えたサブエージェントを使う場合は、effort をセッション設定に任せず、サブエージェント定義側で指定する必要があります。

changelog には、サブエージェントの実行条件に関する変更が 3 件あります。

  • バックグラウンドのサブエージェントは、シェルコマンドを 3 分後(2026-11-04 時点)にバックグラウンドへ移します。対象は全プロバイダーです。理由はプロンプトキャッシュの失効を避けるためと書かれています。
  • Bedrock、Vertex、Foundry、またはテレメトリをオフにした環境では、キャッシュが冷えている場合に、サブエージェントの進捗要約が保留中の応答を最大 5 分(2026-11-04 時点)待つことがあります。
  • "Switch models when a message is flagged" が "Ask each time" のとき、サブエージェントはモデルを切り替えずに停止します。

長時間のシェルコマンドを走らせる運用や、プロバイダーを切り替えて使う運用では、待ち時間の見え方が変わる可能性があります。

IDE 拡張の自動インストールを止める手段が 2 か所に載った

changelog には、Claude Code が IDE 内のターミナルで起動されたときに、IDE 拡張をインストールも更新もしなくなったとあります。拡張を入れたい場合は、IDE の外のターミナルから /ide を使うか、エディターの拡張機能ビューから入れる形です。

Changed Claude Code to no longer install or update the IDE extension when started in an IDE terminal

(出典 [8])

(訳:IDE のターミナルで起動した場合、Claude Code は IDE 拡張をインストールも更新もしないように変更されました。)

env-vars ページには、CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL が載りました。1 を設定すると、/ide による IDE 拡張のインストールが止まります。この環境変数が上の changelog の変更と同じ仕組みに関係するのかは、ドキュメントに記載がなく不明です。拡張のバージョンを固定したい環境では、環境変数でインストール自体を止められる点が確認できます。

トレース、サンドボックス、メモリの確認手順の補足

monitoring-usage ページでは、ENABLE_BETA_TRACING_DETAILED について警告が追加されました。デバッグ用に限り、本番では設定しないよう求めています。

Detailed beta tracing has a high export volume, and its content attributes aren't part of the stable span schema.

(出典 [3])

(訳:詳細なベータトレースはエクスポート量が多く、その内容の属性は安定したスパンスキーマには含まれません。)

sandboxing ページでは、/sandbox のパネルに Dependencies タブしか表示されない場合、サンドボックスはまだ起動できないと説明されています。タブの指示に従って Linux と WSL2 のセットアップを済ませ、Claude Code を再起動し、/sandbox を再実行する流れです。memory ページでは、ファイルが読み込まれたかを /context all の Memory files の一覧で確認する手順が追加されました。フルスクリーンモードでは /context だけだとこの一覧が折りたたまれます。

その他の更新

  • 自己ホスト runner で、--release-idle-session-min が末尾で値なし、または空白のみの場合に起動時警告を出すようになりました。
  • クラウドセッションに No repository の選択肢が追加されました。
  • クラウドセッションに一般的な Chrome の名前が追加され、google-chrome や CHROME_PATH から内蔵 Chromium を見つけられるようになりました。
  • deniedMcpServers の URL エントリは、上流 URL が一致する Anthropic 提供サーバーも遮断するようになりました。
  • mod が prompt.submit で付加する内容は、system メッセージではなくユーザーのターンに留まるようになりました。
  • cli-reference には、v2.1.265 より前は system prompt 系フラグを渡すと記録もオフになったという記述が加わりました。記録の対象は、断片からは不明です。
  • --enable-auto-mode は v2.1.111 で削除されたと、cli-reference に記載されています。

まとめ

この日の更新で運用に影響が出るのは、次の 3 つの層です。auto mode と入力書き換え hook を併用している人は、審査後の変更による拒否が起きうる点を確認する必要があります。サブエージェントを別モデルで動かしている人は、effort がセッション設定から引き継がれない点に注意が必要です。長時間のシェルコマンドを使う人は、3 分(2026-11-04 時点)でバックグラウンドへ移る条件を把握しておく必要があります。IDE 拡張を管理している人は、環境変数による停止と changelog の変更を併せて確認することになります。いずれもドキュメントの追加文から読み取れる範囲で、詳細な条件は各ページの本文を参照する必要があります。

出典

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

[1] https://code.claude.com/docs/en/hooks
[2] https://code.claude.com/docs/en/sub-agents
[3] https://code.claude.com/docs/en/monitoring-usage
[4] https://code.claude.com/docs/en/permission-modes
[5] https://code.claude.com/docs/en/cli-reference
[6] https://code.claude.com/docs/en/agent-sdk/hooks
[7] https://code.claude.com/docs/en/sandboxing
[8] https://code.claude.com/docs/en/changelog
[9] https://code.claude.com/docs/en/env-vars
[10] https://code.claude.com/docs/en/memory

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?