Effort

Mit dem „effort"-Parameter (Aufwand) kannst du steuern, wie viele Tokens Claude beim Beantworten von Anfragen verwendet. Du kannst mit einem einzigen Modell zwischen Gründlichkeit der Antwort und Token-Effizienz abwägen. Der Effort-Parameter ist bei allen unterstützten Modellen verfügbar, ohne dass ein Beta-Header erforderlich ist.



Wie Effort funktioniert

Standardmäßig verwendet Claude hohen Effort und nutzt so viele Tokens wie nötig, um hervorragende Ergebnisse zu erzielen. Du kannst die Effort-Stufe auf max erhöhen, um die absolut höchste Leistungsfähigkeit zu erhalten, oder sie senken, um sparsamer mit Tokens umzugehen und so auf Geschwindigkeit und Kosten zu optimieren – bei gleichzeitiger Inkaufnahme einer gewissen Reduzierung der Leistungsfähigkeit.

Der Effort-Parameter wirkt sich auf alle Tokens in der Antwort aus, einschließlich:

• Textantworten und Erklärungen
• Tool-Aufrufe und Funktionsargumente
• Thinking (wenn aktiv)

Dieser Ansatz hat zwei wesentliche Vorteile:

1. Er erfordert nicht, dass Thinking aktiviert ist.
2. Er kann den gesamten Token-Verbrauch beeinflussen, einschließlich Tool-Aufrufen. Ein niedrigerer Effort würde beispielsweise bedeuten, dass Claude weniger Tool-Aufrufe durchführt. Dies ermöglicht ein deutlich höheres Maß an Kontrolle über die Effizienz.



Effort-Stufen

xhigh ist eine neuere Stufe; einige Modelle, die max unterstützen, unterstützen xhigh nicht.



Empfohlene Effort-Stufen für Claude Sonnet 5

Claude Sonnet 5 verwendet standardmäßig high Effort in der Claude API und in Claude Code.

• High Effort (Standard): Geeignet für komplexes Reasoning, Coding und agentische Aufgaben, bei denen Qualität wichtiger ist als Geschwindigkeit oder Kosten.
• Xhigh Effort: Für die schwierigsten Coding- und agentischen Aufgaben. Siehe Prompting für Claude Sonnet 5.
• Medium Effort: Kostensparende Abstufung vom Standard. Vergleichbar mit Claude Sonnet 4.6 bei High Effort.
• Low Effort: Für Workloads mit hohem Volumen oder Latenzempfindlichkeit. Geeignet für Chat- und Nicht-Coding-Anwendungsfälle, bei denen schnellere Durchlaufzeiten Priorität haben.
• Max Effort: Für Aufgaben, die die absolut höchste Leistungsfähigkeit ohne Einschränkungen beim Token-Verbrauch erfordern.



Empfohlene Effort-Stufen für Claude Sonnet 4.6

Sonnet 4.6 verwendet standardmäßig high Effort. Setze Effort explizit, wenn du Sonnet 4.6 verwendest, um unerwartete Latenz zu vermeiden:

• Medium Effort (empfohlener Standard): Bestes Gleichgewicht aus Geschwindigkeit, Kosten und Leistung für die meisten Anwendungen. Geeignet für agentisches Coding, Tool-intensive Workflows und Code-Generierung.
• Low Effort: Für Workloads mit hohem Volumen oder Latenzempfindlichkeit. Geeignet für Chat- und Nicht-Coding-Anwendungsfälle, bei denen schnellere Durchlaufzeiten Priorität haben.
• High Effort: Für komplexes Reasoning und Aufgaben, bei denen Qualität wichtiger ist als Geschwindigkeit oder Kosten.
• Max Effort: Für Aufgaben, die die absolut höchste Leistungsfähigkeit ohne Einschränkungen beim Token-Verbrauch erfordern.



Empfohlene Effort-Stufen für Claude Opus 4.7

Beginne mit xhigh für Coding- und agentische Anwendungsfälle und verwende high als Minimum für die meisten intelligenzsensitiven Workloads. Gehe auf medium herunter für kostensensitive Workloads, oder auf max hoch nur dann, wenn deine Evaluierungen messbaren Spielraum bei xhigh zeigen.

Der API-Standard ist high. Um xhigh zu verwenden, setze effort explizit; der übergebene Wert überschreibt den Standard.

Claude Opus 4.7 hält sich außerdem strikter an Effort-Stufen als Claude Opus 4.6, insbesondere bei low und medium. Bei niedrigeren Effort-Stufen beschränkt das Modell seine Arbeit auf das, was gefragt wurde, anstatt mehr als angefordert zu tun. Wenn du bei komplexen Problemen mit Claude Opus 4.7 oberflächliches Reasoning beobachtest, erhöhe den Effort, anstatt dies über Prompting zu umgehen. Wenn du den Effort aus Latenzgründen niedrig halten musst, füge gezielte Hinweise hinzu wie „Diese Aufgabe erfordert mehrstufiges Reasoning. Denke sorgfältig nach, bevor du antwortest."

Wenn du Claude Opus 4.7 mit xhigh oder max Effort ausführst, setze einen hohen max_tokens-Wert, damit das Modell genug Raum hat, um über Subagenten und Tool-Aufrufe hinweg zu denken und zu handeln. Mit 64k Tokens zu beginnen und von dort aus anzupassen ist ein vernünftiger Standardwert.



Empfohlene Effort-Stufen für Claude Opus 4.8

Die Empfehlungen für Claude Opus 4.7 gelten auch für Claude Opus 4.8. Beginne mit xhigh für Coding- und agentische Anwendungsfälle, verwende high für die meisten anderen intelligenzsensitiven Workloads und gehe nur dann auf medium oder low herunter, wenn du gemessen hast, dass die niedrigere Stufe die Qualität in deinen Evaluierungen hält.

Der API-Standard ist high. Setze effort explizit, um eine andere Stufe zu verwenden; der übergebene Wert überschreibt den Standard.

Wenn du Claude Opus 4.8 mit xhigh oder max Effort ausführst, setze einen hohen max_tokens-Wert, damit das Modell genug Raum hat, um über Subagenten und Tool-Aufrufe hinweg zu denken und zu handeln. Mit 64k Tokens zu beginnen und von dort aus anzupassen ist ein vernünftiger Standardwert.



Empfohlene Effort-Stufen für Claude Opus 5

Claude Opus 5 unterstützt alle fünf Effort-Stufen. Beginne mit high, dem Standard, und passe basierend auf deinen Evaluierungen an: Gehe auf xhigh hoch für anspruchsvolle Coding- und agentische Arbeit oder auf max, wenn eine Aufgabe unbegrenzten Token-Verbrauch rechtfertigt, und nutze low und medium großzügig als primäre Steuerung für Token-Kosten und Antwortzeit, wo immer deine Evaluierungen zeigen, dass die Qualität gehalten wird. Wenn du Effort-Einstellungen von einem früheren Modell übernommen hast, führe einen neuen Effort-Durchlauf mit deinen Evaluierungen durch, anstatt sie wiederzuverwenden.

Effort steuert das Thinking-Volumen, nicht die sichtbare Antwortlänge: Bei Claude Opus 5 verkürzt eine Änderung des Efforts die Antworten nicht zuverlässig, verwende daher stattdessen Prompting für die Länge.

Der API-Standard ist high. Setze effort explizit, um eine andere Stufe zu verwenden; der übergebene Wert überschreibt den Standard.

Bei Claude Opus 5 kann Thinking bei xhigh oder max Effort nicht deaktiviert werden: Anfragen, die bei diesen Stufen thinking: {"type": "disabled"} setzen, geben einen 400-Fehler zurück. Siehe Effort mit Thinking.

Wenn du Claude Opus 5 mit xhigh oder max Effort ausführst, setze einen hohen max_tokens-Wert, damit das Modell genug Raum hat, um über Subagenten und Tool-Aufrufe hinweg zu denken und zu handeln. Mit 64k Tokens zu beginnen und von dort aus anzupassen ist ein vernünftiger Standardwert.



Empfohlene Effort-Stufen für Claude Fable 5

Effort ist die primäre Steuerung für die Abwägung zwischen Intelligenz, Latenz und Kosten bei Claude Fable 5. Beginne mit high, dem Standard, für die meisten Aufgaben, verwende xhigh für die leistungssensitivsten Workloads und gehe auf medium oder low herunter für Routinearbeit. Niedrigere Effort-Einstellungen bei Claude Fable 5 liefern weiterhin gute Ergebnisse und übertreffen oft die xhigh-Leistung früherer Modelle. Bei high und xhigh setze einen hohen max_tokens-Wert: Es ist ein hartes Limit für die Gesamtausgabe, Thinking plus Antworttext. Siehe Kostenkontrolle.

Reduziere den Effort, wenn eine Aufgabe abgeschlossen wird, aber länger als nötig dauert, oder wenn du einen schnelleren, interaktiveren Arbeitsstil möchtest. Dieselben Empfehlungen gelten für Claude Mythos 5. Ausführlichere Hinweise findest du unter Prompting für Claude Fable 5.



Grundlegende Verwendung

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    messages=[
        {
            "role": "user",
            "content": "Analyze the trade-offs between microservices and monolithic architectures",
        }
    ],
    output_config={"effort": "medium"},
)

for block in response.content:
    if block.type == "text":
        print(block.text)



Wann du den Effort-Parameter anpassen solltest

• Verwende Max Effort, wenn du die absolut höchste Leistungsfähigkeit ohne Einschränkungen benötigst: das gründlichste Reasoning und die tiefste Analyse. Verfügbar bei Claude 4.6 und neueren Modellen sowie Claude Mythos Preview.
• Verwende Xhigh Effort für fortgeschrittenes Coding und komplexe agentische Arbeit, die erweiterte Exploration erfordert, wie wiederholte Tool-Aufrufe und detaillierte Suche. Verfügbar bei Claude Fable 5, Claude Mythos 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7 und Claude Sonnet 5.
• Verwende High Effort (den Standard) für komplexes Reasoning, nuancierte Analysen, schwierige Coding-Probleme oder jede Aufgabe, bei der Qualität wichtiger ist als Geschwindigkeit oder Kosten.
• Verwende Medium Effort als ausgewogene Option, wenn du solide Leistung ohne den vollen Token-Verbrauch von High Effort möchtest.
• Verwende Low Effort, wenn du auf Geschwindigkeit (weil Claude mit weniger Tokens antwortet) oder Kosten optimierst. Zum Beispiel bei einfachen Klassifizierungsaufgaben, schnellen Abfragen oder Anwendungsfällen mit hohem Volumen, bei denen marginale Qualitätsverbesserungen zusätzliche Latenz oder Ausgaben nicht rechtfertigen.



Effort mit Tool-Nutzung

Bei der Verwendung von Tools wirkt sich der Effort-Parameter sowohl auf die Erklärungen rund um Tool-Aufrufe als auch auf die Tool-Aufrufe selbst aus. Niedrigere Effort-Stufen tendieren dazu:

• Mehrere Operationen in weniger Tool-Aufrufen zu kombinieren
• Weniger Tool-Aufrufe durchzuführen
• Direkt zur Aktion überzugehen, ohne Einleitung
• Knappe Bestätigungsnachrichten nach Abschluss zu verwenden

Höhere Effort-Stufen können:

• Mehr Tool-Aufrufe durchführen
• Den Plan erklären, bevor Aktionen ausgeführt werden
• Detaillierte Zusammenfassungen der Änderungen liefern
• Umfassendere Code-Kommentare einfügen



Effort mit Thinking

Der thinking-Parameter steuert, ob Claude in Thinking-Blöcken denkt, bevor es antwortet; der effort-Parameter steuert, wie viel Arbeit Claude in die gesamte Antwort steckt, was im adaptiven Modus auch einschließt, wie oft und wie tiefgehend es denkt. Übergib nicht adaptive als effort-Wert: adaptive ist ein Thinking-Modus, keine Effort-Stufe.

Bei höheren Effort-Stufen denkt Claude bei den meisten Anfragen und ausführlicher nach; bei niedrigeren Stufen kann es das Thinking bei einfacheren Problemen komplett überspringen. Siehe Thinking und Effort für vollständige Hinweise, wie die beiden Steuerungen zusammenwirken.

Bei Claude Opus 4.5, dem einzigen reinen Extended-Thinking-Modell, das Effort unterstützt, funktioniert es zusammen mit budget_tokens: Setze die Effort-Stufe für deine Aufgabe und dann das Thinking-Token-Budget basierend darauf, wie viel Reasoning-Tiefe die Aufgabe benötigt.

Zur Thinking-Verfügbarkeit pro Modell siehe die Konfigurationstabelle pro Modell. Effort funktioniert mit oder ohne Thinking; siehe Wie Effort funktioniert.



Effort mitten in einer Konversation ändern

output_config.effort ist eine Einstellung auf Request-Ebene: Jede Anfrage trägt ihren eigenen Wert. Um einen späteren Teil einer Konversation mit einer anderen Effort-Stufe auszuführen, setze den neuen Wert bei der nächsten Anfrage. Die Effort-Stufe gilt für die gesamte Anfrage. Da Effort den gerenderten Prompt beeinflusst, bleiben beim Ändern zwischen Anfragen keine gecachten Präfixe aus früheren Turns erhalten; wenn du dich über eine lange Sitzung hinweg auf Prompt-Caching verlässt, wähle zu Beginn eine Effort-Stufe und halte sie konstant.



Best Practices

1. Setze Effort explizit: Der API-Standard ist high, aber der richtige Ausgangspunkt hängt von deinem Modell und Workload ab.
2. Verwende Low für geschwindigkeitssensitive oder einfache Aufgaben: Wenn Latenz wichtig ist oder Aufgaben unkompliziert sind, kann Low Effort Antwortzeiten und Kosten erheblich reduzieren.
3. Teste deinen Anwendungsfall: Die Auswirkung der Effort-Stufen variiert je nach Aufgabentyp. Evaluiere die Leistung für deine spezifischen Anwendungsfälle vor dem Deployment.
4. Erwäge dynamischen Effort: Passe den Effort basierend auf der Aufgabenkomplexität an. Einfache Abfragen rechtfertigen möglicherweise Low Effort, während agentisches Coding und komplexes Reasoning von High Effort profitieren. Beachte den nächsten Punkt, bevor du ihn innerhalb einer Konversation variierst.
5. Halte Effort innerhalb gecachter Konversationen konstant: Das Ändern des Effort-Werts zwischen Anfragen macht das Prompt-Caching ungültig. Variiere Effort daher über Workloads hinweg und nicht innerhalb einer Konversation, die auf Cache-Treffer angewiesen ist. Siehe Thinking und Prompt-Caching.



Nächste Schritte