Claudeのツール使用

Claudeはツールや関数と対話する能力を持ち、より幅広いタスクを実行するためにClaudeの機能を拡張することができます。

新しい包括的なツール使用コースを通じて、Claudeでのツール使用をマスターするために必要なすべてを学びましょう！このフォームを使用して、引き続きアイデアや提案を共有してください。

以下は、Messages APIを使用してClaudeにツールを提供する方法の例です：

Shell

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "tools": [
      {
        "name": "get_weather",
        "description": "Get the current weather in a given location",
        "input_schema": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "The city and state, e.g. San Francisco, CA"
            }
          },
          "required": ["location"]
        }
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "What is the weather like in San Francisco?"
      }
    ]
  }'

---

ツール使用の仕組み

Claudeは2種類のツールをサポートしています：

1. クライアントツール：あなたのシステム上で実行されるツールで、以下を含みます：

   • ユーザー定義のカスタムツール（あなたが作成して実装するもの）
   • コンピューター使用（ベータ）やテキストエディタなどのAnthropicが定義したツール（クライアント実装が必要）

2. サーバーツール：Anthropicのサーバー上で実行されるツール（ウェブ検索ツールなど）。これらのツールはAPIリクエストで指定する必要がありますが、あなた側での実装は必要ありません。

Anthropicが定義したツールは、モデルバージョン間の互換性を確保するためにバージョン付きの型（例：web_search_20250305、text_editor_20250124）を使用しています。

クライアントツール

クライアントツールをClaudeと統合するには、以下の手順に従います：

1. Claudeにツールとユーザープロンプトを提供する

   • クライアントツールの名前、説明、入力スキーマをAPIリクエストで定義します。
   • 「サンフランシスコの天気は？」などのように、これらのツールを必要とする可能性のあるユーザープロンプトを含めます。
2. Claudeがツールを使用することを決定する

   • Claudeはユーザーの質問に対して、どのツールが役立つかを評価します。
   • もしあれば、Claudeは適切にフォーマットされたツール使用リクエストを構築します。
   • クライアントツールの場合、APIレスポンスのstop_reasonはtool_useとなり、Claudeの意図を示します。
3. ツールを実行して結果を返す

   • Claudeのリクエストからツール名と入力を抽出します
   • あなたのシステム上でツールコードを実行します
   • 結果をtool_resultコンテンツブロックを含む新しいuserメッセージで返します
4. Claudeがツール結果を使用して応答を作成する

   • Claudeはツール結果を分析して、元のユーザープロンプトに対する最終的な応答を作成します。

注意：ステップ3と4はオプションです。一部のワークフローでは、Claudeのツール使用リクエスト（ステップ2）だけで十分で、結果をClaudeに送り返す必要がない場合もあります。

サーバーツール

サーバーツールは異なるワークフローに従います：

1. Claudeにツールとユーザープロンプトを提供する

   • ウェブ検索などのサーバーツールには、それぞれ独自のパラメータがあります。
   • 「AIに関する最新ニュースを検索して」などのように、これらのツールを必要とする可能性のあるユーザープロンプトを含めます。
2. Claudeがサーバーツールを実行する

   • Claudeはユーザーの質問に対して、サーバーツールが役立つかどうかを評価します。
   • もしそうなら、Claudeはツールを実行し、結果は自動的にClaudeの応答に組み込まれます。
3. Claudeがサーバーツール結果を使用して応答を作成する

   • Claudeはサーバーツール結果を分析して、元のユーザープロンプトに対する最終的な応答を作成します。
   • サーバーツールの実行には追加のユーザー操作は必要ありません。

---

ツール使用の例

以下は、さまざまなツール使用パターンとテクニックを示すコード例です。簡潔にするため、ツールは単純なものであり、ツールの説明は最適なパフォーマンスを確保するために理想的なものよりも短くなっています。

単一ツールの例

Shell

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "tools": [{
        "name": "get_weather",
        "description": "Get the current weather in a given location",
        "input_schema": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "The city and state, e.g. San Francisco, CA"
                },
                "unit": {
                    "type": "string",
                    "enum": ["celsius", "fahrenheit"],
                    "description": "The unit of temperature, either \"celsius\" or \"fahrenheit\""
                }
            },
            "required": ["location"]
        }
    }],
    "messages": [{"role": "user", "content": "What is the weather like in San Francisco?"}]
}'

Claudeは以下のような応答を返します：

JSON

{
  "id": "msg_01Aq9w938a90dw8q",
  "model": "claude-opus-4-20250514",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "<thinking>I need to call the get_weather function, and the user wants SF, which is likely San Francisco, CA.</thinking>"
    },
    {
      "type": "tool_use",
      "id": "toolu_01A09q90qw90lq917835lq9",
      "name": "get_weather",
      "input": {"location": "San Francisco, CA", "unit": "celsius"}
    }
  ]
}

次に、提供された入力でget_weather関数を実行し、結果を新しいuserメッセージで返す必要があります：

Shell

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "tools": [
        {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA"
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"],
                        "description": "The unit of temperature, either \"celsius\" or \"fahrenheit\""
                    }
                },
                "required": ["location"]
            }
        }
    ],
    "messages": [
        {
            "role": "user",
            "content": "What is the weather like in San Francisco?"
        },
        {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "<thinking>I need to use get_weather, and the user wants SF, which is likely San Francisco, CA.</thinking>"
                },
                {
                    "type": "tool_use",
                    "id": "toolu_01A09q90qw90lq917835lq9",
                    "name": "get_weather",
                    "input": {
                        "location": "San Francisco, CA",
                        "unit": "celsius"
                    }
                }
            ]
        },
        {
            "role": "user",
            "content": [
                {
                    "type": "tool_result",
                    "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
                    "content": "15 degrees"
                }
            ]
        }
    ]
}'

これにより、天気データを組み込んだClaudeの最終応答が表示されます：

JSON

{
  "id": "msg_01Aq9w938a90dw8q",
  "model": "claude-opus-4-20250514",
  "stop_reason": "stop_sequence",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "The current weather in San Francisco is 15 degrees Celsius (59 degrees Fahrenheit). It's a cool day in the city by the bay!"
    }
  ]
}

複数ツールの例

1つのリクエストで選択できる複数のツールをClaudeに提供することができます。以下は、get_weatherとget_timeの両方のツールを含む例で、ユーザーの質問は両方を尋ねています。

Shell

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "tools": [{
        "name": "get_weather",
        "description": "Get the current weather in a given location",
        "input_schema": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "The city and state, e.g. San Francisco, CA"
                },
                "unit": {
                    "type": "string",
                    "enum": ["celsius", "fahrenheit"],
                    "description": "The unit of temperature, either 'celsius' or 'fahrenheit'"
                }
            },
            "required": ["location"]
        }
    },
    {
        "name": "get_time",
        "description": "Get the current time in a given time zone",
        "input_schema": {
            "type": "object",
            "properties": {
                "timezone": {
                    "type": "string",
                    "description": "The IANA time zone name, e.g. America/Los_Angeles"
                }
            },
            "required": ["timezone"]
        }
    }],
    "messages": [{
        "role": "user",
        "content": "What is the weather like right now in New York? Also what time is it there?"
    }]
}'

この場合、Claudeはおそらく、ユーザーの質問に完全に答えるために、一度に1つずつ、2つの別々のツール（get_weatherとget_time）を使用しようとします。ただし、特に相互に依存していない場合は、2つのtool_useブロックを一度に出力することもあります。各ツールを実行し、単一のuserメッセージ内の別々のtool_resultブロックでその結果を返す必要があります。

情報の欠落

ユーザーのプロンプトにツールの必須パラメータをすべて埋めるのに十分な情報が含まれていない場合、Claude Opusはパラメータが欠けていることを認識し、それを尋ねる可能性が高くなります。Claude Sonnetは、特にツールリクエストを出力する前に考えるように促された場合、質問することがありますが、合理的な値を推測して最善を尽くすこともあります。

例えば、上記のget_weatherツールを使用して、場所を指定せずに「天気はどうですか？」とClaudeに尋ねた場合、特にClaude Sonnetは、ツール入力を推測する可能性があります：

JSON

{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "get_weather",
  "input": {"location": "New York, NY", "unit": "fahrenheit"}
}

この動作は、特により曖昧なプロンプトや、より知能の低いモデルでは保証されません。Claude Opusが必須パラメータを埋めるのに十分なコンテキストを持っていない場合、ツール呼び出しを行うのではなく、明確化のための質問で応答する可能性がはるかに高くなります。

連続的なツール

一部のタスクでは、あるツールの出力を別のツールの入力として使用するなど、複数のツールを順番に呼び出す必要がある場合があります。そのような場合、Claudeは一度に1つのツールを呼び出します。すべてのツールを一度に呼び出すように促された場合、Claudeは上流のツールのツール結果に依存している下流のツールのパラメータを推測する可能性があります。

以下は、get_locationツールを使用してユーザーの位置を取得し、その位置をget_weatherツールに渡す例です：

Shell

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "tools": [
        {
            "name": "get_location",
            "description": "Get the current user location based on their IP address. This tool has no parameters or arguments.",
            "input_schema": {
                "type": "object",
                "properties": {}
            }
        },
        {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA"
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"],
                        "description": "The unit of temperature, either 'celsius' or 'fahrenheit'"
                    }
                },
                "required": ["location"]
            }
        }
    ],
    "messages": [{
        "role": "user",
        "content": "What is the weather like where I am?"
    }]
}'

この場合、Claudeはまずget_locationツールを呼び出してユーザーの位置を取得します。tool_resultで位置を返した後、Claudeはその位置を使ってget_weatherを呼び出し、最終的な答えを得ます。

完全な会話は以下のようになるかもしれません：

役割	内容
ユーザー	私のいる場所の天気はどうですか？
アシスタント	<thinking>この質問に答えるには、まずget_locationツールを使用してユーザーの位置を特定する必要があります。その後、その位置をget_weatherツールに渡して、そこの現在の天気を調べることができます。</thinking>[get_locationのツール使用]
ユーザー	[一致するIDとSan Francisco, CAの結果を持つget_locationのツール結果]
アシスタント	[以下の入力を持つget_weatherのツール使用]{ “location”: “San Francisco, CA”, “unit”: “fahrenheit” }
ユーザー	[一致するIDと「59°F (15°C)、ほとんど曇り」の結果を持つget_weatherのツール結果]
アシスタント	あなたの現在地サンフランシスコの天気は現在59°F（15°C）でほとんど曇りです。市内はかなり涼しく曇った日です。外出する予定があれば、軽いジャケットを持っていくとよいでしょう。

この例は、Claudeが異なるソースからデータを収集する必要がある質問に答えるために、複数のツール呼び出しをどのように連鎖させることができるかを示しています。主なステップは次のとおりです：

1. Claudeはまず、天気の質問に答えるためにユーザーの位置が必要であることを認識し、get_locationツールを呼び出します。
2. ユーザー（つまりクライアントコード）は実際のget_location関数を実行し、結果「San Francisco, CA」をtool_resultブロックで返します。
3. 位置が分かったので、Claudeはget_weatherツールを呼び出し、locationパラメータとして「San Francisco, CA」を渡します（また、unitは必須パラメータではないため、推測されたunitパラメータも渡します）。
4. ユーザーは再び、提供された引数で実際のget_weather関数を実行し、別のtool_resultブロックで天気データを返します。
5. 最後に、Claudeは天気データを元の質問に対する自然言語の応答に組み込みます。

思考連鎖ツール使用

デフォルトでは、Claude Opusはツールが必要かどうか、どのツールを使用するか、適切なパラメータは何かを最もよく判断するために、ツール使用クエリに答える前に考えるように促されています。Claude SonnetとClaude Haikuは、できるだけツールを使用するように促され、不必要なツールを呼び出したり、欠けているパラメータを推測したりする可能性が高くなります。SonnetやHaikuがツール呼び出しを行う前にユーザークエリをより適切に評価するように促すには、次のプロンプトを使用できます：

思考連鎖プロンプト

関連するツール（利用可能な場合）を使用してユーザーのリクエストに答えてください。ツールを呼び出す前に、\<thinking>\</thinking>タグ内で分析を行ってください。まず、提供されたツールのうち、ユーザーのリクエストに答えるのに関連するツールがどれかを考えてください。次に、関連するツールの必須パラメータそれぞれについて、ユーザーが直接提供したか、値を推測するのに十分な情報を与えたかを判断してください。パラメータが推測できるかどうかを判断する際は、特定の値をサポートするかどうかを確認するために、すべてのコンテキストを慎重に検討してください。必須パラメータがすべて存在するか、合理的に推測できる場合は、思考タグを閉じてツール呼び出しに進んでください。ただし、必須パラメータの値の1つが欠けている場合は、関数を呼び出さず（欠けているパラメータのフィラーを使用しても呼び出さない）、代わりにユーザーに欠けているパラメータを提供するよう依頼してください。提供されていない場合、オプションのパラメータに関する詳細情報を求めないでください。

JSONモード

ツールを使用して、そのツールや関数を通じて出力を実行する意図がなくても、スキーマに従ったJSON出力をClaudeに生成させることができます。

このようにツールを使用する場合：

• 通常は単一のツールを提供したいでしょう
• モデルに明示的にそのツールを使用するよう指示するためにtool_choice（ツール使用の強制を参照）を設定する必要があります
• モデルがinputをツールに渡すことを忘れないでください。そのため、ツールの名前と説明はモデルの視点からのものであるべきです。

以下は、特定のフォーマットに従って画像を説明するためにrecord_summaryツールを使用しています。

Shell

#!/bin/bash
IMAGE_URL="https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
IMAGE_MEDIA_TYPE="image/jpeg"
IMAGE_BASE64=$(curl "$IMAGE_URL" | base64)

curl https://api.anthropic.com/v1/messages \
     --header "content-type: application/json" \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "tools": [{
        "name": "record_summary",
        "description": "Record summary of an image using well-structured JSON.",
        "input_schema": {
            "type": "object",
            "properties": {
                "key_colors": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
"r": { "type": "number", "description": "red value [0.0, 1.0]" },
"g": { "type": "number", "description": "green value [0.0, 1.0]" },
"b": { "type": "number", "description":  "blue value [0.0, 1.0]" },
"name": { "type": "string", "description": "Human-readable color name in snake_case, e.g. \"olive_green\" or \"turquoise\"" }
                        },
                        "required": [ "r", "g", "b", "name" ]
                    },
                    "description": "Key colors in the image. Limit to less than four."
                },
                "description": {
                    "type": "string",
                    "description": "Image description. One to two sentences max."
                },
                "estimated_year": {
                    "type": "integer",
                    "description": "Estimated year that the image was taken, if it is a photo. Only set this if the image appears to be non-fictional. Rough estimates are okay!"
                }
            },
            "required": [ "key_colors", "description" ]
        }
    }],
    "tool_choice": {"type": "tool", "name": "record_summary"},
    "messages": [
        {"role": "user", "content": [
            {"type": "image", "source": {
                "type": "base64",
                "media_type": "'$IMAGE_MEDIA_TYPE'",
                "data": "'$IMAGE_BASE64'"
            }},
            {"type": "text", "text": "Describe this image."}
        ]}
    ]
}'

---

価格

Tool use requests are priced based on:

1. The total number of input tokens sent to the model (including in the tools parameter)
2. The number of output tokens generated
3. For server-side tools, additional usage-based pricing (e.g., web search charges per search performed)

Client-side tools are priced the same as any other Claude API request, while server-side tools may incur additional charges based on their specific usage.

The additional tokens from tool use come from:

• The tools parameter in API requests (tool names, descriptions, and schemas)
• tool_use content blocks in API requests and responses
• tool_result content blocks in API requests

When you use tools, we also automatically include a special system prompt for the model which enables tool use. The number of tool use tokens required for each model are listed below (excluding the additional tokens listed above). Note that the table assumes at least 1 tool is provided. If no tools are provided, then a tool choice of none uses 0 additional system prompt tokens.

Model	Tool choice	Tool use system prompt token count
Claude Opus 4	auto, none any, tool	346 tokens 313 tokens
Claude Sonnet 4	auto, none any, tool	346 tokens 313 tokens
Claude Sonnet 3.7	auto, none any, tool	346 tokens 313 tokens
Claude Sonnet 3.5 (Oct)	auto, none any, tool	346 tokens 313 tokens
Claude Sonnet 3.5 (June)	auto, none any, tool	294 tokens 261 tokens
Claude Haiku 3.5	auto, none any, tool	264 tokens 340 tokens
Claude Opus 3	auto, none any, tool	530 tokens 281 tokens
Claude Sonnet 3	auto, none any, tool	159 tokens 235 tokens
Claude Haiku 3	auto, none any, tool	264 tokens 340 tokens

These token counts are added to your normal input and output tokens to calculate the total cost of a request.

現在のモデルごとの価格については、モデル概要表を参照してください。

ツール使用プロンプトを送信すると、他のAPIリクエストと同様に、レスポンスは報告されたusageメトリクスの一部として入力と出力の両方のトークン数を出力します。

---

次のステップ

クックブックにある実装可能なツール使用コード例のリポジトリを探索してください：

計算機ツール

正確な数値計算のためにClaudeと簡単な計算機ツールを統合する方法を学びましょう。

カスタマーサービスエージェント

サポートを強化するためにクライアントツールを活用する応答性の高いカスタマーサービスボットを構築します。

JSON抽出ツール

Claudeとツール使用が非構造化テキストから構造化データを抽出する方法を確認してください。