Werkzeugdefinition
Eine Tool-Definition beschreibt einem Modell Name, Zweck und Eingaben eines Tools und zählt als Eingabetokens, sobald sie mit einer Anfrage gesendet wird.
Ein Modell kann nicht aufrufen, worüber es nicht informiert wurde, daher wird jedes Tool, das es möglicherweise verwendet, in der Anfrage selbst beschrieben. In der Claude-API ist die Beschreibung ein Eintrag im Parameter tools: ein name, ein Klartext-description und ein input_schema, geschrieben im JSON-Schema. Das Modell entscheidet anhand der Anfrage und der Beschreibung des Tools, wann ein Tool aufgerufen wird.
All das zählt als Eingabe und wird abgerechnet. Die Preisgestaltung von Anthropic zählt Werkzeugnamen, Beschreibungen und Schemata als Eingabe-Tokens, und sobald ein Werkzeug vorhanden ist, fügt die API eine System-Prompt zur Werkzeugnutzung von einigen hundert Tokens hinzu, 286 auf Claude Opus 5.5 ab September 2026. Von Anthropic definierte Werkzeuge tragen eigene Definitionen, und die folgenden Aufrufe und Ergebnisse werden zusätzlich in Rechnung gestellt.
In einem Agenten können integrierte Werkzeuge, MCP-Server und Plugins Definitionen beisteuern. Ob ein ungenutztes Werkzeug Kontext belegt, hängt vom Client ab: Manche laden detaillierte Schemata sofort, andere verzögert. Seit September 2026 verzögert Claude Code MCP-Werkzeugdefinitionen standardmäßig, und Codex kann auffindbare MCP-Werkzeuge über die Werkzeugsuche verzögert laden.
Definitionen befinden sich auch ganz vorne im Prompt-Cache. Anthropic speichert Präfixe in dieser Reihenfolge zwischen: Tools, System-Prompt, Nachrichten. Das Hinzufügen, Entfernen oder Bearbeiten eines Tools zwischen Anfragen macht also alles ungültig, was danach zwischengespeichert wird, und die nächste Anfrage zahlt sich aus, um den gesamten Kontext erneut zu verarbeiten.