--- title: ツールリファレンス url: https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-reference description: Anthropic提供のサーバーツール、クライアントツール、クライアントツールセットの一覧と、オプションのツール定義プロパティのリファレンス。 --- このページは、Anthropicが提供するツールと、任意のツール定義に設定できるオプションのプロパティのリファレンスです。ツール使用の概念的な紹介については、[Claudeによるツール使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/overview)を参照してください。アプリケーションにツール使用を実装するためのガイダンスについては、[ツールを定義する](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/define-tools)を参照してください。 ## Anthropic提供のツール Anthropicは2種類のツールを提供しています。Anthropicのインフラストラクチャ上で実行される**「server tools」（サーバーツール）**と、Anthropicがスキーマを定義しアプリケーション側で実行を処理する**「client tools」（クライアントツール）**です。どちらの種類も、ユーザー定義ツールと並んでリクエストの `tools` 配列に含まれます。 | ツール | `type` | 実行 | [ベータヘッダー](https://platform.claude.com/docs/ja/api/beta-headers) | | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------------------- | | [Web検索ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-search-tool) | `web_search_20260318`
`web_search_20260209`
`web_search_20250305` | サーバー | なし | | [Webフェッチツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-fetch-tool) | `web_fetch_20260318`
`web_fetch_20260309`
`web_fetch_20260209`
`web_fetch_20250910` | サーバー | なし | | [コード実行ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/code-execution-tool) | `code_execution_20260521`
`code_execution_20260120`
`code_execution_20250825` | サーバー | なし | | [アドバイザーツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/advisor-tool) | `advisor_20260301` | サーバー | `advisor-tool-2026-03-01` | | [ツール検索ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-search-tool) | `tool_search_tool_regex_20251119`
`tool_search_tool_bm25_20251119` | サーバー | なし | | [MCPコネクター](https://platform.claude.com/docs/ja/agents-and-tools/mcp-connector) | `mcp_toolset` | サーバー | `mcp-client-2025-11-20` | | [メモリツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/memory-tool) | `memory_20250818` | クライアント | なし | | [Bashツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/bash-tool) | `bash_20250124` | クライアント | なし | | [テキストエディタツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/text-editor-tool) | `text_editor_20250728`
`text_editor_20250124` | クライアント | なし | | [コンピュータ使用ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/computer-use-tool) | `computer_toolset_20260801`
`computer_20251124`
`computer_20250124` | クライアント | なし
`computer-use-2025-11-24`
`computer-use-2025-01-24` | | [ブラウザ使用ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/browser-use-tool) | `browser_toolset_20260801` | クライアント | なし | モデルの互換性については、各ツールのページを参照してください。サポートされるモデルはツールおよびツールのバージョンによって異なります。モデルがWeb検索やコード実行を受け付けるかどうかをコードから確認するには、[Models APIの使用](https://platform.claude.com/docs/ja/models/overview#using-the-models-api)を参照してください。 ツール検索の `type` 値は、日付なしのエイリアスである `tool_search_tool_regex` と `tool_search_tool_bm25` も受け付けます。これらは 最新の日付付きバージョンに解決されます。 ### ツールのバージョニング Anthropic提供のツールのほとんどは、`type` 文字列に `_YYYYMMDD` のサフィックスを持ちます。ツールの動作、スキーマ、またはモデルサポートが変更されると、新しいバージョンがリリースされます。既存のインテグレーションが引き続き動作するよう、古いバージョンも利用可能なまま残されます。 ツールに複数のアクティブなバージョンがある場合、それらの関係はさまざまです。 * **機能による区別：** `web_search_20260209` と `web_fetch_20260209` は、前のバージョンに動的コンテンツフィルタリングを追加しています。`web_fetch_20260309` はキャッシュバイパスオプションを追加しています。`web_search_20260318` と `web_fetch_20260318` はレスポンスへの包含制御を追加しています。`code_execution_20260120` はサンドボックス内からの[プログラムによるツール呼び出し](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/programmatic-tool-calling)を追加しています。`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` バージョンの安定版の後継です。これらのベータ版は、[以前のツールバージョン](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions)に記載されているモデルで引き続き利用できます。`browser_toolset_20260801` はブラウザ使用ツールの最初のバージョンです。どちらも[クライアントツールセット](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-reference#client-toolsets)です。 `mcp_toolset` タイプは日付によるバージョン管理がされていません。代わりに、バージョニングは `anthropic-beta` ヘッダーで行われます。 ### クライアントツールセット [コンピュータ使用ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/computer-use-tool)と[ブラウザ使用ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/browser-use-tool)は、Anthropicが定義する「client toolsets」（クライアントツールセット）です。`tools` 内の1つのエントリが、Anthropicが名前、説明、入力スキーマを定義する固定のメンバーツールのセットを宣言し、アプリケーションがすべての呼び出しを実行します。日付付きの `type` によってメンバー名が固定されるため、エントリは `name` を取りません。`configs`、`cache_control`、および `allowed_callers`（`["direct"]` のみを受け付けます）はオプションです。 クライアントツールセットはMessages APIのツールです。現在、[Claude Managed Agents](https://platform.claude.com/docs/ja/managed-agents/tools)のエージェントツールとしては利用できません。Claude Managed Agentsは独自の組み込みエージェントツールセット、MCPツールセット、およびカスタムツールを提供しています。 ```json { "type": "browser_toolset_20260801", "configs": { "javascript_exec": { "enabled": true } }, "cache_control": { "type": "ephemeral" } } ``` `configs` は個々のメンバーを調整します。 * キーはメンバー名で、各値は `enabled` と `defer_loading` のみを受け付けます。 * 省略したメンバーはデフォルトを維持します。値の省略、`{}`、およびデフォルトの再指定は同等です。 * 不明なメンバー名やメンバーの値内のその他のフィールドは拒否されます。すべてのメンバーを無効にする `configs` も同様に拒否されます（代わりにエントリを省略してください）。 * 無効化されたメンバーは、Claudeが参照できるツールから削除されます。それでもClaudeがそのメンバーを指定した場合は、エラーの `tool_result` を返してください。 `defer_loading` はエントリではなく必ずメンバーごとに設定し、有効なすべてのメンバーに同じ値を指定してください。[ツール検索](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-search-tool#deferred-tool-loading)では、ツールセットは1つの定義として読み込まれ展開されます。有効なすべてのメンバーが遅延読み込みされる場合、それ自体が遅延読み込みされない[ツール検索ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-search-tool)のみがツールセットを表面化できるため、同じリクエスト内で1つ宣言してください。メンバーが遅延読み込みされるツールセットエントリには `cache_control` を設定しないでください。遅延読み込みされる定義はキャッシュされたプレフィックスの一部ではないため、代わりに遅延読み込みされないツールにブレークポイントを設定してください。 `cache_control` はエントリにのみ設定します。バッチアクション内のマーカーを含め、ブレークポイントがどこに配置されるかについては、[プロンプトキャッシングを伴うツール使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-use-with-prompt-caching#cache-control-on-tool-definitions)を参照してください。 **メンバーツールの呼び出しを処理する。** Claudeは、`name` がメンバー名で `toolset_name` が `computer` または `browser` である `tool_use` ブロックでメンバーを呼び出します。`input` にはそのメンバーのパラメータが含まれ、`action` フィールドはありません。カスタムツールがメンバーと同じ名前を持つ可能性があり、また2つのツールセットが `screenshot` などの名前を共有しているため、`toolset_name` と `name` のペアでディスパッチしてください。メンバーの結果のみが `toolset_name` をエコーします。1つのターン内の複数のメンバー呼び出しは、順番に実行するバッチアクションを形成します（[コンピュータ使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/computer-use-tool#batch-actions)、[ブラウザ使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/browser-use-tool#batch-actions)）。新しいメンバーは、新しい日付付きの `type` でのみ追加されます。 **ツールセットエントリでサポートされないもの。** APIは以下のそれぞれを `invalid_request_error` で拒否します。 * `strict: true` または `input_examples`。 * エントリ上の `defer_loading`、または `defer_loading` の値が異なる有効なメンバー（`configs` 内でメンバーごとに、すべて同じ値に設定してください）。 * `allowed_callers` 内のコード実行呼び出し元（[プログラムによるツール呼び出し](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/programmatic-tool-calling)は不可）。 * レガシーの `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` を設定できます。 | プロパティ | 目的 | 利用可能な対象 | 詳細ガイド | | ----------------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | `cache_control` | このツール定義にプロンプトキャッシュのブレークポイントを設定する | すべてのツール（`computer_toolset_20260801` と `browser_toolset_20260801` では、メンバーの `configs` 内ではなくツールセットエントリ自体に設定します） | [プロンプトキャッシング](https://platform.claude.com/docs/ja/build-with-claude/prompt-caching) | | `strict` | ツール名と入力に対するスキーマ検証を保証する | `mcp_toolset`、`computer_toolset_20260801`、`browser_toolset_20260801` を除くすべてのツール | [厳密なツール使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/strict-tool-use) | | `defer_loading` | ツールを初期のシステムプロンプトから除外し、ツール検索がそのツールの `tool_reference` を返したときにオンデマンドで読み込む | すべてのツール（`mcp_toolset` については[ツール設定](https://platform.claude.com/docs/ja/agents-and-tools/mcp-connector#mcp-toolset-configuration)を参照）。コンピュータ使用およびブラウザ使用ツールセットでは、`configs` 内でメンバーごとに設定します。[クライアントツールセット](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-reference#client-toolsets)を参照してください。 | [ツール検索ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-search-tool) | | `allowed_callers` | ツールを呼び出せる呼び出し元を制限する | `mcp_toolset` を除くすべてのツール（`computer_toolset_20260801` と `browser_toolset_20260801` では `["direct"]` のみ受け付けます。[クライアントツールセット](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-reference#client-toolsets)を参照） | [プログラムによるツール呼び出し](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/programmatic-tool-calling#the-allowed-callers-field) | | `input_examples` | Claudeがツールの呼び出し方を理解するのに役立つ入力オブジェクトの例を提供する | ユーザー定義ツールおよびAnthropicスキーマのクライアントツール（`computer_toolset_20260801` と `browser_toolset_20260801` を除く）。サーバーツールでは利用できません。 | [ツールを定義する](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/define-tools#providing-tool-use-examples) | | `eager_input_streaming` | このツールに対してきめ細かい入力ストリーミングを有効にする（`true`）か、標準のバッファ付きストリーミングを維持する（`false`） | ユーザー定義ツールのみ | [きめ細かいツールストリーミング](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/fine-grained-tool-streaming) | ### `allowed_callers` の値 `allowed_callers` は、以下の任意の組み合わせを受け付ける配列です。 | 値 | 意味 | | --------------------------- | ----------------------------------------------------------------------- | | `"direct"` | モデルは `tool_use` ブロックでこのツールを直接呼び出せます。`allowed_callers` が省略された場合のデフォルトです。 | | `"code_execution_20260120"` | `code_execution_20260120` 以降のサンドボックス内で実行されるコードがこのツールを呼び出せます。 | `"code_execution_20260120"` と `"code_execution_20260521"` はどちらも `allowed_callers` で受け付けられ、互換性があります。いずれかのコード実行ツールバージョンを使用するリクエストは、いずれかの呼び出し元をリストするツールの条件を満たします。レスポンスブロックは、リクエストがどのバージョンを宣言したかに関係なく、常に呼び出し元を `code_execution_20260120` としてタグ付けします。 配列から `"direct"` を省略すると（たとえば `"allowed_callers": ["code_execution_20260120"]`）、Claudeはコード実行内からのみツールを呼び出すよう誘導されます。レスポンスの `tool_use` ブロックには、どの呼び出し元がツールを呼び出したかを識別する `caller` フィールドが含まれます。`caller` のレスポンス形式やエラー動作を含む詳細については、[プログラムによるツール呼び出し](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/programmatic-tool-calling#the-allowed-callers-field)を参照してください。 ### `defer_loading` とプロンプトキャッシング `defer_loading: true` のツールは、キャッシュキーが計算される前にレンダリングされたツールセクションから取り除かれます。システムプロンプトのプレフィックスには一切現れません。ツール検索が遅延読み込みツールを発見してその `tool_reference` を返すと、ツールの完全な定義はプレフィックスではなく、会話本文のその時点でインライン展開されます。 つまり、`defer_loading: true` はプロンプトキャッシュを保持します。既存のキャッシュエントリを無効化することなく遅延読み込みツールをリクエストに追加でき、ツールが発見されるターンと呼び出されるターンをまたいでキャッシュは有効なままです。 `defer_loading` と `cache_control` ブレークポイントを組み合わせる方法については、[ツール検索ツールのプロンプトキャッシングに関するガイダンス](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-search-tool#prompt-caching)を参照してください。