---
title: Referência de ferramentas
url: https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/tool-reference
description: Diretório de ferramentas de servidor, ferramentas de cliente e conjuntos de ferramentas de cliente fornecidos pela Anthropic, além de referência para propriedades opcionais de definição de ferramentas.
---

Esta página é uma referência para as ferramentas que a Anthropic fornece e as propriedades opcionais que você pode definir em qualquer definição de ferramenta. Para uma introdução conceitual ao “tool use” (uso de ferramentas), consulte [Uso de ferramentas com Claude](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/overview). Para orientação sobre como implementar o uso de ferramentas na sua aplicação, consulte [Definir ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/define-tools).

## Ferramentas fornecidas pela Anthropic

A Anthropic fornece dois tipos de ferramentas: **ferramentas de servidor**, que são executadas na infraestrutura da Anthropic, e **ferramentas de cliente**, em que a Anthropic define o schema, mas sua aplicação cuida da execução. Ambos os tipos aparecem no array `tools` da sua requisição junto com quaisquer ferramentas definidas pelo usuário.

| Ferramenta | `type` | Execução | [Cabeçalho beta](https://platform.claude.com/docs/pt-BR/api/beta-headers) |
| ----- | ----- | ----- | ----- |
| [Ferramenta de pesquisa na web](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/web-search-tool) | `web_search_20260318`<br />`web_search_20260209`<br />`web_search_20250305` | Servidor | Nenhum |
| [Ferramenta web fetch](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/web-fetch-tool) | `web_fetch_20260318`<br />`web_fetch_20260309`<br />`web_fetch_20260209`<br />`web_fetch_20250910` | Servidor | Nenhum |
| [Ferramenta de execução de código](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/code-execution-tool) | `code_execution_20260521`<br />`code_execution_20260120`<br />`code_execution_20250825` | Servidor | Nenhum |
| [Ferramenta advisor](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/advisor-tool) | `advisor_20260301` | Servidor | `advisor-tool-2026-03-01` |
| [Ferramenta de busca de ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/tool-search-tool) | `tool_search_tool_regex_20251119`<br />`tool_search_tool_bm25_20251119` | Servidor | Nenhum |
| [Conector MCP](https://platform.claude.com/docs/pt-BR/agents-and-tools/mcp-connector) | `mcp_toolset` | Servidor | `mcp-client-2025-11-20` |
| [Ferramenta de memória](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/memory-tool) | `memory_20250818` | Cliente | Nenhum |
| [Ferramenta bash](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/bash-tool) | `bash_20250124` | Cliente | Nenhum |
| [Ferramenta de editor de texto](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/text-editor-tool) | `text_editor_20250728`<br />`text_editor_20250124` | Cliente | Nenhum |
| [Ferramenta de uso de computador](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/computer-use-tool) | `computer_toolset_20260801`<br />`computer_20251124`<br />`computer_20250124` | Cliente | Nenhum<br />`computer-use-2025-11-24`<br />`computer-use-2025-01-24` |
| [Ferramenta de uso de navegador](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/browser-use-tool) | `browser_toolset_20260801` | Cliente | Nenhum |

Para compatibilidade de modelos, consulte a página de cada ferramenta. Os modelos suportados variam por ferramenta e por versão da ferramenta. Para verificar a partir do seu código se um modelo aceita pesquisa na web ou execução de código, consulte [Usando a Models API](https://platform.claude.com/docs/pt-BR/models/overview#using-the-models-api).

<Note>
  Os valores de `type` da busca de ferramentas também aceitam aliases sem data: `tool_search_tool_regex` e `tool_search_tool_bm25`. Eles são resolvidos para a versão datada mais recente.
</Note>

### Versionamento de ferramentas

A maioria das ferramentas fornecidas pela Anthropic carrega um sufixo `_YYYYMMDD` na string `type`. Uma nova versão é lançada quando o comportamento, o schema ou o suporte a modelos da ferramenta muda. Versões mais antigas permanecem disponíveis para que integrações existentes continuem funcionando.

Quando uma ferramenta tem várias versões ativas, a relação entre elas varia:

* **Por capacidade:** `web_search_20260209` e `web_fetch_20260209` adicionam filtragem dinâmica de conteúdo em relação às suas predecessoras; `web_fetch_20260309` adiciona uma opção para ignorar o cache; `web_search_20260318` e `web_fetch_20260318` adicionam controle de inclusão na resposta. `code_execution_20260120` adiciona [chamada programática de ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/programmatic-tool-calling) de dentro do sandbox; `code_execution_20260521` informa o limite de tempo por célula na descrição da ferramenta. Em cada caso, tanto a versão nova quanto a antiga são atuais; qual delas você usa depende de você precisar ou não da nova capacidade.
* **Por modelo:** `text_editor_20250728` é para modelos Claude 4 e posteriores, e `text_editor_20250124` é para modelos anteriores. A versão que você usa depende do modelo que você tem como alvo.
* **Variante, não versão:** `tool_search_tool_regex_20251119` e `tool_search_tool_bm25_20251119` são dois algoritmos de busca lançados juntos. Nenhum substitui o outro.
* **Legado:** `code_execution_20250522` suporta apenas Python. `code_execution_20250825` adiciona Bash e operações de arquivo.
* **Sucessora:** `computer_toolset_20260801` é a sucessora estável das versões beta `computer_20251124` e `computer_20250124`, que estão disponíveis nos modelos listados para elas em [Versões anteriores da ferramenta](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions). `browser_toolset_20260801` é a primeira versão da ferramenta de uso de navegador. Ambas são [conjuntos de ferramentas de cliente](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/tool-reference#client-toolsets).

O tipo `mcp_toolset` não é versionado por data; o versionamento é carregado no cabeçalho `anthropic-beta`.

### Conjuntos de ferramentas de cliente

A [ferramenta de uso do computador](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/computer-use-tool) e a [ferramenta de uso do navegador](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/browser-use-tool) são conjuntos de ferramentas de cliente definidos pela Anthropic: uma entrada em `tools` declara um conjunto fixo de ferramentas membro cujos nomes, descrições e schemas de entrada são definidos pela Anthropic, e sua aplicação executa todas as chamadas. A entrada não recebe `name`, porque o `type` datado fixa os nomes dos membros. `configs`, `cache_control` e `allowed_callers` (que aceita apenas `["direct"]`) são opcionais.

Conjuntos de ferramentas de cliente são ferramentas da Messages API. Atualmente, eles não estão disponíveis como ferramentas de agente no [Claude Managed Agents](https://platform.claude.com/docs/pt-BR/managed-agents/tools), que fornece seu próprio conjunto de ferramentas de agente integrado, conjuntos de ferramentas MCP e ferramentas personalizadas.

```json
{
  "type": "browser_toolset_20260801",
  "configs": {
    "javascript_exec": { "enabled": true }
  },
  "cache_control": { "type": "ephemeral" }
}
```

`configs` ajusta membros individuais:

* As chaves são nomes de membros, e cada valor aceita apenas `enabled` e `defer_loading`.
* Um membro que você omite mantém seus padrões. Um valor ausente, `{}` e um padrão reafirmado são equivalentes.
* Um nome de membro desconhecido ou qualquer outro campo no valor de um membro é rejeitado, assim como um `configs` que desabilita todos os membros (omita a entrada em vez disso).
* Um membro desativado é removido das ferramentas que Claude recebe. Se Claude ainda assim o nomear, retorne um `tool_result` de erro.

Defina `defer_loading` para cada membro, nunca na entrada, e dê a todos os membros ativados o mesmo valor: na [busca de ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/tool-search-tool#deferred-tool-loading), o conjunto de ferramentas é carregado e expandido como uma única definição. Quando todos os membros ativados são adiados, apenas uma [ferramenta de busca de ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/tool-search-tool) que não seja ela própria adiada pode revelar o conjunto de ferramentas, portanto declare uma na mesma requisição. Não coloque `cache_control` em uma entrada de conjunto de ferramentas cujos membros são adiados; defina o breakpoint em uma ferramenta não adiada, porque definições adiadas não fazem parte do prefixo em cache.

`cache_control` vai apenas na entrada; para saber onde o ponto de interrupção é posicionado, incluindo marcadores dentro de uma ação em lote, consulte [Uso de ferramentas com cache de prompt](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/tool-use-with-prompt-caching#cache-control-on-tool-definitions).

**Lide com chamadas de ferramentas membro.** Claude chama um membro com um bloco `tool_use` cujo `name` é o nome do membro e cujo `toolset_name` é `computer` ou `browser`; `input` contém os parâmetros desse membro e nenhum campo `action`. Faça o despacho com base no par `toolset_name` e `name`, porque uma ferramenta personalizada pode compartilhar o nome de um membro e os dois conjuntos de ferramentas compartilham nomes como `screenshot`. Apenas os resultados de membros repetem `toolset_name`. Várias chamadas de membros em um único turno formam uma ação em lote que você executa em ordem ([uso do computador](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/computer-use-tool#batch-actions), [uso do navegador](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/browser-use-tool#batch-actions)). Novos membros chegam apenas com um novo `type` datado.

**Não suportado em entradas de conjunto de ferramentas.** A API rejeita cada um destes com um `invalid_request_error`:

* `strict: true` ou `input_examples`.
* `defer_loading` na entrada, ou membros ativados cujos valores de `defer_loading` diferem (defina-o para cada membro em `configs`, todos com o mesmo valor).
* Um chamador de execução de código em `allowed_callers` (sem [chamada programática de ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/programmatic-tool-calling)).
* O cabeçalho beta `fine-grained-tool-streaming-2025-05-14`. Quando você usa streaming, o `input` de cada membro chega como um único `input_json_delta` completo.
* Um `tool_choice` do tipo `tool` que nomeia o conjunto de ferramentas ou um membro (use `auto`, `any` ou `none`).
* Duas entradas do mesmo conjunto de ferramentas, ou outra ferramenta que carregue o nome daquele conjunto de ferramentas: uma ferramenta chamada `computer` junto com `computer_toolset_20260801`, ou uma ferramenta chamada `browser` junto com `browser_toolset_20260801`. Os dois conjuntos de ferramentas podem ser declarados juntos.

## Propriedades de definição de ferramentas

Toda ferramenta no array `tools`, incluindo ferramentas definidas pelo usuário, aceita propriedades opcionais que controlam como a ferramenta é carregada, quem pode chamá-la e como suas entradas são validadas. Você pode combinar essas propriedades, com duas exceções: uma ferramenta com `defer_loading: true` não pode também ter `cache_control`, e uma ferramenta definida pelo usuário com `strict: true` não pode listar um chamador de execução de código em `allowed_callers`.

| Propriedade | Finalidade | Disponível em | Guia detalhado |
| ----- | ----- | ----- | ----- |
| `cache_control` | Define um breakpoint de cache de prompt nesta definição de ferramenta | Todas as ferramentas (em `computer_toolset_20260801` e `browser_toolset_20260801`, defina-o na própria entrada do conjunto de ferramentas, não dentro dos `configs` dos membros) | [Cache de prompt](https://platform.claude.com/docs/pt-BR/build-with-claude/prompt-caching) |
| `strict` | Garante a validação de schema em nomes e entradas de ferramentas | Todas as ferramentas, exceto `mcp_toolset`, `computer_toolset_20260801` e `browser_toolset_20260801` | [Uso estrito de ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/strict-tool-use) |
| `defer_loading` | Exclui a ferramenta do prompt do sistema inicial; carrega-a sob demanda quando a busca de ferramentas retorna um `tool_reference` para ela | Todas as ferramentas (para `mcp_toolset`, consulte [configuração do conjunto de ferramentas MCP](https://platform.claude.com/docs/pt-BR/agents-and-tools/mcp-connector#mcp-toolset-configuration)). Nos conjuntos de ferramentas de uso do computador e de uso do navegador, defina-o por membro dentro de `configs`; consulte [Conjuntos de ferramentas de cliente](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/tool-reference#client-toolsets). | [Ferramenta de busca de ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/tool-search-tool) |
| `allowed_callers` | Restringe quais chamadores podem chamar a ferramenta | Todas as ferramentas, exceto `mcp_toolset` (em `computer_toolset_20260801` e `browser_toolset_20260801`, apenas `["direct"]` é aceito; consulte [Conjuntos de ferramentas de cliente](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/tool-reference#client-toolsets)) | [Chamada programática de ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/programmatic-tool-calling#the-allowed-callers-field) |
| `input_examples` | Fornece objetos de entrada de exemplo para mostrar a Claude como chamar a ferramenta | Ferramentas definidas pelo usuário e ferramentas de cliente com schema da Anthropic, exceto `computer_toolset_20260801` e `browser_toolset_20260801`. Não disponível em ferramentas de servidor. | [Definir ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/define-tools#providing-tool-use-examples) |
| `eager_input_streaming` | Ativa o streaming de entrada refinado (`true`) ou mantém o streaming padrão com buffer (`false`) para esta ferramenta | Apenas ferramentas definidas pelo usuário | [Streaming refinado de ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/fine-grained-tool-streaming) |

### Valores de `allowed_callers`

`allowed_callers` é um array que aceita qualquer combinação de:

| Valor | Significado |
| ----- | ----- |
| `"direct"` | O modelo pode chamar esta ferramenta diretamente em um bloco `tool_use`. Este é o padrão se `allowed_callers` for omitido. |
| `"code_execution_20260120"` | Código executado dentro de um sandbox `code_execution_20260120` ou posterior pode chamar esta ferramenta. |

Tanto `"code_execution_20260120"` quanto `"code_execution_20260521"` são aceitos em `allowed_callers` e são intercambiáveis: uma requisição usando qualquer uma das versões da ferramenta de execução de código satisfaz ferramentas que listam qualquer um dos chamadores. Os blocos de resposta sempre marcam o chamador como `code_execution_20260120`, independentemente de qual versão a requisição declarou.

Omitir `"direct"` do array (por exemplo, `"allowed_callers": ["code_execution_20260120"]`) orienta Claude a chamar a ferramenta apenas de dentro da execução de código. O bloco `tool_use` da resposta inclui um campo `caller` que identifica qual chamador chamou a ferramenta. Consulte [Chamada programática de ferramentas](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/programmatic-tool-calling#the-allowed-callers-field) para o tratamento completo, incluindo o formato de resposta de `caller` e o comportamento de erro.

### `defer_loading` e cache de prompt

`defer_loading: true` preserva seu cache de prompt: a busca de ferramentas pode carregar uma ferramenta adiada durante uma conversa sem invalidar uma entrada de cache existente. Coloque pontos de interrupção de `cache_control` em ferramentas não adiadas. Para saber como as ferramentas adiadas mantêm o cache válido, consulte [`defer_loading` e preservação do cache](https://platform.claude.com/docs/pt-BR/agents-and-tools/tool-use/tool-use-with-prompt-caching#defer-loading-and-cache-preservation).
