Claudeでのツール使用

ツール使用により、Claudeはユーザーが定義した関数やAnthropicが提供する関数を呼び出すことができます。Claudeはユーザーのリクエストとツールの説明に基づいてツールを呼び出すタイミングを判断し、アプリケーションが実行する（クライアントツール）またはAnthropicが実行する（サーバーツール）構造化された呼び出しを返します。

以下は、Anthropicが実行を処理するサーバーツールを使用した最もシンプルな例です。

import anthropic

client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    tools=[{"type": "web_search_20260209", "name": "web_search"}],
    messages=[{"role": "user", "content": "What's the latest on the Mars rover?"}],
)
print(response.content)

ツール使用の仕組み

ツールは主にコードが実行される場所によって異なります。クライアントツール（ユーザー定義ツールや、bashやtext_editorなどのAnthropicスキーマツールを含む）はアプリケーション内で実行されます。Claudeはstop_reason: "tool_use"と1つ以上のtool_useブロックで応答し、コードが操作を実行した後、tool_resultを返送します。サーバーツール（web_search、code_execution、web_fetch、tool_search）はAnthropicのインフラストラクチャ上で実行されます。実行を処理することなく、結果を直接確認できます。

エージェントループや各アプローチを選択するタイミングを含む完全な概念モデルについては、ツール使用の仕組みを参照してください。

MCPサーバーへの接続については、MCPコネクタを参照してください。独自のMCPクライアントを構築する場合は、modelcontextprotocol.ioを参照してください。

ツールアクセスは、エージェントに与えることができる最もレバレッジの高いプリミティブの1つです。LAB-Bench FigQA（科学的図表の解釈）やSWE-bench（実世界のソフトウェアエンジニアリング）などのベンチマークでは、基本的なツールを追加するだけでも大幅な能力向上が得られ、多くの場合、人間の専門家のベースラインを上回ります。

Claudeがツールを使用するタイミング

デフォルトのtool_choiceである{"type": "auto"}では、Claudeは各ターンでツールを呼び出すか直接応答するかを判断します。リクエストがそのツールの説明された機能に対応し、答えがまだコンテキストにない場合にツールを呼び出します。安定した知識、創造的なタスク、会話的なターンには直接応答します。

この境界はシステムプロンプトを通じて調整可能です。期待どおりにClaudeがツールを呼び出さない場合、"Use the tools to investigate before responding."（応答する前にツールを使用して調査してください）のような軽い指示でツール使用が測定可能なほど増加します。"Always call a tool first before responding."（応答する前に必ず最初にツールを呼び出してください）のようなより強い形式はさらに効果を高めます。逆に、"Use your judgment about whether to call a tool or respond directly."（ツールを呼び出すか直接応答するかは自分で判断してください）はトリガー動作を控えめに保ちます。

促しではなく確実な保証が必要な場合は、tool_choiceを使用してください。

各サーバーツールのページでは、それぞれのトリガー境界についてより詳しく説明しています。例として、ウェブ検索ツールやコード実行ツールを参照してください。

ツール使用の例

完全なハンズオンのウォークスルーについては、チュートリアルを参照してください。個々の概念のリファレンス例については、ツールの定義およびツール呼び出しの処理を参照してください。

料金

ツール使用リクエストは、以下に基づいて料金が計算されます。

1. モデルに送信される入力トークンの総数（tools パラメータに含まれるものを含む）
2. 生成される出力トークンの数
3. サーバーサイドツールの場合、追加の使用量ベースの料金（例：ウェブ検索は実行された検索ごとに課金）

クライアントサイドツールは他のClaude APIリクエストと同じ料金体系ですが、サーバーサイドツールはその特定の使用量に基づいて追加料金が発生する場合があります。

ツール使用による追加トークンは、以下から発生します。

• APIリクエスト内の tools パラメータ（ツール名、説明、スキーマ）
• APIリクエストおよびレスポンス内の tool_use コンテンツブロック
• APIリクエスト内の tool_result コンテンツブロック

tools を使用すると、APIはツール使用を有効にするための特別なシステムプロンプトをモデルに自動的に含めます。各モデルに必要なツール使用トークン数は以下のとおりです（上記の追加トークンを除く）。なお、この表は少なくとも1つのツールが提供されていることを前提としています。tools が提供されていない場合、ツール選択が none であれば追加のシステムプロンプトトークンは0になります。

これらのトークン数は、通常の入力および出力トークンに加算され、リクエストの総コストが計算されます。

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

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

次のステップ

パスを選択する