Leitfaden zur Konfiguration von Adaptive Thinking

Adaptive Thinking bei Claude Opus 5.5 / Sonnet 5.5 / Haiku 5.5 und 4.x: die Parameter thinking + effort, Unterschiede zum bisherigen budget_tokens sowie der Kompromiss zwischen Qualität und Kosten

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

Zuletzt überprüft: 2026-11-13 · 📄 Gemäß offizieller Dokumentation und qcode.cc/models (in diesem Durchgang wurde Zeile für Zeile geprüft, ob die Modelle in der Support-Matrix unten bei QCode im Verkauf sind; der übrige Teil der Parametertabelle wurde zuletzt am 2026-10-15 überprüft)

Adaptive Thinking ist der mit Claude 4.6 eingeführte Reasoning-Modus: Das Modell entscheidet selbst, wann es überlegt und wie viele Tokens es dafür einsetzt – Entwickler müssen kein festes Budget vorgeben. Mit dem Parameter effort steuern Sie die Reasoning-Tiefe grob. Dieser Leitfaden behandelt die API-Nutzung, die Modell-Support-Matrix und den Kompromiss zwischen Qualität und Kosten.

Herkunft der Angaben: Die Zeilen unten folgen der offiziellen Anthropic-Dokumentation (Stand 2026-10-15). Die 4.x-Modelle, die noch im Verkauf sind, wurden zuvor auf QCode als aufrufbar getestet; Modelle der 4.5-Generation und älter sind bei QCode nicht mehr verfügbar, und die 5er-Reihe ist auf QCode noch nicht Punkt für Punkt geprüft. Zur Modellwahl in der 5er-Reihe siehe Modellauswahl.

Die wichtigsten Unterschiede zum bisherigen Extended Thinking¶

Kurzregel: Für Modelle ab 4.6 verwenden Sie adaptive; budget_tokens nur für 4.5 und älter (diese älteren Modelle antworten auf type: "adaptive" mit 400).

Modell-Support-Matrix¶

Die oben genannten 4.x-Modelle, die noch im Verkauf sind, wurden zuvor auf QCode als aufrufbar getestet. Die beiden 4.5-Zeilen sind bei QCode nicht mehr verfügbar und dienen nur noch als Parameterreferenz; die im Verkauf befindlichen Modelle stehen auf qcode.cc/models. Das Parameterverhalten der 5er-Reihe folgt der offiziellen Dokumentation, Preise und Verfügbarkeit je Modell finden Sie auf qcode.cc/models.

Der Parameter effort: Ein grober Regler für die Reasoning-Tiefe¶

effort steuert die Gesamtintensität von Adaptive Thinking (Denk-Tokens, Anzahl der Tool-Aufrufe, Ausführlichkeit der Antwort). In der Anfrage wird er als output_config.effort angegeben.

Faustregel: Opus 5.5 und Haiku 5.5 verwenden standardmäßig medium, Sonnet 5.5 in der API high; Anthropic rät, nach einem Modellwechsel die eigenen Evals neu laufen zu lassen, statt Einstellungen vom alten Modell zu übernehmen. xhigh bietet bei langen Agent-Schleifen (z. B. mehrstufiges Code-Review, tiefe Recherche) das beste Preis-Leistungs-Verhältnis; max lohnt sich nur, wenn Korrektheit weit wichtiger ist als Kosten. Wenn Sie die Stufe erhöhen, erhöhen Sie auch max_tokens, da Denk-Tokens auf das Ausgabelimit angerechnet werden.

Eine Änderung von effort entwertet den Prompt-Cache: Damit der Cache weiter trifft, halten Sie Thinking-Konfiguration und effort innerhalb eines Gesprächs konstant. Wenn Sie mitten im Gespräch wechseln müssen, nutzen Sie die offizielle effort-Änderung pro Nachricht (Beta, Beta-Header mid-conversation-output-config-2026-07-01 erforderlich; unterstützt u. a. bei Opus 5.5, Sonnet 5.5 und Haiku 5.5).

API-Nutzungsbeispiele¶

Python (anthropic SDK)¶

import anthropic

client = anthropic.Anthropic(
    base_url="https://api.qcode.cc/api",
    api_key="cr_xxxxxxxx",
)

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    thinking={"type": "adaptive"},
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "Refaktoriere die Authentifizierungslogik des user-service-Moduls..."}],
)

for block in response.content:
    if block.type == "thinking":
        print(f"[Denken] {block.thinking}")
    elif block.type == "text":
        print(f"[Antwort] {block.text}")

TypeScript (@anthropic-ai/sdk)¶

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.qcode.cc/api",
  apiKey: "cr_xxxxxxxx",
});

const response = await client.messages.create({
  model: "claude-opus-5-5",
  max_tokens: 16000,
  thinking: { type: "adaptive" },
  output_config: { effort: "high" },
  messages: [{ role: "user", content: "Refaktoriere den user service..." }],
});

Claude Code CLI¶

In Claude Code stellen Sie effort mit /effort ein: Ohne Argument öffnet sich ein Schieberegler, /effort high setzt die Stufe direkt, /effort auto löscht die gespeicherte Stufe. Beim Start können Sie außerdem --effort übergeben oder die Umgebungsvariable CLAUDE_CODE_EFFORT_LEVEL setzen. Die aktuelle Stufe steht im Sitzungskopf neben dem Modellnamen. Wählbare Stufen: low, medium, high, xhigh und max bei Opus 5.5 / Sonnet 5.5 / Haiku 5.5 / Opus 5 / Sonnet 5 / Opus 4.8 / Opus 4.7; low, medium, high und max bei Opus 4.6 und Sonnet 4.6.

Standardwerte in Claude Code (offizielle Dokumentation, Stand 2026-10-15): medium bei Opus 5.5, Sonnet 5.5 und Haiku 5.5, xhigh bei Opus 4.7 und high bei den übrigen Modellen mit effort-Unterstützung. In Claude Code lässt sich das Thinking dieser drei 5.5-Modelle nicht abschalten; um weniger Thinking zu erhalten, senken Sie effort.

Darstellung von Thinking-Inhalten¶

Modelle der 5er-Reihe (einschließlich Opus 5.5, Sonnet 5.5 und Haiku 5.5) zeigen den Thinking-Text standardmäßig nicht an (display steht standardmäßig auf "omitted"); das Reasoning bleibt intern, die Denk-Tokens werden aber wie gewohnt abgerechnet. So zeigen Sie den Denkverlauf in Ihrer UI an:

thinking={"type": "adaptive", "display": "summarized"}

display: "summarized" lässt das Modell eine Zusammenfassung des Denkens ausgeben (sichtbare Thinking-Blöcke); omitted zählt die Denk-Tokens nur, ohne Text auszugeben.

Task-Budgets (Beta)¶

Wenn Sie eine Agent-Schleife betreiben und für die gesamte Runde (Thinking + Tools + finale Ausgabe) eine globale Obergrenze setzen möchten, verwenden Sie task_budget. Laut offizieller Dokumentation gibt es Beta-Unterstützung u. a. für Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Opus 4.8 und Opus 4.7; Sonnet 5 wird nicht unterstützt:

response = client.beta.messages.create(
    betas=["task-budgets-2026-03-13"],
    model="claude-opus-5-5",
    max_tokens=64000,
    thinking={"type": "adaptive"},
    output_config={
        "effort": "high",
        "task_budget": {"type": "tokens", "total": 128000},
    },
    messages=[...],
)

Das Modell sieht einen Countdown des verbleibenden Budgets und regelt sich selbst, um es nicht zu überschreiten. Der Mindestwert für total ist 20.000; kleinere Werte liefern 400.

Tipps zur Kostenobservabilität¶

Sobald Adaptive Thinking aktiv ist, steigen sowohl Input- als auch Output-Tokens; beobachten Sie sie entsprechend:

print(response.usage)
# Achten Sie auf: input_tokens, output_tokens, cache_read_input_tokens
# Adaptive Thinking rechnet Denk-Tokens nicht separat ab – sie werden als Output-Tokens abgerechnet und stecken in output_tokens

QCode rechnet pro Token ab; die Preise je Modell stehen auf qcode.cc/models. Anfragen werden an probe.qcode.cc gemeldet; dort sehen Sie je Anfrage das Verhältnis von Input, Output und Thinking.

FAQ¶

Wie wechsle ich von budget_tokens zu adaptivem Thinking?¶

Eine lineare Umrechnung gibt es nicht. budget_tokens=8000 entspricht keiner bestimmten effort-Stufe. Beginnen Sie mit effort: "medium" und justieren Sie anhand von Antwortqualität und Token-Verbrauch. Wenn Sie eine harte Obergrenze brauchen, nutzen Sie task_budget (siehe oben).

Meine Anfrage an Opus 4.7 / 4.8 / ein Modell der 5er-Reihe gibt 400 zurück und meldet, dass budget_tokens nicht erlaubt ist¶

Ersetzen Sie jedes thinking={"type": "enabled", "budget_tokens": N} durch thinking={"type": "adaptive"}. Opus 4.7 und neuer unterstützen budget_tokens nicht mehr (jeder Wert liefert 400).

Sollte ich budget_tokens in Sonnet 4.6 weiterhin verwenden?¶

Nicht empfohlen. Verwenden Sie für neuen Code durchgehend Adaptive Thinking. budget_tokens funktioniert in 4.6 noch, ist aber ein deprecated-Pfad.

Ich möchte das Thinking abschalten, Opus 5.5 liefert aber 400. Was tun?¶

Bei Opus 5.5 lässt sich das Thinking nicht abschalten. Damit es weniger überlegt, senken Sie effort (z. B. auf low). Bei Sonnet 5.5 nutzen Sie thinking: {"type": "between_tools"}, bei Haiku 5.5 thinking: {"type": "disabled"}; beides funktioniert nur bei effort high oder darunter.

Wie ändere ich die effort-Stufe in der Claude Code CLI?¶

Mit /effort (siehe oben) oder --effort beim Start; der dauerhafte Standard steht in ~/.claude/settings.json unter effortLevel oder in modelSettings je Modell.

Nächste Schritte¶

• Leitfaden zur Modellauswahl — Preise und Fähigkeitsvergleich der Modelle
• Best Practices — Prompting-Techniken für große Kontexte und Agent-Workflows
• Endpunkte und API-Pfade — Vollständige Übersicht der Zugangsdomains von QCode.cc
• Claude-Code-Tutorial — Alle CLI-Funktionen im Überblick

Enterprise →