Claudeでのツール使用

Claudeはツールや関数と連携する機能を備えており、Claudeの能力を拡張してより幅広いタスクを実行できます。

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

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-6",
    "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リクエストで指定する必要がありますが、あなた側での実装は不要です。

クライアントツール

以下の手順でクライアントツールをClaudeと統合します：

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

サーバーツール

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

ClaudeでMCPツールを使用する

Model Context Protocol (MCP)を使用するアプリケーションを構築している場合、MCPサーバーのツールをClaudeのMessages APIで直接使用できます。MCPツール定義は、Claudeのツールフォーマットに似たスキーマフォーマットを使用します。inputSchemaをinput_schemaにリネームするだけです。

MCPツールをClaudeフォーマットに変換する

MCPクライアントを構築してMCPサーバーでlist_tools()を呼び出すと、inputSchemaフィールドを持つツール定義を受け取ります。これらのツールをClaudeで使用するには、Claudeのフォーマットに変換します：

次に、これらの変換されたツールをClaudeに渡します：

Claudeがtool_useブロックで応答した場合、call_tool()を使用してMCPサーバー上でツールを実行し、tool_resultブロックで結果をClaudeに返します。

MCPクライアントの構築に関する完全なガイドについては、MCPクライアントの構築を参照してください。

ツール使用の例

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

料金

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.

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

現在のモデルごとの料金については、モデル概要テーブルをご参照ください。

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

次のステップ

クックブックで、すぐに実装できるツール使用のコード例のリポジトリをご覧ください：