Fehlerbehebung bei der Werkzeugnutzung - Claude API Docs

Symptomgesteuerte Tabellen für die häufigsten Fehler bei der Werkzeugnutzung. Jede Fehlerbehebung verweist auf die Seite, die diese Funktion verwaltet.

Claude ruft das falsche Werkzeug auf

Symptom	Wahrscheinliche Ursache	Fehlerbehebung
Claude ruft Werkzeug A auf, wenn Sie Werkzeug B wollten	Mehrdeutigkeit der Beschreibung	Schärfen Sie die Beschreibungen. Differenzieren Sie Werkzeuge nach WANN sie zu verwenden sind, nicht nur WAS sie tun. Siehe Werkzeuge definieren.
Claude ruft Ihr Werkzeug nie auf	Werkzeugnamen-Kollision oder zu generisches Schema	Überprüfen Sie auf doppelte Namen in Ihrer Werkzeugliste. Fügen Sie `input_examples` hinzu, um die beabsichtigte Verwendung konkret zu machen.
Claude ruft mit falschen Parametertypen auf	Modell rät bei mehrdeutigem Schema	Fügen Sie `strict: true` hinzu (wenn Ihr Schema in der unterstützten Teilmenge ist) oder fügen Sie `input_examples` hinzu.

Claude erfindet Werkzeugparameter

Symptom	Wahrscheinliche Ursache	Fehlerbehebung
Parameter, der nicht in Ihrem Schema vorhanden ist	Modellüber-Generierung ohne Strict-Modus	Fügen Sie `strict: true` hinzu, wenn Ihr Schema in der unterstützten Teilmenge ist.
Parameterwerte außerhalb Ihrer Enumeration	Fehlender Strict-Modus oder zu große Enumeration	Verkleinern Sie die Enumeration oder fügen Sie `input_examples` hinzu, die gültige Auswahlmöglichkeiten zeigen.

Parallele Werkzeugaufrufe funktionieren nicht

Symptom	Wahrscheinliche Ursache	Fehlerbehebung
Claude ruft Werkzeuge nacheinander auf, wenn parallel besser wäre	Formatierung des Nachrichtenverlaufs	Senden Sie mehrere `tool_result`-Blöcke in EINER Benutzernachricht, nicht einen pro Runde. Siehe Parallele Werkzeugnutzung.
`disable_parallel_tool_use` scheint ignoriert zu werden	Zu spät in der Konversation gesetzt	Muss auf der Anfrage gesetzt werden, die `tool_use` zurückgibt. Das Setzen auf einer späteren Anfrage hat keine Auswirkung auf frühere Werkzeugaufrufe.

Cache wird ständig ungültig

Symptom	Wahrscheinliche Ursache	Fehlerbehebung
Jede Anfrage ist ein Cache-Miss	`tool_choice` variiert zwischen Anfragen	Halten Sie `tool_choice` stabil oder platzieren Sie den `cache_control`-Haltepunkt vor dem Variationspunkt. Siehe Werkzeugnutzung mit Prompt-Caching.
Das Hinzufügen eines Werkzeugs während der Konversation bricht den Cache	Werkzeug am Anfang des Werkzeug-Arrays eingefügt	Verwenden Sie `defer_loading: true` mit Werkzeugsuche, um das Werkzeug inline anzufügen, anstatt den Array-Kopf zu ändern.

Fehler zur Anfragezeitpunkt

Fehler	Ursache	Fehlerbehebung
`tool_use ids wurden ohne tool_result-Blöcke unmittelbar danach gefunden`	Fehlender `tool_result` für einige `tool_use`-IDs, oder `tool_result` ist nicht der erste Inhaltsblock in der Benutzernachricht	Geben Sie einen `tool_result` für jeden `tool_use`-Block in der Assistenten-Antwort zurück. Platzieren Sie `tool_result`-Blöcke vor jedem Text. Siehe Werkzeugaufrufe verarbeiten und Parallele Werkzeugnutzung.
`Input schema is not compatible with strict mode: string patterns are not supported`	Verwendung von `pattern` mit `strict: true`	Entfernen Sie das Muster oder lassen Sie `strict: true` weg. Das -Schlüsselwort ist noch nicht in der unterstützten JSON-Schema-Teilmenge enthalten.

JSON-Escape-Unterschiede (Opus 4.6+)

Symptom	Ursache	Fehlerbehebung
Zeichenkettenvergleich bei Werkzeugeingaben schlägt bei neueren Modellen fehl	Unicode- und Schrägstrich-Escaping unterscheiden sich zwischen Modellversionen	Analysieren Sie mit `json.loads()` oder `JSON.parse()`. Führen Sie niemals Rohzeichenkettenvergleiche bei serialisierter Eingabe durch.

Nächste Schritte

Werkzeuge definieren

Schreiben Sie Schemas und Beschreibungen, die Claude zum richtigen Werkzeug lenken.

Werkzeugaufrufe verarbeiten

Führen Sie Werkzeuge aus und geben Sie Ergebnisse im erforderlichen Nachrichtenformat zurück.

Werkzeugreferenz

Vollständiges Verzeichnis von Anthropic-Schema-Werkzeugen und ihren Versionskennzeichnungen.

pattern