SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor

Claude: Tool-Nutzungslimit in diesem Durchlauf erklärt

Die Meldung bedeutet nicht, dass Ihr Planlimit erreicht ist: Claude hat nur das Kontingent für Tool-Aufrufe in diesem Durchlauf verbraucht. So machen Sie weiter.

Was das Nutzungslimit für Tools in diesem Durchlauf bedeutet

Ein Nutzungslimit für Tools in diesem Durchlauf bedeutet, dass Claude die Antwort teilweise beendet hat, weil diese Antwort das zulässige Kontingent an Tool-Aufrufen ausgeschöpft hat. Das bedeutet nicht, dass Ihr Konto sein Nutzungslimit erreicht hat. Alle Ergebnisse, die Claude vor dem Abbruch gefunden hat, sind weiterhin in der Unterhaltung verfügbar. Bitten Sie Claude in einer weiteren Nachricht, fortzufahren. Dadurch wird ein neuer Durchlauf mit einem neuen Kontingent gestartet.

Im Agent SDK bezeichnet ein Durchlauf eine vollständige Iteration innerhalb einer Agent-Schleife. Claude erzeugt eine Ausgabe mit Tool-Aufrufen. Der Client führt diese Tools aus. Die Ergebnisse werden anschließend an Claude zurückgegeben, damit Claude die nächste Entscheidung treffen kann. Dieser Zyklus wiederholt sich, ohne die Kontrolle an Sie zurückzugeben. Die Schleife endet, wenn Claude eine Antwort ohne Tool-Aufrufe erzeugt. Das Limit eines Durchlaufs im SDK zählt jede Iteration, einschließlich der abschließenden Antwort ohne Tool-Aufrufe.

Das Nutzungslimit Ihres Tarifs ist eine separate Steuerung

Das Tariflimit erfasst, wie viel Sie innerhalb eines Zeitfensters genutzt haben. Die Hilfeseite von Anthropic zu Fehlermeldungen, geprüft am 9. November 2026, führt diese Meldung als Approaching session limit auf, wenn Sie sich dem Limit nähern, und als 5-hour limit reached - resets [time], sobald Sie es überschreiten. Für das Wochenlimit gibt es entsprechende Meldungen, die einen Tag und eine Uhrzeit für die Zurücksetzung nennen. In beiden Fällen wird eine Uhrzeit angegeben. Ohne Nutzungsguthaben wird das Problem behoben, wenn Sie bis zu diesem Zeitpunkt warten. Ihre Eingaben helfen in der Zwischenzeit nicht. Wenn Sie für einen kostenpflichtigen Tarif Nutzungsguthaben aktiviert haben, wird Ihre Arbeit laut dieser Seite stattdessen mit Guthaben fortgesetzt. Die Meldung lautet dann 5-hour limit resets [time] - continuing with usage credits. Diese Fortsetzung endet, sobald Sie Ihr monatliches Ausgabenlimit erreichen oder Ihr Guthaben aufgebraucht ist, wenn die automatische Aufladung deaktiviert ist. Verifizierte Ultra-Konten haben kein Sitzungslimit von fünf Stunden. Wochenlimits gelten jedoch weiterhin.

Die Meldung zur Tool-Nutzung verhält sich umgekehrt. Sie erscheint während einer Aufgabe. Eine einzelne Folgemeldung ermöglicht die sofortige Fortsetzung der Arbeit. Bereits ausgeführte Tool-Aufrufe werden weiterhin auf die Tarifnutzung angerechnet. Die Fortsetzung setzt Ihr Kontingent nicht zurück. Nutzungsguthaben kann ebenfalls die Fortsetzung ermöglichen, nachdem ein Tariflimit erreicht wurde. Für den Fall eines Kontingentlimits führt was Sie tun können, wenn Claude meldet, dass das Limit erreicht ist die verfügbaren Optionen auf. wie die 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

Die öffentliche Fehlerdokumentation von Anthropic nennt für die Claude-Chat-App keine Anzahl von Tool-Aufrufen pro Runde. Jede genaue Zahl, die Sie dafür lesen, ist daher eine Vermutung. Eine entsprechende Form von Limit ist für die API (application programming interface) dokumentiert. In dieser Dokumentation ist 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 serverseitiger Tools wie der Websuche ihr Iterationslimit erreicht. Am 25 October 2026 nennt die Seite zu Beendigungsgründen und Fallbacks als Standardwert 10 Iterationen pro Anfrage. Die dokumentierte Lösung besteht darin, die Antwort unverändert als Assistant-Nachricht zurückzusenden. Claude setzt dann an der Stelle fort, an der es pausiert hat. Sie fügen keine neue Benutzernachricht mit der Aufforderung zum Fortsetzen hinzu. Im dokumentierten Beispiel werden nur die ursprüngliche Benutzernachricht und anschließend der pausierte Inhalt der Assistant-Nachricht gesendet.

max_tokens bedeutet, dass die Antwort die für die Anfrage festgelegte Obergrenze für Ausgabetokens erreicht hat. Wird die Antwort innerhalb eines unvollständigen Tool-Nutzungsblocks abgeschnitten, kann der Tool-Aufruf nicht ausgeführt werden. Die dokumentierte Lösung besteht darin, die Anfrage mit einem höheren max_tokens zu wiederholen.

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

Warum einem Chat die Tool-Aufrufe ausgehen

  • Eine Frage ohne natürlichen Endpunkt. "Find everything written about X" 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, den der Rest der Runde benötigt.
  • Mehrere unabhängige Aufgaben in einer Nachricht. Jede Aufgabe benötigt eigene Tool-Aufrufe. Alle werden aus demselben Budget bezahlt.
  • Connectors und MCP (model context protocol)-Server, die Sie für diese Aufgabe nicht verwenden. Sobald sie geladen sind, belegen sie Platz in der Unterhaltung und geben dem Modell weitere Möglichkeiten, die Runde zu nutzen.

So schließen Sie die Antwort ab

Antworten Sie mit "continue". Besser ist eine kurze Anweisung, die nennt, was noch fehlt. Dadurch wird eine neue Runde mit einem neuen Budget geöffnet. Die bisherige Unterhaltung bleibt im Kontext. Claude setzt daher fort, statt die bereits ausgeführten Tool-Aufrufe zu wiederholen.

Wenn Claude zweimal an derselben Stelle hängen bleibt, ist die Aufgabe für eine einzelne Runde zu umfangreich. Teilen Sie sie dann auf. Bitten Sie statt um eine vollständige Prüfung eines Repositorys zuerst um die Dateiliste. Fragen Sie anschließend pro Nachricht nach einer Datei. Vier kleine Runden schließen eine Arbeit ab, die eine große Runde nicht bewältigt.

Schränken Sie ein, wonach das Modell suchen soll. Geben Sie den exakten Dateipfad oder die exakte Fehlerzeichenfolge an. Wenn Sie das Log bereits haben, fügen Sie es ein. Ein eingefügtes Log kostet eine Nachricht. Wenn das Modell das Log suchen muss, kostet dies mehrere Tool-Aufrufe. Außerdem kann es das falsche Log finden.

Deaktivieren Sie Connectors, die Sie momentan nicht benötigen. Laut Anthropics Hilfecenter belegt jeder Connector Platz in einer Unterhaltung. Bei der Standardeinstellung Auto entscheidet Claude, welche Connectors geladen werden. Always available lädt alle Connectors am Anfang. Jeder geladene Connector verbraucht Kontext und erweitert die Menge der Aktionen, die das Modell auswählen kann. Wenn Sie viele Connectors verwenden, lädt die Einstellung On demand sie erst, nachdem Claude nach dem passenden Connector gesucht hat. Dasselbe gilt für eine lange Codierungssitzung. den Kontext einer Claude-Code-Sitzung klein zu halten entscheidet darüber, ob ein Agent die Arbeit abschließt oder auf halbem Weg stoppt.

Legen Sie das Turn-Budget beim Ausführen eines Agents selbst fest

Wenn Sie Claude aus Ihrem eigenen Code heraus steuern, legen Sie das Turn-Budget der Schleife selbst fest. Das Claude Agent SDK (Software Development Kit) stellt dafür max_turns in Python und maxTurns in TypeScript bereit. Diese zählen Turns mit Tool-Aufrufen sowie die abschließende Antwort ohne weitere Tools. 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. Die Seite zur Agent-Schleife im Agent SDK dokumentiert für diesen Fehler bei einem einzelnen Aufruf außerdem einen von null verschiedenen Exit-Status des zugrunde liegenden Claude-Code-Prozesses. 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 (Befehlszeilenschnittstelle) wird dieselbe Einstellung über ein Flag vorgenommen. Sie gilt jedoch nur im Print-Modus:

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

In der Flag-Referenz ist standardmäßig kein Limit festgelegt. Mit --input-format stream-json bleibt eine Nachricht, die beim Erreichen des Limits noch in der Warteschlange steht, dort und startet einen neuen Turn mit einem eigenen Limit. Es gibt eine entsprechende Variante auf Basis der Kosten: max_budget_usd in Python und maxBudgetUsd in TypeScript beenden die Schleife bei Erreichen eines Ausgabenlimits statt nach einer bestimmten Anzahl von Turns. Die Ausgaben von Subagents werden dabei auf diesen Gesamtbetrag angerechnet. Das Budget wird geprüft, nachdem die Antworten des Modells eingegangen sind. Daher können die Kosten durch die Antwort, mit der das Limit erreicht wird, und durch im Hintergrund laufende Subagents, die vor dem Beenden noch fertig werden, über dem Limit liegen. 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 langen Lauf starten.

Eine Pause, in der auf eine Genehmigung gewartet wird, ist etwas anderes. Wenn Ihr Agent anhält und keine weiteren Kosten entstehen, prüfen Sie permission_mode statt der Anzahl der Turns. In diesem Fall wartet ein Tool auf eine menschliche Antwort, die nicht eintrifft. Der Auto-Modus und die Berechtigungseinstellungen von Claude Code erläutert, welche Modi nachfragen und welche ohne Rückfrage 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 zeitabhängig und nicht als festen Wert. Zwei Stellen zeigen, was aktuell gilt.

  • Die API-Dokumentation zu Abbruchgründen. Sie nennt den Standardwert für Iterationen des Server-Tools und beschreibt, wie Sie darüber hinaus fortfahren.
  • Die Hilfeseite von Anthropic zu Fehlermeldungen. Sie enthält die Formulierung zur Nutzungsgrenze. Am 9. November 2026 dokumentierte diese Seite die Nutzungsnachrichten für fünf Stunden und eine Woche, einschließlich der Varianten, die angezeigt werden, wenn Nutzungsguthaben verwendet werden. Eine Werkzeuggrenze pro Durchlauf wird dort 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 Kontextnutzung als farbiges Raster an und weist auf die Werkzeuge hin, die den größten Anteil davon verbrauchen. /compact fasst die bisherige Konversation zusammen und gibt Speicherplatz frei. Im Agent SDK enthält jedes Ergebnis num_turns. Damit sehen Sie, wie viele Durchläufe eine typische Aufgabe tatsächlich benötigt, bevor Sie eine Obergrenze 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, was Sie innerhalb eines Zeitfensters verbraucht haben, und zeigt an, wann es zurückgesetzt wird. In diesem Fall hilft Warten. Die Meldung zum Tool-Nutzungslimit beendet eine Antwort vorzeitig, weil diese Antwort ihre Tool-Aufrufe aufgebraucht hat. Mit einer weiteren Nachricht beginnt sofort ein neuer Durchlauf mit einem neuen Budget. Die Tool-Nutzung wird weiterhin auf Ihr Tarifkontingent angerechnet. So werden Claude-Nutzungslimits berechnet behandelt das Kontingent vollständig.

Wie bringe ich Claude dazu, eine Aufgabe zu beenden, die vorzeitig abgebrochen wurde?

Senden Sie eine weitere Nachricht. „Fortsetzen“ funktioniert. Eine Anweisung, die konkret nennt, was noch fehlt, 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 Teile auf und senden Sie pro Nachricht einen Teil. Genaue Dateipfade oder direkt eingefügter Inhalt vermeiden die Suche, die das Budget 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. Meist erscheinen sie als „límite de uso de herramientas en este turno“ oder „limite de uso de ferramentas neste turno“. Die Bedeutung ist in jeder Sprache identisch: Claude hat die Tool-Aufrufe aufgebraucht, die innerhalb einer einzelnen Antwort zulässig sind. Ihr Tarifkontingent 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 Zurücksetzungszeit.

Erhöht ein Tarif-Upgrade das Tool-Nutzungslimit für einen Durchlauf?

Die Tarifstufe und das Tool-Budget pro Durchlauf sind unterschiedliche Einstellungen. Ein Upgrade erhöht die Nutzung innerhalb eines Zeitfensters. Das ist das Limit, bei dem eine Zurücksetzungszeit genannt 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 diesen Wert für die Chat-Anwendung nicht. Das Aufteilen der Aufgabe in kleinere Durchläufe hilft tatsächlich, unabhängig vom Tarif.

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

Prüfen Sie, ob Sie ein Limit gesetzt haben. Das Claude Agent SDK verwendet in Python max_turns und in TypeScript maxTurns. Die Befehlszeilenschnittstelle verwendet im print mode --max-turns. Wenn eines dieser Limits erreicht ist, gibt das SDK ein Ergebnis mit einem subtype von error_max_turns zurück. Ein einzelner query()-Aufruf löst dann einen Fehler aus, 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 der Durchlauf trotzdem stoppt, lesen Sie stop_reason im Ergebnis aus: 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.

War dieser Artikel hilfreich?