ツールリファレンス

このページは、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ブレークポイントを組み合わせる方法については、ツール検索ツールのプロンプトキャッシングガイダンスを参照してください。