ツールリファレンス

このページは、Anthropicが提供するツールと、任意のツール定義に設定できるオプションのプロパティのリファレンスです。ツール使用の概念的な紹介については、Claudeでのツール使用を参照してください。アプリケーションでツール使用を実装するためのガイダンスについては、ツールの定義を参照してください。



Anthropicが提供するツール

Anthropicは2種類のツールを提供しています。Anthropicのインフラストラクチャ上で実行されるサーバーツールと、Anthropicがスキーマを定義しアプリケーション側で実行を処理するクライアントツールです。どちらの種類も、ユーザー定義ツールと並んでリクエストのtools配列に含まれます。

モデルの互換性については、各ツールのページを参照してください。サポートされるモデルはツールおよびツールのバージョンによって異なります。



ツールのバージョニング

Anthropicが提供するほとんどのツールは、type文字列に_YYYYMMDDサフィックスが付いています。ツールの動作、スキーマ、またはモデルサポートが変更されると、新しいバージョンがリリースされます。既存の統合が引き続き動作するように、古いバージョンも利用可能なままです。

ツールに複数のアクティブなバージョンがある場合、それらの関係はさまざまです：

• 機能ベース： web_search_20260209とweb_fetch_20260209は、前バージョンに動的コンテンツフィルタリングを追加します。web_fetch_20260309はキャッシュバイパスオプションを追加します。web_search_20260318とweb_fetch_20260318はレスポンス包含制御を追加します。code_execution_20260120はサンドボックス内からのプログラマティックツール呼び出しを追加します。code_execution_20260521はツールの説明にセルごとの時間制限を開示します。いずれの場合も、新旧両方のバージョンが現行です。どちらを使用するかは、新しい機能が必要かどうかによります。
• モデルベース： text_editor_20250728はClaude 4モデル用で、text_editor_20250124はそれ以前のモデル用です。使用するバージョンは、対象とするモデルによって決まります。
• バージョンではなくバリアント： tool_search_tool_regex_20251119とtool_search_tool_bm25_20251119は、同時にリリースされた2つの検索アルゴリズムです。どちらも他方を置き換えるものではありません。
• レガシー： code_execution_20250522はPythonのみをサポートします。code_execution_20250825はBashとファイル操作を追加します。

mcp_toolsetタイプは日付によるバージョニングがされていません。代わりにanthropic-betaヘッダーでバージョニングが行われます。



ツール定義プロパティ

tools配列内のすべてのツール（ユーザー定義ツールを含む）は、ツールのロード方法、呼び出し可能な主体、入力の検証方法を制御するオプションのプロパティを受け付けます。これらのプロパティは組み合わせ可能です。同じツールにdefer_loading、cache_control、strictを設定できます。



allowed_callersの値

allowed_callersは、以下の任意の組み合わせを受け付ける配列です：

"code_execution_20260120"と"code_execution_20260521"はどちらもallowed_callersで受け付けられ、互換性があります。どちらかのコード実行ツールバージョンを使用するリクエストは、どちらかの呼び出し元をリストしているツールの条件を満たします。レスポンスブロックは、リクエストで宣言されたバージョンに関係なく、常に呼び出し元をcode_execution_20260120としてタグ付けします。

配列から"direct"を省略すると（例："allowed_callers": ["code_execution_20260120"]）、Claudeはコード実行内からのみツールを呼び出すように誘導されます。レスポンスのtool_useブロックには、どの呼び出し元がツールを呼び出したかを識別するcallerフィールドが含まれます。callerレスポンスの形式やエラー動作を含む詳細な説明については、プログラマティックツール呼び出しを参照してください。



defer_loadingとプロンプトキャッシング

defer_loading: trueが設定されたツールは、キャッシュキーが計算される前にレンダリングされたツールセクションから除外されます。これらはシステムプロンプトのプレフィックスにはまったく表示されません。ツール検索が遅延ツールを発見し、そのツールのtool_referenceを返すと、ツールの完全な定義はプレフィックスではなく、会話本文のその位置にインラインで展開されます。

つまり、defer_loading: trueはプロンプトキャッシュを保持します。既存のキャッシュエントリを無効化することなく、遅延ツールをリクエストに追加できます。また、ツールが発見されたターンとツールが呼び出されたターンの両方でキャッシュは有効なままです。

defer_loadingとcache_controlブレークポイントを組み合わせる方法については、ツール検索ツールのプロンプトキャッシングガイダンスを参照してください。