So nutzen Sie Claude Haiku 5.5 in Claude Code (und als Subagenten-Modell)

Um Claude Haiku 5.5 in Claude Code zu verwenden, aktualisieren Sie Claude Code auf v2.1.293 oder höher, starten Sie eine Sitzung mit claude --model claude-haiku-5-5 oder wechseln Sie innerhalb einer Sitzung mit /model claude-haiku-5-5. Der praktischste Einsatz ist meist ein Subagent: Setzen Sie model: haiku in einer Subagenten-Datei und lassen Sie Sonnet 5.5 oder Opus 5.5 Suche, Testläufe und Zusammenfassungen delegieren. Mit API-Schlüssel kostet Haiku 5.5 bei Prompts bis 100K Tokens 0,10 $ pro Million Eingabe-Tokens und 0,50 $ pro Million Ausgabe-Tokens; oberhalb von 100K Tokens steigen die Preise auf 0,50 $ bzw. 2,50 $.

Apidog noch heute testen

Dieser Leitfaden zeigt die Einrichtung, die haiku-Alias-Falle, Aufwandseinstellungen, Subagenten-Dateien, die 100K-Preisschwelle und die Fälle, in denen Sonnet oder Opus die Führung behalten sollten. Eine Modellübersicht finden Sie unter was Claude Haiku 5.5 ist. Wenn Ihr Code APIs aufruft, können Sie mit Apidog Testszenarien verwalten, die ein Haiku-Subagent anschließend ausführt.

Claude Haiku 5.5 in Claude Code auf einen Blick

Einstellung	Haiku 5.5
Mindestversion	v2.1.293 (claude update)
Modell-ID	claude-haiku-5-5
haiku-Alias	Nur Haiku 5.5 auf der Anthropic API
Kontext	1M nativ in jedem Plan, kein [1m]-Suffix
Auto-Komprimierung	Standardmäßig etwa 967K Tokens
Standard-Aufwand	medium (Stufen low bis max)
Denken	Immer an; kann nicht ausgeschaltet werden
API-Preis	0,10 $/0,50 $ bis 100K Tokens; 0,50 $/2,50 $ darüber
Pläne	Pro, Max, Team, Enterprise oder API-Schlüssel; nicht kostenlos

Schritt 1: Claude Code aktualisieren

Haiku 5.5 benötigt Claude Code v2.1.293 oder höher. Der Changelog-Eintrag beschreibt es als das neue Standard-Haiku-Modell auf der Anthropic API.

claude update

Prüfen Sie anschließend die installierte Version und starten Sie Claude Code neu, falls das Update dazu auffordert.

Claude Code ist nicht im kostenlosen Plan enthalten. Kostenlose Benutzer können Haiku 5.5 in den Claude.ai-Apps auswählen. Für Claude Code benötigen Sie Pro, Max, Team, Enterprise oder einen Anthropic API-Schlüssel. Laut claude.com/pricing kostet Pro 17 $ monatlich bei jährlicher Abrechnung oder 20 $ monatlich; Max beginnt bei 100 $.

Schritt 2: Haiku 5.5 als Hauptmodell auswählen

Starten Sie eine neue Sitzung direkt mit Haiku 5.5:

claude --model claude-haiku-5-5

Oder wechseln Sie in einer laufenden Sitzung:

/model claude-haiku-5-5

Wenn Ihre gespeicherte model-Einstellung haiku lautet, wird eine zuvor auf Haiku 4.5 gespeicherte Sitzung auf der Anthropic API mit Haiku 5.5 fortgesetzt.

Der haiku-Alias bedeutet nicht überall Haiku 5.5

Anbieter	haiku löst auf zu
Anthropic API	Haiku 5.5
Claude Platform auf AWS	Haiku 4.5
Amazon Bedrock, Google Cloud’s Agent Platform	Haiku 4.5
Microsoft Foundry	Haiku 4.5

Bei diesen Cloud-Anbietern verweisen /model haiku und model: haiku in einer Subagenten-Datei auf Haiku 4.5.

Verwenden Sie deshalb die anbieterspezifische vollständige Modellreferenz:

• Google Cloud und Claude Platform auf AWS: claude-haiku-5-5
• Microsoft Foundry: Ihren Bereitstellungsnamen
• Amazon Bedrock: eine Inferenzprofil-ID wie us.anthropic.claude-haiku-5-5

Alternativ können Sie den Alias mit ANTHROPIC_DEFAULT_HAIKU_MODEL auf Haiku 5.5 setzen.

Schritt 3: Aufwand passend zur Aufgabe einstellen

Haiku 5.5 ist das erste Haiku-Modell mit Aufwandssteuerung:

low
medium
high
xhigh
max

Claude Code startet standardmäßig mit medium. Für längere oder anspruchsvollere Agenten-Aufgaben erhöhen Sie den Aufwand:

claude --model claude-haiku-5-5 --effort high

Innerhalb einer Sitzung ändern Sie ihn mit:

/effort low

Praktische Zuordnung:

• low: kurze Tool-Aufgaben, Dateisuche, Log-Auswertung, viele wiederholte Anfragen
• medium: Standard für die meisten Aufgaben
• high: längere Agenten-Abläufe mit mehreren Schritten
• xhigh und max: nur verwenden, wenn Ihre Evaluierungen messbare Vorteile zeigen

Das Denken bleibt in Claude Code für Haiku 5.5 aktiviert. alwaysThinkingEnabled: false und MAX_THINKING_TOKENS=0 haben dort keine Wirkung. Wenn Sie weniger Denk-Tokens benötigen, reduzieren Sie den Aufwand.

Schritt 4: Haiku 5.5 als Subagent einsetzen

Haiku 5.5 eignet sich besonders für klar abgegrenzte, wiederholbare Aufgaben. Anthropic empfiehlt die Kombination mit Sonnet 5.5 oder Opus 5.5 als führendem Modell.

Subagenten sind Markdown-Dateien mit YAML-Frontmatter:

• Projektweit: .claude/agents/
• Für alle lokalen Projekte: ~/.claude/agents/

Mindestens name und description sind erforderlich. Laut der Subagenten-Dokumentation akzeptiert model die Werte sonnet, opus, haiku, fable, eine vollständige Modell-ID oder inherit.

Weitere Hinweise zu Bereichen und Tools finden Sie im Subagenten-Leitfaden.

Explore durch einen günstigen Explorer ersetzen

Der eingebaute Explore-Subagent verwendet das Modell der Hauptkonversation. In einer Opus-5.5-Sitzung laufen Explore-Suchen also ebenfalls auf Opus.

Sie können ihn mit einem eigenen Subagenten namens Explore überschreiben:

---
name: Explore
description: Schnelle schreibgeschützte Codebase-Suche. Verwenden Sie dies, um Dateien, Symbole und Aufrufstellen zu finden, ohne etwas zu bearbeiten.
tools: Read, Grep, Glob
model: haiku
effort: low
---

Sie durchsuchen die Codebasis und berichten, was Sie finden. Geben Sie Dateipfade mit Zeilennummern und eine kurze Zusammenfassung jeder Übereinstimmung zurück. Bearbeiten Sie niemals Dateien.

Speichern Sie die Datei unter:

.claude/agents/Explore.md

Führen Sie während der Ausführung /tasks aus, um das verwendete Modell zu prüfen. Bei Bedrock, Foundry, Google Cloud oder Claude Platform auf AWS ersetzen Sie haiku durch die passende vollständige Modell-ID.

Alle Subagenten auf Haiku festlegen

Wenn jeder Subagent, einschließlich Explore, Haiku verwenden soll, setzen Sie beide Variablen im env-Block Ihrer Einstellungsdatei:

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

CLAUDE_CODE_SUBAGENT_MODEL allein ist nur ein Standardwert. Ein explizites model-Feld eines Subagenten hat weiterhin Vorrang, und Explore wird damit nicht überschrieben.

Schritt 5: Hintergrundaufgaben auf Haiku 5.5 ausrichten

ANTHROPIC_DEFAULT_HAIKU_MODEL legt fest, welches Modell Claude Code für haiku und Hintergrundfunktionen verwendet. Dazu gehört beispielsweise das Zusammenfassen früherer Sitzungen für:

claude --resume

Die ältere Variable ANTHROPIC_SMALL_FAST_MODEL ist laut der Referenz der Umgebungsvariablen veraltet. Ersetzen Sie sie in Ihrem Shell-Profil, falls sie noch gesetzt ist.

Auf der Anthropic API ist keine zusätzliche Konfiguration erforderlich. Bei Google Cloud, Foundry und Bedrock können Hintergrundaufgaben standardmäßig auf Sonnet oder dem primären Modell laufen. Sobald Haiku 5.5 in Ihrem Konto aktiviert ist, setzen Sie es explizit:

# Google Cloud's Agent Platform
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5

# Amazon Bedrock (Inferenzprofil-ID)
export ANTHROPIC_DEFAULT_HAIKU_MODEL=us.anthropic.claude-haiku-5-5

Die 100K-Preisschwelle in langen Sitzungen

Der Preis von Haiku 5.5 hängt von der Prompt-Länge ab. Claude Code sendet den bisherigen Gesprächskontext bei jeder Runde erneut als Prompt.

Sobald der Kontext 100K Tokens überschreitet, steigt der Preis von:

• 0,10 $ / 0,50 $ pro Million Eingabe-/Ausgabe-Tokens
• auf 0,50 $ / 2,50 $ pro Million Eingabe-/Ausgabe-Tokens

Das entspricht dem Fünffachen des Kurz-Prompt-Tarifs. Die Dokumentation legt nicht fest, ob zwischengespeicherte Tokens in diese Grenze einfließen. Planen Sie daher vorsichtshalber so, als würden sie angerechnet.

Die automatische Komprimierung greift standardmäßig erst bei etwa 967K Tokens. Damit kann eine Sitzung die 100K-Schwelle lange überschreiten, bevor Kontext reduziert wird.

Zwei Maßnahmen halten Kosten kontrollierbar:

1. Früher komprimieren

   /autocompact 100k

Das setzt das kleinste von Claude Code akzeptierte Kontextfenster, sodass die Komprimierung näher an der Preisschwelle erfolgt.

1. Umfangreiche Arbeit an Subagenten delegieren

Subagenten haben einen eigenen Kontext. Testprotokolle, Suchergebnisse und Log-Ausgaben bleiben dadurch aus der Hauptkonversation heraus.

Auch oberhalb von 100K Tokens liegen die Preise von Haiku 5.5 mit 0,50 $/2,50 $ noch bei einem Viertel von Sonnet 5.5 mit 2 $/10 $. Bei kostenpflichtigen Plänen greifen allerdings Nutzungslimits statt API-Abrechnung; Anthropic hat nicht veröffentlicht, wie Haiku 5.5 darauf angerechnet wird.

Eine detaillierte Berechnung finden Sie in der Aufschlüsselung der Haiku-5.5-Preise.

Für Max- und Team-Abonnenten gilt: Die monatlichen API-Guthaben — 100 $ bei Max 5x, 200 $ bei Max 20x und bis zu 500 $ gebündelt bei Team — decken interaktives Claude Code laut der API-Guthaben-Dokumentation nicht ab.

Wann Sonnet 5.5 oder Opus 5.5 die Führung behalten sollte

Für komplexe agentenbasierte Coding-Aufgaben bleiben Sonnet 5.5 und Opus 5.5 die bessere Wahl.

Auf Terminal-Bench 4.0, den Anthropic in Claude Code mit maximalem Aufwand ausführte, erreichte Haiku 5.5 39,2 %, Sonnet 5.5 dagegen 70,6 %.

Aufwand	Haiku 5.5	Sonnet 5.5
medium	20,3 % bei 0,68 $	28,8 % bei 0,68 $
high	24,8 % bei 1,04 $	43 % bei 1,46 $
max	39,2 % bei 2,64 $	70,6 % bei 10,44 $

Bei medium kosten beide Modelle pro Versuch etwa gleich viel, während Sonnet höhere Werte erzielt. Der niedrigere Token-Preis von Haiku bedeutet daher nicht automatisch niedrigere Gesamtkosten für lange Shell- und Agenten-Aufgaben.

Bei Computernutzung sieht es anders aus: Auf OSWorld 2.1 erreichte Haiku 5.5 bei medium 53,3 % zu 0,13 $ pro Versuch. Sonnet 5.5 erreichte bei low 57,9 % zu 0,68 $.

Die vollständigen Werte finden Sie in der Haiku-5.5-Benchmarks-Aufschlüsselung. Für die Rolle des führenden Modells lesen Sie den Sonnet-5.5-Claude-Code-Leitfaden.

Eine praxistaugliche Aufteilung:

• Sonnet 5.5 oder Opus 5.5: Architektur, komplexe Refactorings, mehrstufige Coding-Aufgaben
• Haiku 5.5: Explore, Testrunner, Log-Reader, Dokumenten-Abruf und Zusammenfassungen

Beispiel: Ein Haiku-Subagent für Apidog-Tests

Testläufe sind ausführlich und wiederholbar — genau der passende Einsatz für Haiku. Die Apidog CLI kann gespeicherte Apidog-Testszenarien direkt im Terminal ausführen. Der Subagent liefert anschließend nur den kompakten Bericht an das führende Modell zurück.

---
name: api-test-runner
description: Führt die Apidog-Testszenarien des Projekts mit der Apidog CLI aus, nachdem ein API-Endpunkt geändert wurde, und meldet dann die Anzahl der bestandenen und fehlgeschlagenen Tests mit den fehlgeschlagenen Anfragen.
tools: Bash, Read
model: haiku
effort: low
---

Führen Sie den in der README dieses Repos dokumentierten Apidog CLI-Testbefehl für das Szenario aus, das den geänderten Endpunkt abdeckt. Melden Sie die Anzahl der bestandenen und fehlgeschlagenen Tests. Geben Sie für jeden Fehler den Anfragenamen, das erwartete Ergebnis und das tatsächliche Ergebnis an. Bearbeiten Sie keinen Code. Wiederholen Sie einen fehlgeschlagenen Lauf nicht mehr als einmal.

Die CLI-Einrichtung einschließlich Authentifizierung und Ausführungsbefehl finden Sie unter Apidog CLI in Claude Code. Laden Sie Apidog herunter, um die Szenarien zu erstellen, die der Subagent ausführen soll.

Migration einer App von Haiku 4.5

Wenn Ihre Anwendung Haiku 4.5 über die API aufruft, kann Claude Code die Migration starten:

/claude-api migrate this project to claude-haiku-5-5

Rechnen Sie mit grundlegenden Anpassungen:

• Manuelles Denken über budget_tokens führt zu Fehlern.
• Nicht standardmäßige temperature- oder top_p-Werte führen zu Fehlern.
• Jedes top_k führt zu einem 400-Fehler.
• Assistant-Prefill führt zu einem 400-Fehler.

Der Haiku 5.5 vs. Haiku 4.5 Leitfaden listet alle Korrekturen auf.

Speichern Sie nach der Migration die alte und die neue Anfrage als Paar in Apidog. Legen Sie ANTHROPIC_API_KEY als Umgebungsvariable ab und prüfen Sie stop_reason sowie usage. Ein neuer refusal-Stop oder ein unerwarteter Token-Sprung sollte einen Test fehlschlagen lassen, statt unbemerkt in Produktion zu gelangen.

FAQ

Ist Haiku 5.5 das Standardmodell in Claude Code?

Nein. Es ist das Standard-Haiku-Modell auf der Anthropic API. Das bedeutet nur, dass der Alias haiku dort auf Haiku 5.5 verweist. Als Hauptmodell wählen Sie es mit --model oder /model.

Kann ich Haiku 5.5 in Claude Code im kostenlosen Plan verwenden?

Nein. Claude Code benötigt einen kostenpflichtigen Plan oder einen API-Schlüssel. Kostenlose Benutzer können Haiku 5.5 in den Claude.ai-Apps auswählen. Details finden Sie unter wie man Claude Haiku 5.5 kostenlos nutzt.

Warum erhalte ich mit model: haiku Haiku 4.5?

Sie verwenden wahrscheinlich Bedrock, Google Cloud, Foundry oder Claude Platform auf AWS — oder eine Claude-Code-Version vor v2.1.293. Verwenden Sie die vollständige Modell-ID oder setzen Sie ANTHROPIC_DEFAULT_HAIKU_MODEL.

Kann ich das Denken ausschalten, um Tokens zu sparen?

Nicht in Claude Code. Senken Sie stattdessen den Aufwand. low ist die günstigste Einstellung.

Ihr nächster Schritt

1. Führen Sie claude update aus.
2. Fügen Sie die Haiku-Explore-Überschreibung hinzu.
3. Behalten Sie Ihr bisheriges Hauptmodell eine Woche lang bei.
4. Ergänzen Sie bei API-Projekten den Test-Runner-Subagenten.

Wenn Sie Haiku 5.5 aus eigenem Code aufrufen möchten, starten Sie mit dem Haiku-5.5-API-Leitfaden. Mit Apidog können Sie kostenlos beginnen und Ihrem Subagenten reale API-Tests zur Ausführung geben.