ツールリファレンス

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

Anthropic提供のツール

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

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

ツールのバージョン管理

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

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

• 機能キー付き： web_search_20260209とweb_fetch_20260209は、前身に対して動的コンテンツフィルタリングを追加します。code_execution_20260120は、サンドボックス内からプログラマティックツール呼び出しを追加します。各場合において、新しいバージョンと古いバージョンの両方が現在のものです。どちらを使用するかは、新しい機能が必要かどうかによって異なります。
• モデルキー付き： 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は、以下の任意の組み合わせを受け入れる配列です：

配列から"direct"を省略する（たとえば、"allowed_callers": ["code_execution_20260120"]）ことは、ツールがコード実行内からのみ呼び出し可能であることを意味します。レスポンスのtool_useブロックには、ツールを呼び出した呼び出し元を識別するcallerフィールドが含まれます。プログラマティックツール呼び出しを参照して、callerレスポンス形状とエラー動作を含む完全な説明を確認してください。

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

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

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

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