Использование инструментов с Claude

Использование инструментов позволяет Claude вызывать функции, которые вы определяете или которые предоставляет Anthropic. Claude решает, когда вызвать инструмент, на основе запроса пользователя и описания инструмента, а затем возвращает структурированный вызов, который выполняет ваше приложение (клиентские инструменты) или который выполняет Anthropic (серверные инструменты).

Вот самый простой пример использования серверного инструмента, где Anthropic обрабатывает выполнение:

import anthropic

client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-opus-4-7",
    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)

Как работает использование инструментов

Инструменты отличаются в первую очередь тем, где выполняется код. Клиентские инструменты (включая определяемые пользователем инструменты и инструменты схемы Anthropic, такие как bash и text_editor) работают в вашем приложении: Claude отвечает с stop_reason: "tool_use" и одним или несколькими блоками tool_use, ваш код выполняет операцию, и вы отправляете обратно tool_result. Серверные инструменты (web_search, code_execution, web_fetch, tool_search) работают на инфраструктуре Anthropic: вы видите результаты напрямую без обработки выполнения.

Для полной концептуальной модели, включая цикл агента и когда выбирать каждый подход, см. Как работает использование инструментов.

Для подключения к серверам MCP см. MCP connector. Для создания собственного MCP-клиента см. modelcontextprotocol.io.

Доступ к инструментам — один из наиболее эффективных примитивов, которые вы можете дать агенту. На тестах, таких как LAB-Bench FigQA (интерпретация научных графиков) и SWE-bench (реальная инженерия программного обеспечения), добавление даже базовых инструментов дает непропорциональное увеличение возможностей, часто превосходя базовые показатели экспертов-людей.

Примеры использования инструментов

Для полного практического пошагового руководства см. tutorial. Для справочных примеров отдельных концепций см. Define tools и Handle tool calls.

Цены

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, the API also automatically includes 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.

Следующие шаги

Выберите свой путь