--- title: Справочник по инструментам url: https://platform.claude.com/docs/ru/agents-and-tools/tool-use/tool-reference description: Каталог предоставляемых Anthropic серверных инструментов, клиентских инструментов и клиентских наборов инструментов, а также справочник по необязательным свойствам определения инструментов. --- Эта страница представляет собой справочник по инструментам, которые предоставляет Anthropic, и по необязательным свойствам, которые вы можете задать в любом определении инструмента. Концептуальное введение в «tool use» (использование инструментов) см. в разделе [Использование инструментов с Claude](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/overview). Рекомендации по реализации использования инструментов в вашем приложении см. в разделе [Определение инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/define-tools). ## Инструменты, предоставляемые Anthropic Anthropic предоставляет два вида инструментов: **серверные инструменты** (server tools), которые выполняются в инфраструктуре Anthropic, и **клиентские инструменты** (client tools), для которых Anthropic определяет схему, а выполнение обрабатывает ваше приложение. Оба вида указываются в массиве `tools` вашего запроса наряду с любыми пользовательскими инструментами. | Инструмент | `type` | Выполнение | [Бета-заголовок](https://platform.claude.com/docs/ru/api/beta-headers) | | ---------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ---------- | ---------------------------------------------------------------------- | | [Инструмент веб-поиска](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/web-search-tool) | `web_search_20260318`
`web_search_20260209`
`web_search_20250305` | Сервер | Нет | | [Инструмент веб-загрузки](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/web-fetch-tool) | `web_fetch_20260318`
`web_fetch_20260309`
`web_fetch_20260209`
`web_fetch_20250910` | Сервер | Нет | | [Инструмент выполнения кода](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/code-execution-tool) | `code_execution_20260521`
`code_execution_20260120`
`code_execution_20250825` | Сервер | Нет | | [Инструмент-советник](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/advisor-tool) | `advisor_20260301` | Сервер | `advisor-tool-2026-03-01` | | [Инструмент поиска инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/tool-search-tool) | `tool_search_tool_regex_20251119`
`tool_search_tool_bm25_20251119` | Сервер | Нет | | [Коннектор MCP](https://platform.claude.com/docs/ru/agents-and-tools/mcp-connector) | `mcp_toolset` | Сервер | `mcp-client-2025-11-20` | | [Инструмент памяти](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/memory-tool) | `memory_20250818` | Клиент | Нет | | [Инструмент Bash](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/bash-tool) | `bash_20250124` | Клиент | Нет | | [Инструмент текстового редактора](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/text-editor-tool) | `text_editor_20250728`
`text_editor_20250124` | Клиент | Нет | | [Инструмент использования компьютера](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/computer-use-tool) | `computer_toolset_20260801`
`computer_20251124`
`computer_20250124` | Клиент | Нет
`computer-use-2025-11-24`
`computer-use-2025-01-24` | | [Инструмент использования браузера](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/browser-use-tool) | `browser_toolset_20260801` | Клиент | Нет | Сведения о совместимости с моделями см. на странице каждого инструмента. Поддерживаемые модели различаются в зависимости от инструмента и его версии. Чтобы проверить из кода, поддерживает ли модель веб-поиск или выполнение кода, см. раздел [Использование Models API](https://platform.claude.com/docs/ru/models/overview#using-the-models-api). Значения `type` для поиска инструментов также принимают псевдонимы без даты: `tool_search_tool_regex` и `tool_search_tool_bm25`. Они разрешаются в последнюю датированную версию. ### Версионирование инструментов Большинство инструментов, предоставляемых Anthropic, содержат суффикс `_YYYYMMDD` в строке `type`. Новая версия выпускается, когда меняется поведение инструмента, его схема или поддержка моделей. Старые версии остаются доступными, чтобы существующие интеграции продолжали работать. Когда у инструмента несколько активных версий, соотношение между ними различается: * **По возможностям:** `web_search_20260209` и `web_fetch_20260209` добавляют динамическую фильтрацию контента по сравнению со своими предшественниками; `web_fetch_20260309` добавляет возможность обхода кэша; `web_search_20260318` и `web_fetch_20260318` добавляют управление включением в ответ. `code_execution_20260120` добавляет [программный вызов инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/programmatic-tool-calling) изнутри песочницы; `code_execution_20260521` раскрывает ограничение времени на ячейку в описании инструмента. В каждом случае актуальны как новая, так и старая версии; какую из них использовать, зависит от того, нужна ли вам новая возможность. * **По моделям:** `text_editor_20250728` предназначен для моделей Claude 4 и более поздних, а `text_editor_20250124` — для более ранних моделей. Используемая версия зависит от целевой модели. * **Вариант, а не версия:** `tool_search_tool_regex_20251119` и `tool_search_tool_bm25_20251119` — это два алгоритма поиска, выпущенные одновременно. Ни один из них не заменяет другой. * **Устаревшая:** `code_execution_20250522` поддерживает только Python. `code_execution_20250825` добавляет Bash и операции с файлами. * **Преемник:** `computer_toolset_20260801` — стабильный преемник бета-версий `computer_20251124` и `computer_20250124`, которые остаются доступными на моделях, указанных для них в разделе [Более ранние версии инструмента](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions). `browser_toolset_20260801` — первая версия инструмента использования браузера. Оба являются [клиентскими наборами инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/tool-reference#client-toolsets). Тип `mcp_toolset` не версионируется по дате; вместо этого версионирование передаётся в заголовке `anthropic-beta`. ### Клиентские наборы инструментов [Инструмент использования компьютера](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/computer-use-tool) и [инструмент использования браузера](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/browser-use-tool) — это определяемые Anthropic «client toolsets» (клиентские наборы инструментов): одна запись в `tools` объявляет фиксированный набор инструментов-членов, чьи имена, описания и входные схемы определяет Anthropic, а ваше приложение выполняет каждый вызов. Запись не принимает `name`, поскольку датированный `type` фиксирует имена членов. `configs`, `cache_control` и `allowed_callers` (который принимает только `["direct"]`) необязательны. Клиентские наборы инструментов — это инструменты Messages API. В настоящее время они недоступны в качестве агентских инструментов в [Claude Managed Agents](https://platform.claude.com/docs/ru/managed-agents/tools), который предоставляет собственный встроенный агентский набор инструментов, наборы инструментов MCP и пользовательские инструменты. ```json { "type": "browser_toolset_20260801", "configs": { "javascript_exec": { "enabled": true } }, "cache_control": { "type": "ephemeral" } } ``` `configs` настраивает отдельных членов: * Ключи — это имена членов, и каждое значение принимает только `enabled` и `defer_loading`. * Член, который вы опустили, сохраняет значения по умолчанию. Отсутствующее значение, `{}` и повторно указанное значение по умолчанию эквивалентны. * Неизвестное имя члена или любое другое поле в значении члена отклоняется, как и `configs`, отключающий всех членов (вместо этого опустите запись). * Отключённый член удаляется из инструментов, которые видит Claude. Если Claude всё же называет его, верните `tool_result` с ошибкой. Задавайте `defer_loading` для каждого члена, никогда не на уровне записи, и присваивайте всем включённым членам одинаковое значение: при [поиске инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/tool-search-tool#deferred-tool-loading) набор инструментов загружается и разворачивается как одно определение. Когда все включённые члены отложены, обнаружить набор инструментов может только [инструмент поиска инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/tool-search-tool), который сам не отложен, поэтому объявите его в том же запросе. Не помещайте `cache_control` на запись набора инструментов, члены которого отложены; вместо этого установите точку разрыва на неотложенном инструменте, поскольку отложенные определения не входят в кэшируемый префикс. `cache_control` указывается только на уровне записи; чтобы узнать, где оказывается точка разрыва, включая маркеры внутри пакетного действия, см. [Использование инструментов с кэшированием подсказок](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/tool-use-with-prompt-caching#cache-control-on-tool-definitions). **Обработка вызовов инструментов-членов.** Claude вызывает член блоком `tool_use`, у которого `name` — имя члена, а `toolset_name` — `computer` или `browser`; `input` содержит параметры этого члена и не содержит поля `action`. Выполняйте диспетчеризацию по паре `toolset_name` и `name`, поскольку пользовательский инструмент может иметь то же имя, что и член, а два набора инструментов имеют общие имена, такие как `screenshot`. Только результаты членов возвращают `toolset_name`. Несколько вызовов членов за один ход образуют пакетное действие, которое вы выполняете по порядку ([использование компьютера](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/computer-use-tool#batch-actions), [использование браузера](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/browser-use-tool#batch-actions)). Новые члены появляются только с новым датированным `type`. **Не поддерживается для записей наборов инструментов.** API отклоняет каждое из следующего с ошибкой `invalid_request_error`: * `strict: true` или `input_examples`. * `defer_loading` на уровне записи или включённые члены с различающимися значениями `defer_loading` (задавайте его для каждого члена в `configs`, всем одинаковое значение). * Вызывающая сторона выполнения кода в `allowed_callers` (без [программного вызова инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/programmatic-tool-calling)). * Устаревший бета-заголовок `fine-grained-tool-streaming-2025-05-14`. При потоковой передаче `input` каждого члена поступает как один полный `input_json_delta`. * `tool_choice` типа `tool`, указывающий набор инструментов или член (используйте `auto`, `any` или `none`). * Две записи одного и того же набора инструментов или другой инструмент, носящий имя этого набора: инструмент с именем `computer` рядом с `computer_toolset_20260801` или инструмент с именем `browser` рядом с `browser_toolset_20260801`. Два набора инструментов можно объявлять вместе. ## Свойства определения инструмента Каждый инструмент в массиве `tools`, включая пользовательские инструменты, принимает необязательные свойства, которые управляют тем, как инструмент загружается, кто может его вызывать и как проверяются его входные данные. Эти свойства сочетаются: вы можете задать `defer_loading`, `cache_control` и `strict` для одного и того же инструмента. | Свойство | Назначение | Доступно для | Подробное руководство | | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `cache_control` | Установить точку разрыва кэша подсказок на этом определении инструмента | Все инструменты (для `computer_toolset_20260801` и `browser_toolset_20260801` задавайте его на самой записи набора инструментов, а не внутри `configs` членов) | [Кэширование подсказок](https://platform.claude.com/docs/ru/build-with-claude/prompt-caching) | | `strict` | Гарантировать проверку схемы для имён инструментов и входных данных | Все инструменты, кроме `mcp_toolset`, `computer_toolset_20260801` и `browser_toolset_20260801` | [Строгое использование инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/strict-tool-use) | | `defer_loading` | Исключить инструмент из начальной системной подсказки; загружать его по требованию, когда поиск инструментов возвращает для него `tool_reference` | Все инструменты (для `mcp_toolset` см. [конфигурацию инструментов](https://platform.claude.com/docs/ru/agents-and-tools/mcp-connector#mcp-toolset-configuration)). Для наборов инструментов использования компьютера и браузера задавайте его для каждого члена внутри `configs`; см. [Клиентские наборы инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/tool-reference#client-toolsets). | [Инструмент поиска инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/tool-search-tool) | | `allowed_callers` | Ограничить, какие вызывающие стороны могут вызывать инструмент | Все инструменты, кроме `mcp_toolset` (для `computer_toolset_20260801` и `browser_toolset_20260801` принимается только `["direct"]`; см. [Клиентские наборы инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/tool-reference#client-toolsets)) | [Программный вызов инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/programmatic-tool-calling#the-allowed-callers-field) | | `input_examples` | Предоставить примеры входных объектов, чтобы помочь Claude понять, как вызывать инструмент | Пользовательские инструменты и клиентские инструменты со схемой Anthropic, кроме `computer_toolset_20260801` и `browser_toolset_20260801`. Недоступно для серверных инструментов. | [Определение инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/define-tools#providing-tool-use-examples) | | `eager_input_streaming` | Включить детализированную потоковую передачу входных данных (`true`) или сохранить стандартную буферизованную потоковую передачу (`false`) для этого инструмента | Только пользовательские инструменты | [Детализированная потоковая передача инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/fine-grained-tool-streaming) | ### Значения `allowed_callers` `allowed_callers` — это массив, принимающий любую комбинацию следующих значений: | Значение | Смысл | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | `"direct"` | Модель может вызывать этот инструмент напрямую в блоке `tool_use`. Это значение по умолчанию, если `allowed_callers` опущен. | | `"code_execution_20260120"` | Код, выполняющийся внутри песочницы `code_execution_20260120` или более поздней, может вызывать этот инструмент. | И `"code_execution_20260120"`, и `"code_execution_20260521"` принимаются в `allowed_callers` и взаимозаменяемы: запрос, использующий любую из версий инструмента выполнения кода, удовлетворяет инструментам, в которых указана любая из этих вызывающих сторон. Блоки ответа всегда помечают вызывающую сторону как `code_execution_20260120` независимо от того, какую версию объявил запрос. Исключение `"direct"` из массива (например, `"allowed_callers": ["code_execution_20260120"]`) направляет Claude вызывать инструмент только изнутри выполнения кода. Блок `tool_use` в ответе включает поле `caller`, которое указывает, какая вызывающая сторона вызвала инструмент. Полное описание, включая форму `caller` в ответе и поведение при ошибках, см. в разделе [Программный вызов инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/programmatic-tool-calling#the-allowed-callers-field). ### `defer_loading` и кэширование подсказок Инструменты с `defer_loading: true` удаляются из отрисованного раздела инструментов до вычисления ключа кэша. Они вообще не появляются в префиксе системной подсказки. Когда поиск инструментов обнаруживает отложенный инструмент и возвращает для него `tool_reference`, полное определение инструмента разворачивается непосредственно в этой точке тела разговора, а не в префиксе. Это означает, что `defer_loading: true` сохраняет ваш кэш подсказок. Вы можете добавлять отложенные инструменты в запрос, не аннулируя существующую запись кэша, и кэш остаётся действительным на протяжении хода, в котором инструмент обнаружен, и хода, в котором он вызван. Чтобы узнать, как сочетать `defer_loading` с точками разрыва `cache_control`, см. [рекомендации по кэшированию подсказок для инструмента поиска инструментов](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/tool-search-tool#prompt-caching).