Definición de herramienta
Una definición de herramienta es el nombre, la descripción y el esquema de entrada con los que se presenta una herramienta al modelo, contabilizados como entrada cuando el cliente los incluye en una petición.
El modelo necesita conocer una herramienta para poder llamarla. En la API de Claude, la definición figura en tools con name, una description en lenguaje natural y un input_schema de JSON Schema. La petición y esa descripción permiten al modelo decidir cuándo usarla.
Todo se factura como entrada. Anthropic cuenta nombres, descripciones y esquemas, y cuando hay al menos una herramienta, la API añade instrucciones de uso. En Opus 5.5 son 286 tokens según la tabla publicada a septiembre de 2026. Las herramientas de Anthropic tienen sus propias definiciones; las llamadas y los resultados se cobran además.
En un agente, las herramientas integradas, los servidores MCP y los plugins pueden aportar definiciones. Su coste de contexto depende del cliente: algunos incluyen los esquemas detallados desde el principio y otros los aplazan. En septiembre de 2026, Claude Code aplaza por defecto las definiciones de herramientas MCP y Codex puede aplazar las herramientas MCP descubribles mediante la búsqueda de herramientas.
Las definiciones ocupan el principio del prefijo guardado en caché. Anthropic lo ordena como herramientas, sistema y mensajes. Añadir, quitar o editar una herramienta entre peticiones invalida todo lo que venía después y obliga a procesar de nuevo el contexto.