ツールリファレンス

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

Anthropic提供のツール

Anthropicは2種類のツールを提供しています。Anthropicのインフラストラクチャ上で実行される「server tools」（サーバーツール）と、Anthropicがスキーマを定義しアプリケーション側で実行を処理する「client tools」（クライアントツール）です。どちらの種類も、ユーザー定義ツールと並んでリクエストの 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とファイル操作を追加しています。
• 後継： computer_toolset_20260801 は、ベータ版の computer_20251124 および computer_20250124 バージョンの安定版の後継です。これらのベータ版は、以前のツールバージョンに記載されているモデルで引き続き利用できます。browser_toolset_20260801 はブラウザ使用ツールの最初のバージョンです。どちらもクライアントツールセットです。

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

クライアントツールセット

コンピュータ使用ツールとブラウザ使用ツールは、Anthropicが定義する「client toolsets」（クライアントツールセット）です。tools 内の1つのエントリが、Anthropicが名前、説明、入力スキーマを定義する固定のメンバーツールのセットを宣言し、アプリケーションがすべての呼び出しを実行します。日付付きの type によってメンバー名が固定されるため、エントリは name を取りません。configs、cache_control、および allowed_callers（["direct"] のみを受け付けます）はオプションです。

クライアントツールセットはMessages APIのツールです。現在、Claude Managed Agentsのエージェントツールとしては利用できません。Claude Managed Agentsは独自の組み込みエージェントツールセット、MCPツールセット、およびカスタムツールを提供しています。

{
  "type": "browser_toolset_20260801",
  "configs": {
    "javascript_exec": { "enabled": true }
  },
  "cache_control": { "type": "ephemeral" }
}

configs は個々のメンバーを調整します。

• キーはメンバー名で、各値は enabled と defer_loading のみを受け付けます。
• 省略したメンバーはデフォルトを維持します。値の省略、{}、およびデフォルトの再指定は同等です。
• 不明なメンバー名やメンバーの値内のその他のフィールドは拒否されます。すべてのメンバーを無効にする configs も同様に拒否されます（代わりにエントリを省略してください）。
• 無効化されたメンバーは、Claudeが参照できるツールから削除されます。それでもClaudeがそのメンバーを指定した場合は、エラーの tool_result を返してください。

defer_loading はエントリではなく必ずメンバーごとに設定し、有効なすべてのメンバーに同じ値を指定してください。ツール検索では、ツールセットは1つの定義として読み込まれ展開されます。有効なすべてのメンバーが遅延読み込みされる場合、それ自体が遅延読み込みされないツール検索ツールのみがツールセットを表面化できるため、同じリクエスト内で1つ宣言してください。メンバーが遅延読み込みされるツールセットエントリには cache_control を設定しないでください。遅延読み込みされる定義はキャッシュされたプレフィックスの一部ではないため、代わりに遅延読み込みされないツールにブレークポイントを設定してください。

cache_control はエントリにのみ設定します。バッチアクション内のマーカーを含め、ブレークポイントがどこに配置されるかについては、プロンプトキャッシングを伴うツール使用を参照してください。

メンバーツールの呼び出しを処理する。 Claudeは、name がメンバー名で toolset_name が computer または browser である tool_use ブロックでメンバーを呼び出します。input にはそのメンバーのパラメータが含まれ、action フィールドはありません。カスタムツールがメンバーと同じ名前を持つ可能性があり、また2つのツールセットが screenshot などの名前を共有しているため、toolset_name と name のペアでディスパッチしてください。メンバーの結果のみが toolset_name をエコーします。1つのターン内の複数のメンバー呼び出しは、順番に実行するバッチアクションを形成します（コンピュータ使用、ブラウザ使用）。新しいメンバーは、新しい日付付きの type でのみ追加されます。

ツールセットエントリでサポートされないもの。 APIは以下のそれぞれを invalid_request_error で拒否します。

• strict: true または input_examples。
• エントリ上の defer_loading、または defer_loading の値が異なる有効なメンバー（configs 内でメンバーごとに、すべて同じ値に設定してください）。
• allowed_callers 内のコード実行呼び出し元（プログラムによるツール呼び出しは不可）。
• レガシーの fine-grained-tool-streaming-2025-05-14 ベータヘッダー。ストリーミングする場合、各メンバーの input は1つの完全な input_json_delta として届きます。
• ツールセットまたはメンバーを指定する tool タイプの tool_choice（auto、any、または none を使用してください）。
• 同じツールセットの2つのエントリ、またはそのツールセットの名前を持つ別のツール。たとえば、computer_toolset_20260801 と並んで computer という名前のツール、または browser_toolset_20260801 と並んで browser という名前のツール。2つのツールセットは一緒に宣言できます。

ツール定義プロパティ

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