新機能 / v2.1.293
mod向けtool.registerにisDeferredを追加
CHANGELOG 原文(英語)
Added isDeferred to $.tool.register for mods: false lists the tool's schema in the prompt from the start instead of behind tool search 公式の変更履歴を開く ↗ 日本語での補足
mod向けの$.tool.registerにisDeferredを追加。falseにすると、ツールのスキーマをtool search経由ではなく、最初からプロンプトに掲載する。
ドキュメント
ドキュメントの抜粋(参考訳)
ツール
ツールイベントは、Claude が読み込む説明から、呼び出しを実行するかどうかの決定まで、Claude が行う各ツール呼び出しの前後で発生します。
| Event | Fires when | A hook can return |
|---|---|---|
tool.call |
ツールが実行される直前 | next(e)、{ deny: reason }、または { result } |
tool.check |
tool.call と PreToolUse フックの後、Claude Code がそのツール呼び出しを実行してよいかを判定するとき。next(e) は、ルール、権限モード、これらのフックが到達した決定に解決されます。 |
next(e)、または decision を allow、ask、deny のいずれかに設定し、reason を省略可能とした { decision } |
tool.describe |
各ツールについて、その説明が初めて Claude に送られるときに 1 回。MCP ツールの場合は、Claude が tool search を通じてそのツールを読み込むときにもう 1 回発生し、e.description には読み込まれたツールについて Claude が読むテキストが設定されます。 |
{ description }。isDeferred を true に設定するとツールが tool search の背後に置かれ、false にすると事前に読み込まれます(省略可)。次のターンで変更後の説明を送るには、breakPromptCache: true を追加します。 |
tool.check のエージェントと組織に関するフィールド
tool.check フックでは、次のフィールドを読み取ることで、サブエージェントによる呼び出しとメイン会話による呼び出しを区別したり、コネクタツールについて組織が承認を必須にしているかどうかを確認したりできます。
e.agentId:サブエージェントまたはインプロセスのチームメイトが呼び出しを行った場合に設定され、メイン会話が呼び出しを行った場合には存在しませんe.ceiling:組織がコネクタツールをaskに設定している場合、その設定が Claude Code に反映されるセッションではaskになります
tool.check における e.agentId と e.ceiling には、Claude Code v2.1.290 以降が必要です。
tool.check の e.isReadOnly フィールド
tool.check フックでは、そのツールがこの呼び出しを読み取り専用として報告している場合、e.isReadOnly は true になります。そうでない場合、このフィールドは false ではなく存在しません。この値はツール自身の報告であるため、このフィールドだけを根拠に呼び出しを承認する前に、ツール呼び出しが読み取り専用かどうかを確認するを参照してください。
tool.check における e.isReadOnly には、Claude Code v2.1.304 以降が必要です。
取得日 · 2026-11-20