Claude: Tool-Nutzungslimit in diesem Durchlauf erklärt

Was das Nutzungslimit für Tools in diesem Durchlauf bedeutet

Ein Nutzungslimit für Tools in diesem Durchlauf bedeutet, dass Claude die Antwort nach einem Teilabschnitt beendet hat, weil das Limit für Tool-Aufrufe erreicht war. Das bedeutet nicht, dass Ihr Konto sein Nutzungslimit erreicht hat. Alles, was Claude bis zum Abbruch gefunden hat, ist weiterhin in der Unterhaltung verfügbar. Senden Sie eine weitere Nachricht mit der Bitte, fortzufahren. Dadurch wird ein neuer Durchlauf mit einem neuen Kontingent gestartet.

Ein Durchlauf ist eine vollständige Runde innerhalb einer Agentenschleife. Claude erzeugt eine Ausgabe mit Tool-Aufrufen, der Client führt diese Tools aus, und die Ergebnisse werden für die nächste Entscheidung an Claude zurückgegeben. Dieser Zyklus wiederholt sich, ohne die Kontrolle an Sie zurückzugeben. Der Durchlauf endet, sobald Claude eine Antwort ohne Tool-Aufrufe erzeugt. Eine Begrenzung des Durchlaufs legt fest, wie viele solcher Runden eine Antwort höchstens enthalten darf.

Ihr Plan-Nutzungslimit ist eine separate Steuerung

Das Planlimit zählt, wie viel Sie innerhalb eines Zeitfensters genutzt haben. Die Hilfeseite von Anthropic zu Fehlermeldungen, abgerufen am 18. August 2026, führt diesen Fall als Approaching 5-hour limit. auf, solange Sie sich dem Limit nähern, und als 5-hour limit reached - resets [time]., sobald Sie es überschreiten. Sie nennt einen Zeitpunkt. Wenn Sie bis zu diesem Zeitpunkt warten, wird der Fehler behoben. Nichts, was Sie in der Zwischenzeit eingeben, hilft.

Die Meldung zur Tool-Nutzung verhält sich umgekehrt. Sie erscheint während einer Aufgabe, und eine einzelne Folgemeldung setzt die Arbeit sofort fort. Ihr verbleibendes Kontingent bleibt unverändert. Das ist der Test: Wenn Warten nichts bewirkt und das Fortsetzen funktioniert, hatten Sie Ihr Kontingent nie erreicht. Für den Fall eines erreichten Kontingents führt was Sie tun können, wenn Claude meldet, dass das Limit erreicht ist die Optionen auf. wie Nutzungslimits von Claude gezählt werden erklärt die zugrunde liegenden Zeitfenster.

Warum ein Turn überhaupt ein Tool-Budget benötigt

Jeder Tool-Aufruf verbraucht Kontext. Der Aufruf wird ausgeführt, das Tool läuft, und das vollständige Ergebnis wird wieder in die Unterhaltung übernommen. Das Lesen einer großen Datei oder das Ausführen eines Befehls mit umfangreicher Ausgabe kann in einem einzigen Schritt Tausende von Tokens verbrauchen. Dieser Text bleibt für den Rest der Sitzung im Kontext. Die Dokumentation zur Agentenschleife von Anthropic beschreibt die Folge eindeutig: Der Kontext wächst über mehrere Turns hinweg. Eine Sitzung mit vielen Tool-Aufrufen enthält daher deutlich mehr Inhalt als eine kurze Sitzung.

Ein Budget für den Turn beendet eine Schleife, die keine Fortschritte mehr macht. Ein Agent, der sucht, liest, erneut sucht und weiterhin nichts findet, würde so lange fortfahren, bis ihn etwas unterbricht. Das Budget übernimmt diese Unterbrechung. Es gibt die Kontrolle an Sie zurück, sodass Sie die Arbeit an dieser Stelle neu ausrichten können. Das kostet deutlich weniger, als die Schleife bis zum Ende des Kontextfensters laufen zu lassen.

Wo dieses Limit in der API sichtbar ist

Anthropic dokumentiert in den öffentlichen Fehlerbeschreibungen keine Anzahl von Tool-Aufrufen pro Turn für die Claude-Chat-Anwendung. Jede exakte Zahl, die Sie dort lesen, ist daher eine Vermutung. Für die API (Application Programming Interface) ist dieselbe Art von Limit dokumentiert. In dieser Dokumentation wird das tatsächliche Verhalten sichtbar.

Das Feld stop_reason in einer Antwort der Messages API gibt an, warum die Generierung beendet wurde. Die dokumentierten Werte sind end_turn, max_tokens, stop_sequence, tool_use, pause_turn, refusal und model_context_window_exceeded. Zwei davon beschreiben die Situation in diesem Leitfaden.

pause_turn wird zurückgegeben, wenn die serverseitige Sampling-Schleife beim Ausführen von Server-Tools wie der Websuche ihr Iterationslimit erreicht. Am 18. August 2026 nennt die Seite zu den Abbruchgründen standardmäßig 10 Iterationen pro Anfrage. Laut Dokumentation soll die Antwort unverändert als Assistant-Nachricht zurückgesendet werden. Claude setzt dann an der Stelle fort, an der die Verarbeitung pausiert wurde. Das entspricht in der API der Eingabe von „continue“ in einem Chatfenster.

max_tokens bedeutet, dass die Antwort die für die Anfrage festgelegte Obergrenze für Ausgabetoken erreicht hat. Wird die Ausgabe innerhalb eines unvollständigen Tool-Use-Blocks abgeschnitten, kann der Tool-Aufruf nicht ausgeführt werden. Laut Dokumentation soll die Anfrage mit einem höheren max_tokens erneut gesendet werden.

Lesen Sie die aktuellen Werte auf der Seite zu den Abbruchgründen, statt den hier angegebenen Werten zu vertrauen. Die Standardwerte auf dieser Seite ändern sich. Eine veraltete Zahl ist schlechter als keine Zahl.

Wodurch ein Chat sein Kontingent an Tool-Aufrufen aufbraucht

• Eine Frage ohne natürliches Ende. „Finden Sie alles, was über X geschrieben wurde“ gibt dem Modell keinen Hinweis darauf, wann die Suche abgeschlossen ist.
• Wiederholtes Lesen desselben Materials, weil sich die Antwort nicht an der erwarteten Stelle befindet.
• Große Tool-Ergebnisse. Eine lange Webseite oder eine große Datei nimmt den Platz ein, der für den restlichen Teil des Durchlaufs benötigt wird.
• Mehrere unabhängige Aufgaben in einer Nachricht. Jede Aufgabe erfordert eigene Tool-Aufrufe, die alle aus demselben Kontingent stammen.
• Connectors und MCP (model context protocol)-Server, die Sie für diese Aufgabe nicht verwenden. Ihre Tool-Definitionen werden in die Anfrage geladen und geben dem Modell mehr Möglichkeiten, das Kontingent des Durchlaufs aufzubrauchen.

So schließen Sie die Antwort ab

Antworten Sie mit „continue“ oder besser mit einer kurzen Anweisung, in der Sie benennen, was noch fehlt. Dadurch wird eine neue Runde mit einem neuen Budget gestartet. Die bisherige Unterhaltung bleibt im Kontext, sodass Claude fortfährt, statt bereits ausgeführte Tool-Aufrufe zu wiederholen.

Wenn der Prozess zweimal an derselben Stelle hängen bleibt, ist die Aufgabe für eine einzelne Runde zu umfangreich. Teilen Sie sie dann auf. Bitten Sie beispielsweise nicht um eine vollständige Prüfung eines Repositorys, sondern zunächst um die Dateiliste und anschließend pro Nachricht um die Analyse einer Datei. Vier kleine Runden erledigen die Arbeit, die eine große Runde nicht abschließen kann.

Schränken Sie ein, wonach das Modell suchen soll. Geben Sie den genauen Dateipfad oder die genaue Fehlerzeichenfolge an und fügen Sie das Log ein, wenn es Ihnen bereits vorliegt. Ein eingefügtes Log kostet eine Nachricht. Wenn das Modell das Log selbst suchen muss, kostet das mehrere Tool-Aufrufe, und möglicherweise findet es das falsche Log.

Deaktivieren Sie Verbindungen, die Sie derzeit nicht benötigen. Jedes verbundene Tool fügt jeder Anfrage seine Definition hinzu. Das verbraucht Kontext und erweitert die Menge der Aktionen, die das Modell auswählen kann. Dasselbe gilt für eine lange Programmiersitzung: den Kontext einer Claude-Code-Sitzung klein zu halten entscheidet darüber, ob ein Agent die Aufgabe abschließt oder auf halbem Weg anhält.

Legen Sie das Turn-Limit selbst fest, wenn Sie einen Agent ausführen

Wenn Sie Claude aus Ihrem eigenen Code heraus steuern, legen Sie das Budget pro Turn selbst fest. Das Claude Agent SDK (Software Development Kit) stellt dafür in Python max_turns und in TypeScript maxTurns bereit. Diese Optionen sind als maximale Anzahl von Tool-Aufrufen mit Roundtrips dokumentiert. Standardmäßig gibt es laut Dokumentation kein Limit.

Wenn dieses Limit erreicht ist, gibt das SDK ein Ergebnis zurück, dessen subtype den Wert error_max_turns hat. Ein einzelner query()-Aufruf löst dann einen Fehler aus, der den Text Reached maximum number of turns enthält. Das Ergebnis enthält weiterhin num_turns und session_id. Sie können dieselbe Sitzung daher mit einem höheren Limit fortsetzen, statt die Aufgabe neu zu starten.

In der CLI (Command-Line Interface) steuern Sie dasselbe über ein Flag. Es gilt nur im Print-Modus:

claude -p --max-turns 3 "summarise the failing tests"

Laut Flag-Referenz wird bei Erreichen des Limits ein Fehler ausgegeben. Standardmäßig gibt es kein Limit. Eine kostenbasierte Variante desselben Konzepts gibt es ebenfalls: max_budget_usd in Python und maxBudgetUsd in TypeScript beenden die Schleife, sobald ein Ausgabenlimit erreicht ist, statt eine bestimmte Anzahl von Turns abzuwarten. Die Ausgaben von Subagents werden dabei auf dieses Gesamtlimit angerechnet. Wenn Sie Agents auf einem Server ausführen, dessen Kosten Sie monatlich bezahlen, lohnt es sich, die Kosten eines AI-Agents auf einem VPS zu kontrollieren, bevor Sie den ersten längeren Lauf starten.

Eine Pause, in der auf eine Genehmigung gewartet wird, ist etwas anderes. Wenn Ihr Agent anhält und keine Kosten anfallen, prüfen Sie permission_mode statt der Turn-Anzahl. In diesem Fall wartet ein Tool auf eine menschliche Antwort, die nicht eintrifft. Der Auto-Modus und die Berechtigungseinstellungen von Claude Code erläutern, in welchen Modi Rückfragen gestellt werden und welche Modi ohne Rückfragen ausgeführt werden.

So prüfen Sie das aktuelle Verhalten selbst

Das Verhalten ändert sich ohne Ankündigung. Betrachten Sie daher jede Zahl in diesem Leitfaden als zeitgebunden und nicht als festen Wert. Zwei Stellen zeigen, was derzeit gilt.

• Die API-Dokumentation zu Abbruchgründen. Sie nennt den Standardwert für die Iterationen des Server-Tools und beschreibt, wie Sie darüber hinaus fortfahren.
• Die Hilfeseite von Anthropic zu Fehlermeldungen. Sie führt die Formulierung für das Nutzungslimit auf. Zum Stand vom 18. August 2026 dokumentiert diese Seite die Nutzungsmeldungen für fünf Stunden und eine Woche. Ein Tool-Limit pro Durchlauf wird nicht erwähnt. Deshalb wird hier keine offizielle Zahl für die Chat-Anwendung genannt.

Messen Sie stattdessen Ihre eigenen Durchläufe. In Claude Code zeigt /context die aktuelle Kontextauslastung als farbiges Raster an und weist auf die Tools hin, die den größten Anteil davon verbrauchen. /compact fasst die bisherige Unterhaltung zusammen und schafft dadurch freien Platz. Im Agent SDK enthält jedes Ergebnis num_turns. Damit sehen Sie, wie viele Roundtrips eine typische Aufgabe tatsächlich benötigt, bevor Sie ein Limit festlegen. Eine Zahl aus Ihrer eigenen Arbeitslast ist aussagekräftiger als eine Zahl aus einem Forenbeitrag.

FAQ

Ist das Nutzungslimit für Tools dasselbe wie mein Claude-Nutzungslimit?

Nein. Das Nutzungslimit zählt, wie viel Sie innerhalb eines Zeitfensters verbraucht haben, und zeigt an, wann es zurückgesetzt wird. In diesem Fall hilft Abwarten. Die Meldung zur Tool-Nutzung beendet eine Antwort vorzeitig, weil diese Antwort ihr Kontingent an Tool-Aufrufen aufgebraucht hat. Eine weitere Nachricht startet sofort einen neuen Turn mit einem neuen Kontingent. Wenn die Fortsetzung unmittelbar funktioniert, war Ihr Kontingent nicht das Problem. So werden Claude-Nutzungslimits gezählt behandelt den Fall mit dem Kontingent vollständig.

Wie bringe ich Claude dazu, eine vorzeitig abgebrochene Aufgabe zu beenden?

Senden Sie eine weitere Nachricht. „Continue“ funktioniert. Eine Anweisung, die das noch Fehlende benennt, funktioniert besser, weil das Modell den bereits vorhandenen Kontext nicht erneut aufbauen muss. Wenn es ein zweites Mal an derselben Stelle stoppt, teilen Sie die Aufgabe in kleinere Abschnitte auf und senden Sie pro Nachricht einen Abschnitt. Wenn Sie genaue Dateipfade angeben oder den Inhalt direkt einfügen, entfällt die Suche, die das Kontingent beim ersten Versuch aufgebraucht hat.

Was bedeutet „límite de uso de herramientas“ oder „limite de uso de ferramentas“?

Dies sind die spanischen und portugiesischen Formulierungen derselben Meldung. Sie werden üblicherweise als „límite de uso de herramientas en este turno“ oder „limite de uso de ferramentas neste turno“ angezeigt. Die Bedeutung ist in jeder Sprache identisch: Claude hat die innerhalb einer einzelnen Antwort zulässigen Tool-Aufrufe aufgebraucht. Ihr Plan-Kontingent ist davon nicht betroffen. Die Lösung ist ebenfalls dieselbe. Antworten Sie mit der Bitte, fortzufahren, oder teilen Sie die Anfrage in kleinere Schritte auf. Das Abrechnungslimit wird in einer separaten Meldung angezeigt. Diese nennt eine Rücksetzzeit.

Erhöht ein Upgrade meines Plans das Tool-Nutzungslimit für einen Turn?

Die Planstufe und das Tool-Kontingent pro Turn sind unterschiedliche Einstellungen. Ein Upgrade erhöht die Nutzung innerhalb eines Zeitfensters. Das ist das Limit, bei dem eine Rücksetzzeit angegeben wird. Wie viele Tool-Aufrufe eine einzelne Antwort ausführen darf, hängt von der Schleife ab, in der das Modell ausgeführt wird. Anthropic veröffentlicht diese Zahl für die Chat-Anwendung nicht. Das Aufteilen der Aufgabe in kleinere Turns hilft tatsächlich, unabhängig vom Plan.

Warum stoppt mein eigener Agent bereits nach wenigen Tool-Aufrufen?

Prüfen Sie, ob Sie ein Limit festgelegt haben. Das Claude Agent SDK verwendet max_turns in Python und maxTurns in TypeScript. Die Befehlszeilenschnittstelle verwendet --max-turns im Print-Modus. Wenn eines dieser Limits erreicht ist, gibt das SDK ein Ergebnis mit einem subtype von error_max_turns und einem Fehler zurück, der den Text Reached maximum number of turns enthält. Standardmäßig gibt es in beiden Fällen kein Limit. Wenn kein Limit gesetzt ist und die Ausführung trotzdem stoppt, prüfen Sie stop_reason im Ergebnis: max_tokens bedeutet, dass die Ausgabebegrenzung erreicht wurde. pause_turn bedeutet, dass die serverseitige Tool-Schleife ihr Iterationslimit erreicht hat und die Antwort zurückgesendet werden soll, damit sie fortgesetzt werden kann.