---
title: Referencia de herramientas
url: https://platform.claude.com/docs/es/agents-and-tools/tool-use/tool-reference
description: Directorio de herramientas de servidor, herramientas de cliente y conjuntos de herramientas de cliente proporcionados por Anthropic, además de la referencia de las propiedades opcionales de definición de herramientas.
---

Esta página es una referencia de las herramientas que Anthropic proporciona y de las propiedades opcionales que puedes establecer en cualquier definición de herramienta. Para una introducción conceptual al “tool use” (uso de herramientas), consulta [Uso de herramientas con Claude](https://platform.claude.com/docs/es/agents-and-tools/tool-use/overview). Para obtener orientación sobre cómo implementar el uso de herramientas en tu aplicación, consulta [Definir herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/define-tools).

## Herramientas proporcionadas por Anthropic

Anthropic proporciona dos tipos de herramientas: **herramientas de servidor** que se ejecutan en la infraestructura de Anthropic, y **herramientas de cliente** en las que Anthropic define el esquema pero tu aplicación se encarga de la ejecución. Ambos tipos aparecen en el arreglo `tools` de tu solicitud junto con cualquier herramienta definida por el usuario.

| Herramienta | `type` | Ejecución | [Encabezado beta](https://platform.claude.com/docs/es/api/beta-headers) |
| ----- | ----- | ----- | ----- |
| [Herramienta de búsqueda web](https://platform.claude.com/docs/es/agents-and-tools/tool-use/web-search-tool) | `web_search_20260318`<br />`web_search_20260209`<br />`web_search_20250305` | Servidor | Ninguno |
| [Herramienta de obtención web](https://platform.claude.com/docs/es/agents-and-tools/tool-use/web-fetch-tool) | `web_fetch_20260318`<br />`web_fetch_20260309`<br />`web_fetch_20260209`<br />`web_fetch_20250910` | Servidor | Ninguno |
| [Herramienta de ejecución de código](https://platform.claude.com/docs/es/agents-and-tools/tool-use/code-execution-tool) | `code_execution_20260521`<br />`code_execution_20260120`<br />`code_execution_20250825` | Servidor | Ninguno |
| [Herramienta asesora](https://platform.claude.com/docs/es/agents-and-tools/tool-use/advisor-tool) | `advisor_20260301` | Servidor | `advisor-tool-2026-03-01` |
| [Herramienta de búsqueda de herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/tool-search-tool) | `tool_search_tool_regex_20251119`<br />`tool_search_tool_bm25_20251119` | Servidor | Ninguno |
| [Conector MCP](https://platform.claude.com/docs/es/agents-and-tools/mcp-connector) | `mcp_toolset` | Servidor | `mcp-client-2025-11-20` |
| [Herramienta de memoria](https://platform.claude.com/docs/es/agents-and-tools/tool-use/memory-tool) | `memory_20250818` | Cliente | Ninguno |
| [Herramienta Bash](https://platform.claude.com/docs/es/agents-and-tools/tool-use/bash-tool) | `bash_20250124` | Cliente | Ninguno |
| [Herramienta de editor de texto](https://platform.claude.com/docs/es/agents-and-tools/tool-use/text-editor-tool) | `text_editor_20250728`<br />`text_editor_20250124` | Cliente | Ninguno |
| [Herramienta de uso de computadora](https://platform.claude.com/docs/es/agents-and-tools/tool-use/computer-use-tool) | `computer_toolset_20260801`<br />`computer_20251124`<br />`computer_20250124` | Cliente | Ninguno<br />`computer-use-2025-11-24`<br />`computer-use-2025-01-24` |
| [Herramienta de uso de navegador](https://platform.claude.com/docs/es/agents-and-tools/tool-use/browser-use-tool) | `browser_toolset_20260801` | Cliente | Ninguno |

Para conocer la compatibilidad de modelos, consulta la página de cada herramienta. Los modelos compatibles varían según la herramienta y la versión de la herramienta. Para comprobar desde tu código si un modelo acepta búsqueda web o ejecución de código, consulta [Uso de la API de Models](https://platform.claude.com/docs/es/models/overview#using-the-models-api).

<Note>
  Los valores `type` de la búsqueda de herramientas también aceptan alias sin fecha: `tool_search_tool_regex` y `tool_search_tool_bm25`. Estos se resuelven a la versión con fecha más reciente.
</Note>

### Versionado de herramientas

La mayoría de las herramientas proporcionadas por Anthropic llevan un sufijo `_YYYYMMDD` en la cadena `type`. Se publica una nueva versión cuando cambia el comportamiento, el esquema o la compatibilidad con modelos de la herramienta. Las versiones anteriores siguen disponibles para que las integraciones existentes continúen funcionando.

Cuando una herramienta tiene varias versiones activas, la relación entre ellas varía:

* **Según la capacidad:** `web_search_20260209` y `web_fetch_20260209` añaden filtrado dinámico de contenido respecto a sus predecesoras; `web_fetch_20260309` añade una opción para omitir la caché; `web_search_20260318` y `web_fetch_20260318` añaden control de inclusión en la respuesta. `code_execution_20260120` añade la [llamada programática de herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/programmatic-tool-calling) desde dentro del sandbox; `code_execution_20260521` indica el límite de tiempo por celda en la descripción de la herramienta. En cada caso, tanto la versión nueva como la anterior están vigentes; cuál uses depende de si necesitas la nueva capacidad.
* **Según el modelo:** `text_editor_20250728` es para Claude 4 y modelos posteriores, y `text_editor_20250124` es para modelos anteriores. La versión que uses depende del modelo al que te dirijas.
* **Variante, no versión:** `tool_search_tool_regex_20251119` y `tool_search_tool_bm25_20251119` son dos algoritmos de búsqueda publicados juntos. Ninguno reemplaza al otro.
* **Heredada:** `code_execution_20250522` solo admite Python. `code_execution_20250825` añade Bash y operaciones con archivos.
* **Sucesora:** `computer_toolset_20260801` es la sucesora estable de las versiones beta `computer_20251124` y `computer_20250124`, que están disponibles en los modelos indicados para ellas en [Versiones anteriores de la herramienta](https://platform.claude.com/docs/es/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions). `browser_toolset_20260801` es la primera versión de la herramienta de uso de navegador. Ambas son [conjuntos de herramientas de cliente](https://platform.claude.com/docs/es/agents-and-tools/tool-use/tool-reference#client-toolsets).

El tipo `mcp_toolset` no está versionado por fecha; en su lugar, el versionado se lleva en el encabezado `anthropic-beta`.

### Conjuntos de herramientas de cliente

La [herramienta de uso de computadora](https://platform.claude.com/docs/es/agents-and-tools/tool-use/computer-use-tool) y la [herramienta de uso de navegador](https://platform.claude.com/docs/es/agents-and-tools/tool-use/browser-use-tool) son conjuntos de herramientas de cliente definidos por Anthropic: una entrada en `tools` declara un conjunto fijo de herramientas miembro cuyos nombres, descripciones y esquemas de entrada define Anthropic, y tu aplicación ejecuta cada llamada. La entrada no lleva `name`, porque el `type` con fecha fija los nombres de los miembros. `configs`, `cache_control` y `allowed_callers` (que solo acepta `["direct"]`) son opcionales.

Los conjuntos de herramientas de cliente son herramientas de la Messages API. Actualmente no están disponibles como herramientas de agente en [Claude Managed Agents](https://platform.claude.com/docs/es/managed-agents/tools), que proporciona su propio conjunto de herramientas de agente integrado, conjuntos de herramientas MCP y herramientas personalizadas.

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

`configs` ajusta miembros individuales:

* Las claves son nombres de miembros, y cada valor acepta solo `enabled` y `defer_loading`.
* Un miembro que omitas conserva sus valores predeterminados. Un valor ausente, `{}` y un valor predeterminado reiterado son equivalentes.
* Se rechaza un nombre de miembro desconocido o cualquier otro campo en el valor de un miembro, al igual que un `configs` que deshabilite todos los miembros (en su lugar, omite la entrada).
* Un miembro deshabilitado se elimina de las herramientas que recibe Claude. Si Claude aun así lo nombra, devuelve un `tool_result` de error.

Establece `defer_loading` para cada miembro, nunca en la entrada, y da a todos los miembros habilitados el mismo valor: con la [búsqueda de herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/tool-search-tool#deferred-tool-loading), el conjunto de herramientas se carga y se expande como una sola definición. Cuando todos los miembros habilitados son diferidos, solo una [herramienta de búsqueda de herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/tool-search-tool) que no sea diferida puede mostrar el conjunto de herramientas, así que declara una en la misma solicitud. No pongas `cache_control` en una entrada de conjunto de herramientas cuyos miembros sean diferidos; en su lugar, establece el punto de interrupción en una herramienta no diferida, porque las definiciones diferidas no forman parte del prefijo almacenado en caché.

`cache_control` va solo en la entrada; para saber dónde queda el punto de interrupción, incluidos los marcadores dentro de una acción por lotes, consulta [Uso de herramientas con almacenamiento en caché de prompts](https://platform.claude.com/docs/es/agents-and-tools/tool-use/tool-use-with-prompt-caching#cache-control-on-tool-definitions).

**Gestiona las llamadas a herramientas miembro.** Claude llama a un miembro con un bloque `tool_use` cuyo `name` es el nombre del miembro y cuyo `toolset_name` es `computer` o `browser`; `input` contiene los parámetros de ese miembro y ningún campo `action`. Despacha según el par `toolset_name` y `name`, porque una herramienta personalizada podría compartir el nombre de un miembro y los dos conjuntos de herramientas comparten nombres como `screenshot`. Solo los resultados de miembros repiten `toolset_name`. Varias llamadas a miembros en un mismo turno forman una acción por lotes que ejecutas en orden ([uso de computadora](https://platform.claude.com/docs/es/agents-and-tools/tool-use/computer-use-tool#batch-actions), [uso de navegador](https://platform.claude.com/docs/es/agents-and-tools/tool-use/browser-use-tool#batch-actions)). Los nuevos miembros llegan solo con un nuevo `type` con fecha.

**No admitido en entradas de conjuntos de herramientas.** La API rechaza cada uno de estos con un `invalid_request_error`:

* `strict: true` o `input_examples`.
* `defer_loading` en la entrada, o miembros habilitados cuyos valores de `defer_loading` difieran (establécelo para cada miembro en `configs`, todos con el mismo valor).
* Un llamador de ejecución de código en `allowed_callers` (sin [llamada programática de herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/programmatic-tool-calling)).
* El encabezado beta `fine-grained-tool-streaming-2025-05-14`. Cuando usas streaming, el `input` de cada miembro llega como un único `input_json_delta` completo.
* Un `tool_choice` de tipo `tool` que nombre el conjunto de herramientas o un miembro (usa `auto`, `any` o `none`).
* Dos entradas del mismo conjunto de herramientas, u otra herramienta que lleve el nombre de ese conjunto de herramientas: una herramienta llamada `computer` junto con `computer_toolset_20260801`, o una herramienta llamada `browser` junto con `browser_toolset_20260801`. Los dos conjuntos de herramientas pueden declararse juntos.

## Propiedades de definición de herramientas

Cada herramienta del array `tools`, incluidas las herramientas definidas por el usuario, acepta propiedades opcionales que controlan cómo se carga la herramienta, quién puede llamarla y cómo se validan sus entradas. Puedes combinar estas propiedades, con dos excepciones: una herramienta con `defer_loading: true` no puede llevar también `cache_control`, y una herramienta definida por el usuario con `strict: true` no puede incluir un llamador de ejecución de código en `allowed_callers`.

| Propiedad | Propósito | Disponible en | Guía detallada |
| ----- | ----- | ----- | ----- |
| `cache_control` | Establece un punto de interrupción de caché de prompts en esta definición de herramienta | Todas las herramientas (en `computer_toolset_20260801` y `browser_toolset_20260801`, establécelo en la propia entrada del conjunto de herramientas, no dentro de los `configs` de los miembros) | [Almacenamiento en caché de prompts](https://platform.claude.com/docs/es/build-with-claude/prompt-caching) |
| `strict` | Garantiza la validación del esquema en los nombres y entradas de las herramientas | Todas las herramientas excepto `mcp_toolset`, `computer_toolset_20260801` y `browser_toolset_20260801` | [Uso estricto de herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/strict-tool-use) |
| `defer_loading` | Excluye la herramienta de la indicación del sistema inicial; la carga bajo demanda cuando la búsqueda de herramientas devuelve un `tool_reference` para ella | Todas las herramientas (para `mcp_toolset`, consulta [configuración del conjunto de herramientas MCP](https://platform.claude.com/docs/es/agents-and-tools/mcp-connector#mcp-toolset-configuration)). En los conjuntos de herramientas de uso de computadora y uso de navegador, establécelo por miembro dentro de `configs`; consulta [Conjuntos de herramientas de cliente](https://platform.claude.com/docs/es/agents-and-tools/tool-use/tool-reference#client-toolsets). | [Herramienta de búsqueda de herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/tool-search-tool) |
| `allowed_callers` | Restringe qué llamadores pueden llamar a la herramienta | Todas las herramientas excepto `mcp_toolset` (en `computer_toolset_20260801` y `browser_toolset_20260801`, solo se acepta `["direct"]`; consulta [Conjuntos de herramientas de cliente](https://platform.claude.com/docs/es/agents-and-tools/tool-use/tool-reference#client-toolsets)) | [Llamada programática de herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/programmatic-tool-calling#the-allowed-callers-field) |
| `input_examples` | Proporciona objetos de entrada de ejemplo para mostrar a Claude cómo llamar a la herramienta | Herramientas definidas por el usuario y herramientas de cliente con esquema de Anthropic, excepto `computer_toolset_20260801` y `browser_toolset_20260801`. No disponible en herramientas de servidor. | [Definir herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/define-tools#providing-tool-use-examples) |
| `eager_input_streaming` | Habilita el streaming de entrada detallado (`true`) o mantiene el streaming estándar con búfer (`false`) para esta herramienta | Solo herramientas definidas por el usuario | [Streaming detallado de herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/fine-grained-tool-streaming) |

### Valores de `allowed_callers`

`allowed_callers` es un array que acepta cualquier combinación de:

| Valor | Significado |
| ----- | ----- |
| `"direct"` | El modelo puede llamar a esta herramienta directamente en un bloque `tool_use`. Este es el valor predeterminado si se omite `allowed_callers`. |
| `"code_execution_20260120"` | El código que se ejecuta dentro de un sandbox `code_execution_20260120` o posterior puede llamar a esta herramienta. |

Tanto `"code_execution_20260120"` como `"code_execution_20260521"` se aceptan en `allowed_callers` y son intercambiables: una solicitud que use cualquiera de las dos versiones de la herramienta de ejecución de código satisface a las herramientas que listen cualquiera de los dos llamadores. Los bloques de respuesta siempre etiquetan al llamador como `code_execution_20260120`, independientemente de la versión que haya declarado la solicitud.

Omitir `"direct"` del array (por ejemplo, `"allowed_callers": ["code_execution_20260120"]`) orienta a Claude a llamar a la herramienta solo desde dentro de la ejecución de código. El bloque `tool_use` de la respuesta incluye un campo `caller` que identifica qué llamador llamó a la herramienta. Consulta [Llamada programática de herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/programmatic-tool-calling#the-allowed-callers-field) para el tratamiento completo, incluida la forma de la respuesta `caller` y el comportamiento ante errores.

### `defer_loading` y almacenamiento en caché de prompts

`defer_loading: true` preserva tu caché de prompts: la búsqueda de herramientas puede cargar una herramienta diferida durante una conversación sin invalidar una entrada de caché existente. Coloca los puntos de interrupción de `cache_control` en herramientas no diferidas. Para saber cómo las herramientas diferidas mantienen válida la caché, consulta [`defer_loading` y preservación de la caché](https://platform.claude.com/docs/es/agents-and-tools/tool-use/tool-use-with-prompt-caching#defer-loading-and-cache-preservation).
