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-sonnet-4-5",
    "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ブロックで応答するとき、MCPサーバーでcall_tool()を使用してツールを実行し、結果を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メトリクスの一部として入力トークン数と出力トークン数の両方を出力します。

次のステップ

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